Map Feedback API Developer's Guide

Product Feedback

The user is visiting HERE.com and notices that the texture of a building has the wrong color or hue.

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

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": 950,
    "domain": {
      "subType": 11
    },
    "details": "building texture has wrong color hue"
  }
}]

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": 1418201944918,
    "coordinates": [
      8.656664011955286,
      49.86079425922911,
      0
    ],
    "guid": "354516c9e571332eaa13ae1b3fc344a825dc1d56",
    "id": -19753,
    "type": "Point",
    "createdTS": 1418201944918,
    "properties": {
      "zoomLevel": 18,
      ],
      "domain": {
        "subType": 11
        },
      "error": 950,
      "domain": 
      "languageCode": "deu",
      "v": "2.7",
      "appId": "{YOUR_APP_ID}",
      "isocc": "DEU",
      "details": "Building texture has wrong color hue.",
      "pageURL": "https://here.com/?map=8.656025,49.861,18,0,normal",
      "roadname": "Bruchwiesenstraße"
    }
  }
]

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