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.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.