Data Lens Developer's Guide

Getting Authentication Credentials

This topic details the steps required to obtain HERE authentication credentials.

Get a HERE Account

The first step is to obtain a HERE Account.

To do so, go to https://account.here.com/sign-up.

Provide the user name and password assocated with the HERE Account to identify yourself whenever you access the Data Lens service.

Get a HERE Plan

The next step is to register for an Evaluation plan on the HERE website: https://developer.here.com/plans. As a result of successful registration, you receive an email containing your application credentials:

  • app_id – authentication login associated with the HERE products to which you have access rights
  • app_code – a security code on the app_id, similar to a password

Request Data Lens Access

Once you have obtained HERE application credentials, request access to Data Lens.

To do so, use the form on the following page: https://developer.here.com/contact-us

Select "Data Lens" and include your Evaluation app_id in the text box under "How can we help you?".

On receipt of the request, we will enable Data Lens for your app_id and you can get started shortly. (Note that the acceptance process can take a few days.)

Get a Data Lens Access Token

Sign in to Data Lens with your HERE Account credentials as well as your app_id and app_code. In response, you receive an access token, which must be included in all requests to the Data Lens REST API, along with your app_id and app_code.

To get an access token, you send a Data Lens REST API request with a JSON object as a request body that includes your HERE Account credentials:

{
        "email": "{your email address}",
        "password": "{your password}"
    }

Send this as an HTTP POST request with the Data Lens REST API:

https://datalens.api.here.com/v1/sign_in?&app_id={YOUR_APP_ID}&app_code={YOUR_APP_CODE}

The response is a JSON object that that contains a value called access_token:

{
        "updatedTime": 1452698114977,
        "kind": "datalens#access_token",
        "language": "en",
        "firstname": "Frank",
        "access_token": "4KGaSS2Cmlba7xBKM..."
        ...
}

To make authenticated requests with the Data Lens REST API, you must include the access token, your app_id and your app_code in the header of each request.

Note that the access token is only valid for 60 minutes. The Data Lens REST API allows you to refresh and cancel a token, as required.

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.