HERE SDK for Android (Premium Edition)
SDK for Android Developer's Guide

Authenticating Applications

Developers using HERE SDK with their app are required to register for a set of HERE credentials and to specify these credentials (App_Id, App_Code, and licenseKey) in their app's Android manifest XML file. Failure to do so results in blocked access to certain features and degradation in the quality of other services.

To obtain these credentials visit the developer portal at and register for a license. Once your project is created, you can generate these credentials on your Project Details page. If you already have a plan, you can also retrieve these credentials from your Project Details page.

Note: Credentials are unique to your account and your application's package namespace. Avoid reusing credentials across multiple applications.
Important: When switching from an Evaluation plan to a commercial plan, new HERE credentials must be taken into use. Applications must not be commercially released (such as submitted to a store) using a license key obtained as part of an Evaluation plan. Once you have upgraded to a commercial license, you need to obtain your new license key on the Project Details page, add it to your app, and re-deploy your app. See Service Support to contact us for more details.

Adding Credentials to the Manifest

You can add your HERE credentials as <meta-data/> attributes to AndroidManifest.xml file as follows:

  1. In your development environment double-click your project's AndroidManifest.xml file and ensure that you are viewing the file in text editor mode.
  2. Within the <application></application> block of tags, add the following markup directly beneath the <activity></activity> tag:
    <meta-data android:name="" android:value="{YOUR_APP_ID}"/>
    <meta-data android:name="" android:value="{YOUR_APP_CODE}"/>
    <meta-data android:name="" android:value="{YOUR_LICENSE_KEY}"/>
  3. Replace {YOUR_APP_ID}, {YOUR_APP_CODE} and {YOUR_LICENSE_KEY} with the appropriate credentials for your application.
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android=""

  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
  <uses-permission android:name="android.permission.INTERNET"/>
  <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>

    <activity android:name=".BasicMapActivity">
        <action android:name="android.intent.action.MAIN" />

        <category android:name="android.intent.category.LAUNCHER" />

      android:value="{YOUR_APP_ID}" />
      android:value="{YOUR_APP_CODE}" />
      android:value="{YOUR_LICENSE_KEY}" />