Get Started with the HERE Map Feedback API

This section shows how to get started with providing feedback for a HERE map via the HERE Map Feedback API.

Get a HERE account

Obtain access to the HERE platform through the organization administrator's invitation, or contact us. Perform one of the following actions:

If your company has already established a HERE platform organization, contact your organization admin who can invite you to join the organization.
If your company has not established a HERE platform organization yet, contact us.

Create a project

To create a project, follow these steps:

Sign in to the HERE platform using your HERE account.
Open the Projects manager from the launcher.
Click Create new project.
Enter a name for the project. Project names don't have to be unique.
Enter a project ID. Project IDs must be unique within an organization and cannot be changed for the lifetime of the organization. Project IDs must be between 4 and 16 characters in length.
Enter an optional description.
Click Save.

Get an API key

To get an API key, follow these steps:

Select the Access and permissions tab and click Grant access.
Under New app, select Create.
Provide an app name and click Register. The platform creates a new app with a unique app ID.
On the Credentials tab, select API Keys and then click Create API key to generate a maximum of two API Keys for your application authentication credentials. The API key is created and displayed.

Report incorrect data for a place on a map

This POST request reports that a restaurant in Chicago (listed at wego.here.com) changed its phone, e-mail and website URL. Map Feedback API POST requests require the following HTTP header field.

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

The POST request URL addresses the feedback endpoint.

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

The POST request body specifies the feedback.

[{
    "type":"Point",
    "coordinates":[-87.63245,41.88425],
    "properties": {
        "v": "2.7",
        "referenceIds" : ["276397653"],
        "details": "Update of phone number, URL and e-mail",
        "phone": "+1 111 2 333",
        "email": "[email protected]",
        "URL":  "www.MyPlace.com",
        "error": 31,
        "currentValues": {
           "phone": "+1 111 2 350"
        },
        "appId": "{YOUR_APP_ID}"
    }
}]

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": {
        "referenceIds": [
            "276397653"
        ],
        "type": "Point",
        "error": 31,
        "URL": "www.MyPlace.com",
        "phone": "+1 111 2 333",
        "v": "2.7",
        "appId": "{YOUR_APP_ID}",
        "details": "Update of phone number, URL and e-mail",
        "email": "[email protected]"
    }
}]