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

地図によるフィードバック

ユーザーが wego.here.com にアクセスして、地図オブジェクトが見つからないか、地図に正しく表示されていません。

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 ボディが必要です。

[{
  "type":"Point",
  "coordinates":[8.1109931,47.8995140,0],
  "properties": {
    "v": "2.7",
    "appId": "{YOUR_APP_ID}",
    "error": 910,
    "domain":{
      "type": "2000457",
      "subType": 1,
      "name": "Adlerschanze Ski Stadion",
      "languageCode": "eng"
    },
    "details": "Adlerschanze ski jump station is missing in the map"
  }
}]

レスポンス

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

送信されたレビジョンを識別するグローバル一意 ID （ GUID ）
リビジョンのステータスを追跡するための ID
フィードバックで送信された情報
タイムスタンプおよび layerID 情報

[
  {
    "layerId": "grp|wiki|WIKI_MAP_FEEDBACK",
    "lastUpdateTS": 1424955113471,
    "coordinates": [
      13.38344,
      52.53067,
      0
    ],
    "guid": "b9c49fdabc013cdc72fef454058b0166b1ac6fc0",
    "id": -20688,
    "type": "Point",
    "createdTS": 1424955113471,
    "properties": {
      "accountId": "User Identification. e.g. HERE Account",
      "v": "2.7",
      "appId": "{YOUR_APP_ID}",
      "domain": {
        "name": "Adlerschanze Ski Stadion",
        "subType": 1,
        "type": "2000457",
        "languageCode": "eng"
      },
      "details": "Adlerschanze ski jump station is missing in the map",
      "error": 910
    }
  }
]

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

地図情報が正しくありません

[{
  "type":"Point",
  "coordinates":[13.38344,52.53067,0],
  "properties": {
  "v": "2.7",
    "appId": "{YOUR_APP_ID}",
    "error": 910,
    "domain":{
      "type": "2005050",
      "subType": 3,
      "name": "Dingbat Porcelain exhibition",
      "languageCode": "eng",
    },
  "referenceIds": ["12345678"],
    "details": "The old industrial building was replaced with a exhibition building",
    "currentValues": {
      "name": "Dingbat porcelain factory",
      "type": "2005800",
    },
    "zoomLevel": 15,
    "mapType": "hybrid.live",
    "accountId": "YOUR_HERE_ACCOUNT_ID",
  }
}]

係争中の境界

[{
  "type":"Point",
  "coordinates":[31.398594,34.392546,0],
  "properties": {
  "v": "2.7",
    "appId": "{YOUR_APP_ID}",
    "error": 910,
    "domain":{
      "type": "907197",
      "name": "Gaza Strip",
      "languageCode": "eng",
      "subType": 5,
      "referenceURLs": ["http://en.wikipedia.org/wiki/Borders_of_Israel"],
      "claimedBy": ["Gaza", "Israel"]
    },
    "details": "Border between Gaza and Israel missing",
    "referenceIds": ["12345", "67890"],
    "zoomLevel": 15,
    "mapType": "hybrid.live",
    "accountId": "{YOUR_HERE_ACCOUNT_ID}"
  }
}]

近隣の不適切な境界に関するフィードバックです

[{
  "type":"Point",
  "coordinates":[31.398594,34.392546,0],
  "properties": {
  "v": "2.7",
    "appId": "{YOUR_APP_ID}",
    "error": 910,
    "domain":{
      "type": "908002",
      "subType": 4,
      "referenceURLs": ["http://www.state.gov/"],
    },
    "details": "Boundary between two neighborhoods is not accurate",
    "referenceIds": ["12345", "67890"],  // CartoPVIDs
    "zoomLevel": 15,
    "mapType": "hybrid.live",
    "accountId": "YOUR_HERE_ACCOUNT_ID"
  }
}]

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