How to submit EV charge point feedback

This tutorial explores an example where a change, such as an addition, update to, or removal of an EV Charge Point must be reported.

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

The POST request reports a new EV Charge point with physical reference "123456789".

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

The POST request requires the following POST body.

[{
    "type":"Point",
    "coordinates":[8.1109931,47.8995140,0],
    "properties": {
	"v": "2.9",
        "appId": "{YOUR_APP_ID}",
        "error": 955,
        "domain":{
            "cpoName": "{NAME_OF_EV_COMPANY}"
            "physicalReference": "123456789"
        },
        "details": "I found a new EV Charge Point at this location.",
        "accountId": "my_here_account"
    }
}]

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

[
  {
    "coordinates": [
      8.1109931,
      47.899514,
      0
    ],
    "type": "Point",
    "id": 693760,
    "isoCountryCode": "DEU",
    "createdTS": 1729583242857,
    "lastUpdateTS": 1729583242857,
    "properties": {
      "appId": "{YOUR_APP_ID}",
      "details": "I found a new EV Charge Point at this location.",
      "accountId": "my_here_account",
      "domain": {
        "physicalReference": "123456789"
      },
      "jobStatus": "OPEN",
      "error": 955,
      "isocc": "DEU",
      "v": "2.9"
    }
  }
]