Map Feedback API Developer's Guide

Place Feedback

The user is visiting wego.here.com and notices that a restaurant in Chicago (WGS-84 latitude and longitude 41.876032263224666,-87.62075959200841) has incorrect information associated with it.

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":[-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}"
  }
}]

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