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

住所のフィードバック

ユーザーが wego.here.com にアクセスし ているときに、サンフランシスコのヘイト & アシュベリーの角にある住所 (WGS-84 経度 and 緯度 -122.4462810410399,37.77017601747043) に正しくない情報が関連付けられていることがわかりました。

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 リクエスト は、指定されたアドレスの誤った情報を報告します。

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

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

[ {
  "coordinates":[-122.4462810410399,37.77017601747043],
  "type":"Point",
  "properties": {
    "v": "2.7",
    "referenceIds" : ["948902673"],
    "roadname": "Haight Street",
    "number": "1476",
    "city": "San Francisco",
    "zipcode": "94117"
    "details": "This address is incorrect",
    "error": 21,
    "isocc": "USA",
    "zoomLevel": 20,
    "appId": "{YOUR_APP_ID}",
    "pageURL": "https://www.here.com/?x=ep&map=37.77017,-122.44667,20,normal"
  }
}]

レスポンス

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

  • 送信されたレビジョンを識別するグローバル一意 ID ( GUID )
  • リビジョンのステータスを追跡するための ID
  • フィードバックで送信された情報
  • タイムスタンプおよび layerID 情報
[
  {
    "layerId": "grp|wiki|WIKI_MAP_FEEDBACK",
    "lastUpdateTS": 1418199095141,
    "coordinates": [
      -122.4462810410399,
      37.77017601747043,
      0
    ],
    "guid": "97725e2b44d4eb761e87eede76e787b451a3b6e7",
    "id": -19746,
    "type": "Point",
    "createdTS": 1418199095141,
    "properties": {
      "zoomLevel": 20,
      "number": "1476",
      "city": "San Francisco",
      "zipcode": "94117"
      "v": "2.7",
      "referenceIds": [
        "948902673"
      ],
      "appId": "{YOUR_APP_ID}",
      "isocc": "USA",
      "details": "This address is incorrect",
      "pageURL": "https://www.here.com/?x=ep&map=37.77017,-122.44667,20,normal",
      "error": 21,
      "roadname": "Haight Street"
    }
  }
]

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

住所に利用できるものがありません

[{
  "type": "Point",
  "coordinates": [
  -76.99894738197327,
  39.137360312659595,
  0
  ],
  "properties": {
  "appId": "dIJiXIMv56AfJZCvZ3jl",
  "details": "House number does not exist anymore",
  "error": 22,
  "referenceIds": ["234564777"],
  "isocc": "USA",
  "currentValues": {
     "roadname": "Ednor Rd.",
     "languageCode": "eng",
     "number": "542"
  },
  "v": "2.7"
  }
}]

住所の郵便番号が正しくありません

[
 {"coordinates": [
   -122.4462810410399,
   37.77017601747043,
   0],
  "type": "Point",
  "properties": {
   "city": "San Francisco",
   "zipcode": "64116"
   "v": "2.7",
   "referenceIds": [
  "948902673"
   ],
   "appId": "{YOUR_APP_ID}",
   "isocc": "USA",
   "details": "ZIP code is incorrect",
   "error": 23,
   "roadname": "Haight Street"
  }
 }
]

住所 ( 市区町村 ) が見つかりません

[{
  "type": "Point",
  "coordinates": [
  -76.99894738197327,
  39.137360312659595,
  0
  ],
  "properties": {
  "appId": "dIJiXIMv56AfJZCvZ3jl",
  "details": "City is missing",
  "error": 24,
  "referenceIds": ["234564777"],
  "isocc": "USA",
  "currentValues": {
     "roadname": "Ednor Rd.",
     "languageCode": "eng",
     "city": " "
     "number": "542"
  },
  "v": "2.7"
  }
}]

住所の市区町村が正しくありません

[
 {"coordinates": [
   -122.4462810410399,
   37.77017601747043,
   0 ],
  "type": "Point",
  "properties": {
   "number": "1476",
   "city": "Sacramento",
   "zipcode": "94117"
   "v": "2.7",
   "referenceIds": [
  "948902673"
   ],
   "appId": "{YOUR_APP_ID}",
   "isocc": "USA",
   "details": "Address City is incorrect",
   "error": 25
  }
 }
]

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