Map Feedback API Developer's Guide

Cartographic Feedback

The user is visiting wego.here.com and notices that cartographic objects are either missing or displayed incorrectly on the map.

HTTP Header Fields

Map Feedback API POST requests require the following HTTP header fields:

Group-Id: FGx1AWaAzKOo0imNkLmf
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

Request

The POST request specifies a cartographic feedback about a missing sports complex.

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

The POST request requires the following POST body.

[{
  "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"
  }
}]

Response

The response to the request contains:

  • a globally unique ID (GUID) that identifies the submitted revision
  • id for tracking the status of the revision
  • the information submitted in the feedback
  • timestamp and layerID information
[
  {
    "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
    }
  }
]

The following additional request bodies contain cartographic feedback for errors occurring on the map. The HTTP Headers field values and the request are the same as used in the previous example so these are not shown with each of the following feedback examples. The response information to these requests is similarly structured to the information shown in the previous example, but with the information details from the respective request bodies.

Incorrect Cartographic Information

[{
  "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",
  }
}]

Disputed Boundary

[{
  "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}"
  }
}]

Feedback about Incorrect Boundary for a Neighborhood

[{
  "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"
  }
}]

For more details about tracking the feedback status, see Tracking Feedback Status.