地図フィードバック API 開発者ガイド

道路標識のフィードバック

アプリケーションまたは車両の統合によって、制限速度の変更が検出されるか、またはエンド ユーザーが、道路脇に掲示された標識を含む、更新された制限速度の状況を報告できるようになります。

HTTP ヘッダーフィールド

地図フィードバック API の POST リクエストには、次の HTTP ヘッダーフィールドが必要です。

オプション 1 : apiKey 認証

Auth-Service-Id: here_app
Auth-Identifier: apikey
Auth-Secret: {YOUR_APIKEY}
Content-Type: application/vnd.here.layerObjectList+json; charset=UTF-8
Content-Disposition: application/vnd.here.layerObjectList+json; charset=UTF-8
Accept: application/vnd.here.layerObjectList+json
Accept-Charset: charset=UTF-8

オプション 2 : APP_ID/APP_CODE 認証 (廃止)

Auth-Service-Id: here_app
Auth-Identifier: {YOUR_APP_ID}
Auth-Secret: {YOUR_APP_CODE}
Content-Type: application/vnd.here.layerObjectList+json; charset=UTF-8
Content-Disposition: application/vnd.here.layerObjectList+json; charset=UTF-8
Accept: application/vnd.here.layerObjectList+json
Accept-Charset: charset=UTF-8

リクエスト

POST リクエスト は、 2 つのリンクにまたがる 50 km/時 の制限速度を報告します。

https://maphub.api.here.com/feedback/

POST リクエスト には、次の POST ボディ が必要です。

[{
  "type":"Point",
  "coordinates":[8.1109931,47.8995140,0],
  "properties": {
  "v": "2.7",
    "appId": "{YOUR_APP_ID}",
    "error": 920,
    "domain":{
      "signValue": "50",
      "signUnit": "km/h",
      "subType": 1
    },
    "details": "A new speedlimit",
    "referenceIds": ["12345", "67890"],
    "zoomLevel": 15,
    "mapType": "hybrid.live",
    "accountId": "my_here_account"
  }
}]

レスポンス

リクエストに対する応答には、次の内容が含まれます。

  • 送信されたレビジョンを識別するグローバル一意 ID ( GUID )
  • リビジョンのステータスを追跡するための ID
  • フィードバックで送信された情報
  • タイムスタンプおよび layerID 情報
[
  {
    "layerId": "grp|wiki|WIKI_MAP_FEEDBACK",
    "lastUpdateTS": 1424962022788,
    "coordinates": [
      8.55,
      50.148,
      0
    ],
    "guid": "26e78037d331f9230ff058bb28babefb32b13f31",
    "id": -20691,
    "type": "Point",
    "createdTS": 1424962022788,
    "properties": {
      "zoomLevel": 15,
      "accountId": "my_here_account",
      "v": "2.7",
      "referenceIds": [
        "12345678"
      ],
      "appId": "{YOUR_APP_ID}",
      "domain": {
        "subType": 3,
        "signValue": "100",
        "signUnit": "km/h"
      },
      "mapType": "hybrid.live",
      "details": "The speed limit is now 100 km/h",
      "error": 920,
      "currentValues": {
        "signValue": "80"
      }
    }
  }
]

次の追加リクエストボディには、地図で発生したエラーについての道路標識フィードバックが含まれています。 [HTTP Headers] フィールドの値と要求は、前の例で使用したものと同じであるため、これらの値は次の各フィードバック例には表示されません。 これらのリクエストに対する応答情報は、前の例で示した情報と同様に構造化されていますが、それぞれのリクエスト本文の情報の詳細が表示されます。

誤った制限速度情報を更新してください

[{
  "type":"Point",
  "coordinates":[8.55,50.148,0],
  "properties": {
  "v": "2.7",
    "appId": "{YOUR_APP_ID}",
    "error": 920,
    "domain":{
      "signValue": "100",
      "signUnit": "km/h",
      "subType": 3
    },
    "details": "The speed limit is now 100 km/h",
    "currentValues": {
      "signValue": "80"
  },
    "zoomLevel": 15,
    "mapType": "hybrid.live",
    "accountId": "my_here_account"
  }
}]

トラック重量制限の署名を追加します

[{
  "type":"Point",
  "coordinates":[8.1109931,47.8995140,0],
  "properties": {
     "v": "2.7",
    "appId": "<yourAppId>",
    "error": 920,
    "domain":{
      "signValue": "20",
      "signUnit": "T",
      "subType": 10
    },
    "details": "Add weight restriction sign that is missing",    
    "referenceIds": ["12345"],
    "accountId": "my_here_account" 
  }
}]

車軸あたりのトラック重量制限の標識を追加します

[{
  "type":"Point",
  "coordinates":[8.1109931,47.8995140,0],
  "properties": {
     "v": "2.7",
    "appId": "<yourAppId>",
    "error": 920,
    "domain":{
      "signValue": "8",
      "signUnit": "T",
      "subType": 15
    },
    "details": "Add weight per axle restriction sign that is missing",    
    "referenceIds": ["12345"],
    "accountId": "my_here_account" 
  }
}]

ハズマットトラック制限の署名を追加します

[{
  "type":"Point",
  "coordinates":[8.1109931,47.8995140,0],
  "properties": {
        "v": "2.7",
    "appId": "<yourAppId>",
    "error": 920,
    "domain":{
      "signValue": "Hazardous goods",
      "subType": 20
    },
    "details": "Sign to prohibit Hazmat trucks is missing",    
    "referenceIds": ["12345"],
  }
}]

トラック高さ制限の署名を追加します


[{
  "type":"Point",
  "coordinates":[8.1109931,47.8995140,0],
  "properties": {
     "v": "2.7",
    "appId": "<yourAppId>",
    "error": 920,
    "domain":{
      "signValue": "12'-6"",
      "signUnit": "m",
      "subType": 30
    },
    "details": "Add truck height restriction sign that is missing",    
    "referenceIds": ["12345"],
    "accountId": "my_here_account" 
  }
}]

トラック幅制限の署名を追加します


[{
  "type":"Point",
  "coordinates":[8.1109931,47.8995140,0],
  "properties": {
     "v": "2.7",
    "appId": "<yourAppId>",
    "error": 920,
    "domain":{
      "signValue": "5,5",
      "signUnit": "T",
      "subType": 40
    },
    "details": "Add truck width restriction sign that is missing",    
    "referenceIds": ["12345"],
    "accountId": "my_here_account" 
  }
}]

トラック長さ制限の署名を追加します


[{
  "type":"Point",
  "coordinates":[8.1109931,47.8995140,0],
  "properties": {
     "v": "2.7",
    "appId": "<yourAppId>",
    "error": 920,
    "domain":{
      "signValue": "10",
      "signUnit": "m",
      "subType": 50
    },
    "details": "Add truck length restriction sign that is missing",    
    "referenceIds": ["12345"],
    "accountId": "my_here_account" 
  }
}]

トンネルの署名を追加します


[{
  "type":"Point",
  "coordinates":[8.1109931,47.8995140,0],
  "properties": {
     "v": "2.7",
    "appId": "<yourAppId>",
    "error": 920,
    "domain":{
      "signValue": "C",
      "signUnit": "TRC",
      "subType": 70
    },
    "details": "Add tunnel restriction code that is missing",    
    "referenceIds": ["12345"],
    "accountId": "my_here_account" 
  }
}] 

フィードバックステータスの追跡についての詳細 は、「フィードバックステータスの追跡」を参照してください。