Map Feedback API Developer's Guide

Submit Feedback

This POST request reports that a restaurant in Chicago (listed at wego.here.com) changed its phone, e-mail and website URL.

Important: For test requests, only use the CIT environment.

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

The POST request URL addresses the feedback endpoint.

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

The POST request body specifies the feedback.

[{
  "type":"Point",
  "coordinates":[-87.63245,41.88425],
  "properties": {
    "v": "2.7",
    "referenceIds" : ["276397653"],
    "details": "Update of phone number, URL and e-mail",
    "phone": "+1 111 2 333",
    "email": "MyPlace@MyPlace.com",
    "URL":  "www.MyPlace.com",
    "error": 31,
    "currentValues": {
       "phone": "+1 111 2 350"
    },
    "appId": "{YOUR_APP_ID}"
  }
}]

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": 1418201039323,
    "coordinates": [
      -87.63245,
      41.88425,
      0
    ],
    "guid": "039b3a2bcf036607b43b569dd34a584a993543cb",
    "id": -19752,
    "type": "Point",
    "createdTS": 1418201039323,
    "properties": {
      "referenceIds": [
        "276397653"
      ],
      "type": "Point",
      "error": 31,
      "URL": "www.MyPlace.com",
      "phone": "+1 111 2 333",
      "v": "2.7",
      "appId": "{YOUR_APP_ID}",
      "details": "Update of phone number, URL and e-mail",
      "email": "MyPlace@MyPlace.com"
    }
  }
]