Guides
Guides

How to submit product feedback

In this tutorial, 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: Option 1: APIKEY authentication

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

Option 2: APP_ID / APP_CODE authentication (deprecated)

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.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"
		}
	}
]