Place Feedback

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":[-87.63245,41.88425],
  "properties": {
  "v": "2.7",
    "referenceIds" : ["776397653"],
    "name": "MyPlace",
    "type": "5800",
    "details": "Place MyPlace has inaccurate information. It is a restaurant",
    "roadname": "East Congress Parkway",
    "number": "114",
    "zipcode": "60605",
    "city": "Chicago",
    "error": 31,
    "isocc": "USA",
    "languageCode": "eng",
    "zoomLevel": 20,
    "appId": "{YOUR_APP_ID}",
    "phone": "+1 111 2 333",
    "email": "MyPlace@MyPlace.com",
    "URL":  "www.MyPlace.com",
    "pageURL": "https://here.com/?map=-87.62075959200841,41.876032263224666,20,0,normal"
  }
}]

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": 1418201039323,
    "coordinates": [
      -87.63245,
      41.88425,
      0
    ],
    "guid": "039b3a2bcf036607b43b569dd34a584a993543cb",
    "id": -19752,
    "type": "Point",
    "createdTS": 1418201039323,
    "properties": {
      "zoomLevel": 20,
      "city": "Chicago",
      "referenceIds": [
        "776397653"
      ],
      "type": "5800",
      "error": 31,
      "languageCode": "eng",
      "URL": "www.MyPlace.com",
      "zipcode": "60605",
      "number": "114",
      "phone": "+1 111 2 333",
      "v": "2.7",
      "appId": "{YOUR_APP_ID}",
      "name": "MyPlace",
      "isocc": "USA",
      "details": "Place MyPlace has inaccurate information. It is a restaurant",
      "pageURL": "https://here.com/?map=41.876032263224666,-87.62075959200841,20,0,normal",
      "email": "MyPlace@MyPlace.com",
      "roadname": "East Congress Parkway"
    }
  }
]

Additional request bodies follow, which are examples of Place 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.

Place Closed

The feedback is as follows:

[{
  "type": "Point",
  "coordinates": [
  -76.99894738197327,
  39.137360312659595,
  0
  ],
  "properties": {
  "appId": "dIJiXIMv56AfJZCvZ3jl",
  "details": "Restaurant is closed since May 2015",
  "error": 32,
  "referenceIds": ["234564777"],
  "isocc": "USA",
  "currentValues": {
     "name": "MyRestaurant",
     "languageCode": "eng"
  },
  "v": "2.5"
  }
}]

Place at Incorrect Location

The feedback is as follows:

[{
  "type":"Point",
  "coordinates":[-88.63245,42.88425],
  "properties": {
    "v": "2.7",
    "referenceIds" : ["776397653"],
    "details": "MyPlace is located incorrectly on the map.",
    "error": 33,
    "currentValues": {
       "name": "MyPlace",
       "coordinates":[-87.63245,41.88425]
    },
    "appId": "{YOUR_APP_ID}"
  }
}]

Place Moved

The feedback is as follows:

[{
  "type":"Point",
  "coordinates":[-88.63245,42.88425],
  "properties": {
    "v": "2.7",
    "referenceIds" : ["976397653"],
    "name": "MyPlace",
    "type": "5800",
    "details": "MyPlace has moved to a different location two blocks away from old location",
    "roadname": "East Congress Parkway",
    "number": "114",
    "zipcode": "60605",
    "phone": "+1 111 2 333",
    "error": 31,
    "languageCode": "eng",
    "currentValues": {
      "name": "MyPlace",
      "coordinates":[-87.63245,41.88425]
      "roadname": "Old Street name",
      "number": "44",
      "zipcode": "60610",
    },
    "appId": "{YOUR_APP_ID}"
  }
}]

Related Information

• Constructing a Request
• HTTP Request Headers
• Feedback
• Feedback Submission Request Body
• Feedback Request Properties
• Place-Specific Properties
• Feedback Status Response