Map Feedback API Developer's Guide

Other Feedback

This section provides examples for submitting Other feedback.

User story

An important area for people is flagged.

The request summary below provides the required data for all the required components (HTTP Header, Resource, and POST Body) of the request to submit feedback.

Request Summary

Request Component	Value
HTTP Header field	`Auth-Service-Id` : `here_app` Application ID for your application
HTTP Header field	`Auth-Identifier` : `apikey`
HTTP Header field	`Auth-Secret` : `{YOUR_APIKEY}`
HTTP Header field	`Content-Type` : `application/vnd.here.layerObjectList+json; charset=UTF-8`
HTTP Header field	`Accept` : `application/vnd.here.layerObjectList+json`
HTTP Header field	`Accept-Charset` : `charset=UTF-8`
Resource	Feedback : Note that there are no request parameters
Post Body	`type` : Point
Post Body	`coordinates` : 8.1109931,47.8995140,0 WGS-84 compliant longitude and latitude for the location of the sign.
Post Body	`v` : 3.0 Version of the Map Feedback API used to report the feedback.
Post Body	`subType` : 1 Specific information about the nature of the request.
Post Body	`error` : 970 Error code indicating an Other map feedback request.
Post Body	`appId` : {YOUR_APP_ID} Application ID for your application

Request

The HTTP Headers field values are as follows:

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

The request is as follows:


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

The request body is as follows:


[{
  "type": "Point",
  "coordinates": [8.1109931,47.8995140,0],
  "properties": {
    "v": "2.7",
    "appId": "{YOUR_APP_ID}",
    "error": 970,
    "domain": {
      "subType": 2
    },
    "details": "this area is really important for people"
  }
}]

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

The response for this example is as follows:


[
  {
    "layerId": "grp|wiki|WIKI_MAP_FEEDBACK",
    "lastUpdateTS": 1418201944918,
    "coordinates": [
      8.1109931,
      47.8995140,
      0
    ],
    "guid": "354516c9e571332eaa13ae1b3fc344a825dc1d56",
    "id": -19753,
    "type": "Point",
    "createdTS": 1418201944918,
    "properties": {
      "zoomLevel": 18,
      ],
      "domain": {
        "subType": 1
        },
      "error": 970,
      "languageCode": "deu",
      "v": "2.7",
      "appId": "{YOUR_APP_ID}",
      "isocc": "DEU",
      "details": "This area is really important for people",
      "pageURL": "https://here.com/?map=8.1109931,47.8995140,0,normal",
    }
  }
]

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