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.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.