Get Your Credentials

All users of the HERE platform must obtain authentication and authorization credentials.

For the available authentication options, see the Identity & Access Management Developer Guide.

To obtain your platform credentials, create a new application via the page. When you have created your application, click Create A Key to download these credentials.

If you are using option one above, place the credentials in $HOME/.here/

Note: Downloading the Data Library

To download the Data Library, you need repository credentials. To obtain your credentials, go to and click Generate Credentials, to download the settings.xml file.

Credential Options

The snippets below demonstrate different ways of supplying your platform credentials to the Data Library.

When you initialize a new service client without supplying any credentials as arguments, the Data Library attempts to find your platform credentials using the default credential provider chain: a platform credentials file in the JVM classpath, the default location platform credentials download location (~/.here/ and the Java system properties in that order.

Note: Billing Tags

The snippets below also demonstrate the use of the HERE platform billing tags, which you can use in requests to the platform in order to later associate your requests with the invoicing for those requests.

Set Your Credentials via the Application's Configuration File

Based on the values in the platform credentials, include the following parameters in your application.conf file: {
  billing-tag = "example_billing_tag"
  credentials {
    here-account {
      here-token-endpoint-url = ""
      here-client-id = "example-client-id"
      here-access-key-id = "example-access-key-id"
      here-access-key-secret = "example-access-key-secret"
} {
  billing-tag = "example_billing_tag"
  credentials {
    here-token = "example-token"

Set Your Credentials in the Credentials File

The Data Library can read HERE access key and access secret data from the file.

  • The client looks for a file in the Java Virtual Machine (JVM) classpath.
  • A fallback location to find platform credentials is in ~/.here/
  • Alternatively, you can specify an alternate credentials file location in the application.conf file. {
    billing-tag = "example_billing_tag"
    credentials {
     file-path = "/path/"

Example of credentials properties file: = example-here-user-id

Note: Using Previously Generated Tokens

Previously generated HERE tokens are not supported for the platform credentials file format.

Set Your Credentials via Java System Properties

To set your credentials via Java System Properties, define the following:"""example-client-id""example-access-key-id""example-access-key-secret""example-token"

results matching ""

    No results matching ""