Get started

This section outlines how to quickly get started using the HERE Network Positioning API on the HERE platform.

1. Get a HERE account
2. Create a project
3. Get an API key
4. Send a request
5. Next steps

Get a HERE account

You can get started with a free HERE platform account from the flexible HERE Base Plan. For more information, see the HERE Base Plan Pricing. Alternatively, if your company has already established a HERE platform organization, contact your organization admin who can invite you to join your company's organization.

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.
8. On the Resources tab, select Services and then click Link a Service.
9. Search for the HERE Network Positioning service and click Link.
10. Click Done.

Get an API key

To get an API key, follow these steps:

1. Sign in to the HERE platform using your HERE account.
2. Select the Access Manager from the launcher.
3. Select the Apps tab and click Register new app.
4. Enter a name for the app.
5. Optional: Enter a description for the app.
6. Optional: Select the project you created in the previous procedure from the Default access to a project field.
7. Click Register. The HERE platform creates a new app with a unique app ID.
8. 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.

Send a request

This section provides the minimum information required to make your first HERE Network Positioning API request.

To request WGS-84 compliant geocoordinates representing a location, send the following request using the HTTP POST method.

Make sure to include request content type in the HTTP headers.

POST /v2/locate?apiKey={YOUR_API_KEY} HTTP/1.1
Host: positioning.hereapi.com
Content-Type: application/json

POST /v2/locate?apiKey={YOUR_API_KEY} HTTP/1.1
Host: az.positioning.hereapi.com
Content-Type: application/json

Use the following POST body:

{
  "gsm": [
    {
      "mcc": 262,
      "mnc": 1,
      "lac": 5126,
      "cid": 21857
    }
  ]
}

The response looks as follows:

{
  "location": {
    "lat": 52.5187469,
    "lng": 13.37551117,
    "accuracy": 338
  }
}

Next steps

We encourage you to view the API Reference and Tips for Optimizing Data Accuracy. Also view the use cases, which show you various network positioning scenarios.