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:

1. Sign in to the HERE platform using your HERE account.
2. Open the Projects manager from the launcher.
3. Click Create new project.
4. Enter a name for the project. Project names don't have to be unique.
5. 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.
6. Enter an optional description.
7. Click Save.

Get an API key

To get an API key, follow these steps:

1. On the Resources tab, select Services and then click Link a Service.
2. Search for services and click Link to link them to your project as needed.
3. Click Done.
4. Select the Access and permissions tab and click Grant access.
5. Under New app, select Create.
6. Provide an app name and click Register. The platform creates a new app with a unique app ID.
7. 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]"
		}
	}
]