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

フィードバックを送信します

ユーザーが wego.here.com にアクセスし ているときに、シカゴのレストラン (WGS-84 緯度 and 経度 41.87603226322466, -87.62075959200841) に誤った情報が関連付けられていることがわかりました。

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

リクエスト

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

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

[{
  "type":"Point",
  "coordinates":[-87.63245,41.88425],
  "properties": {
  "v": "2.7",
    "referenceIds" : ["776397653"],
    "name": "MyPlace",
    "type": "5800",
    "details": "Place MyPlace has inaccurate information. It is a restaurant",
    "roadname": "East Congress Parkway",
    "number": "114",
    "zipcode": "60605",
    "city": "Chicago",
    "error": 31,
    "isocc": "USA",
    "languageCode": "eng",
    "zoomLevel": 20,
    "appId": "{YOUR_APP_ID}",
    "phone": "+1 111 2 333",
    "email": "MyPlace@MyPlace.com",
    "URL":  "www.MyPlace.com",
    "pageURL": "https://here.com/?map=-87.62075959200841,41.876032263224666,20,0,normal"
  }
}]

レスポンス

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

  • 送信されたレビジョンを識別するグローバル一意 ID ( GUID )
  • リビジョンのステータスを追跡するための ID
  • フィードバックで送信された情報
  • タイムスタンプおよび layerID 情報
[
  {
    "layerId": "grp|wiki|WIKI_MAP_FEEDBACK",
    "lastUpdateTS": 1418201039323,
    "coordinates": [
      -87.63245,
      41.88425,
      0
    ],
    "guid": "039b3a2bcf036607b43b569dd34a584a993543cb",
    "id": -19752,
    "type": "Point",
    "createdTS": 1418201039323,
    "properties": {
      "zoomLevel": 20,
      "city": "Chicago",
      "referenceIds": [
        "776397653"
      ],
      "type": "5800",
      "error": 31,
      "languageCode": "eng",
      "URL": "www.MyPlace.com",
      "zipcode": "60605",
      "number": "114",
      "phone": "+1 111 2 333",
      "v": "2.7",
      "appId": "{YOUR_APP_ID}",
      "name": "MyPlace",
      "isocc": "USA",
      "details": "Place MyPlace has inaccurate information. It is a restaurant",
      "pageURL": "https://here.com/?map=41.876032263224666,-87.62075959200841,20,0,normal",
      "email": "MyPlace@MyPlace.com",
      "roadname": "East Congress Parkway"
    }
  }
]

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

場所を閉鎖しました

フィードバックは次のとおりです。

[{
  "type": "Point",
  "coordinates": [
  -76.99894738197327,
  39.137360312659595,
  0
  ],
  "properties": {
  "appId": "dIJiXIMv56AfJZCvZ3jl",
  "details": "Restaurant is closed since May 2015",
  "error": 32,
  "referenceIds": ["234564777"],
  "isocc": "USA",
  "currentValues": {
     "name": "MyRestaurant",
     "languageCode": "eng"
  },
  "v": "2.5"
  }
}]

誤った場所に設置してください

フィードバックは次のとおりです。

[{
  "type":"Point",
  "coordinates":[-88.63245,42.88425],
  "properties": {
    "v": "2.7",
    "referenceIds" : ["776397653"],
    "details": "MyPlace is located incorrectly on the map.",
    "error": 33,
    "currentValues": {
       "name": "MyPlace",
       "coordinates":[-87.63245,41.88425]
    },
    "appId": "{YOUR_APP_ID}"
  }
}]

場所が移動しました

フィードバックは次のとおりです。

[{
  "type":"Point",
  "coordinates":[-88.63245,42.88425],
  "properties": {
    "v": "2.7",
    "referenceIds" : ["976397653"],
    "name": "MyPlace",
    "type": "5800",
    "details": "MyPlace has moved to a different location two blocks away from old location",
    "roadname": "East Congress Parkway",
    "number": "114",
    "zipcode": "60605",
    "phone": "+1 111 2 333",
    "error": 31,
    "languageCode": "eng",
    "currentValues": {
      "name": "MyPlace",
      "coordinates":[-87.63245,41.88425]
      "roadname": "Old Street name",
      "number": "44",
      "zipcode": "60610",
    },
    "appId": "{YOUR_APP_ID}"
  }
}]

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