Map Feedback API Developer's Guide

Address Feedback

The user is visiting wego.here.com and notices that an address at the corner of Haight and Ashbury in San Francisco (WGS-84 longitude and latitude -122.4462810410399,37.77017601747043) 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

The POST request reports the incorrect information at the specified address.

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

The POST request requires the following POST body.

[ {
  "coordinates":[-122.4462810410399,37.77017601747043],
  "type":"Point",
  "properties": {
    "v": "2.7",
    "referenceIds" : ["948902673"],
    "roadname": "Haight Street",
    "number": "1476",
    "city": "San Francisco",
    "zipcode": "94117"
    "details": "This address is incorrect",
    "error": 21,
    "isocc": "USA",
    "zoomLevel": 20,
    "appId": "{YOUR_APP_ID}",
    "pageURL": "https://www.here.com/?x=ep&map=37.77017,-122.44667,20,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": 1418199095141,
    "coordinates": [
      -122.4462810410399,
      37.77017601747043,
      0
    ],
    "guid": "97725e2b44d4eb761e87eede76e787b451a3b6e7",
    "id": -19746,
    "type": "Point",
    "createdTS": 1418199095141,
    "properties": {
      "zoomLevel": 20,
      "number": "1476",
      "city": "San Francisco",
      "zipcode": "94117"
      "v": "2.7",
      "referenceIds": [
        "948902673"
      ],
      "appId": "{YOUR_APP_ID}",
      "isocc": "USA",
      "details": "This address is incorrect",
      "pageURL": "https://www.here.com/?x=ep&map=37.77017,-122.44667,20,normal",
      "error": 21,
      "roadname": "Haight Street"
    }
  }
]

The following additional request bodies contain address-related 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.

Nothing Available at Address

[{
  "type": "Point",
  "coordinates": [
  -76.99894738197327,
  39.137360312659595,
  0
  ],
  "properties": {
  "appId": "dIJiXIMv56AfJZCvZ3jl",
  "details": "House number does not exist anymore",
  "error": 22,
  "referenceIds": ["234564777"],
  "isocc": "USA",
  "currentValues": {
     "roadname": "Ednor Rd.",
     "languageCode": "eng",
     "number": "542"
  },
  "v": "2.7"
  }
}]

Incorrect Address ZIP Code

[
 {"coordinates": [
   -122.4462810410399,
   37.77017601747043,
   0],
  "type": "Point",
  "properties": {
   "city": "San Francisco",
   "zipcode": "64116"
   "v": "2.7",
   "referenceIds": [
  "948902673"
   ],
   "appId": "{YOUR_APP_ID}",
   "isocc": "USA",
   "details": "ZIP code is incorrect",
   "error": 23,
   "roadname": "Haight Street"
  }
 }
]

Missing Address City

[{
  "type": "Point",
  "coordinates": [
  -76.99894738197327,
  39.137360312659595,
  0
  ],
  "properties": {
  "appId": "dIJiXIMv56AfJZCvZ3jl",
  "details": "City is missing",
  "error": 24,
  "referenceIds": ["234564777"],
  "isocc": "USA",
  "currentValues": {
     "roadname": "Ednor Rd.",
     "languageCode": "eng",
     "city": " "
     "number": "542"
  },
  "v": "2.7"
  }
}]

Incorrect Address City

[
 {"coordinates": [
   -122.4462810410399,
   37.77017601747043,
   0 ],
  "type": "Point",
  "properties": {
   "number": "1476",
   "city": "Sacramento",
   "zipcode": "94117"
   "v": "2.7",
   "referenceIds": [
  "948902673"
   ],
   "appId": "{YOUR_APP_ID}",
   "isocc": "USA",
   "details": "Address City is incorrect",
   "error": 25
  }
 }
]

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