heremaps / here-android-sdk-examples

Java-based projects using the HERE SDK for Android.
Apache License 2.0
145 stars 191 forks source link
android-premium-sdk android-sdk mapping maps mobile-app mobile-development

Build Status

HERE Mobile SDK 3.x for Android example projects

Deprecated

Copyright (c) 2011-2021 HERE Europe B.V.

This repository holds a series of Java-based projects using the HERE Mobile SDK 3.x for Android. More information about the API can be found on the HERE Developer Portal's Mobile SDKs page.

Note: This service is no longer being actively developed. We will only provide critical fixes for this service in future. Instead, use the new HERE SDK 4.x HERE Premium SDK (3.x) is superseded by new 4.x SDK variants and the Premium SDK will be maintained until 31 December 2022 with only critical bug fixes and no feature development / enhancements. Current users of the HERE Premium SDK (3.x) are encouraged to migrate to Lite, Explore or Navigate HERE SDK (4.x) variants based on licensed use cases before 31 December 2022. Most of the Premium SDK features are already available in the new SDK variants. Onboarding of new customers for Premium SDK is not possible.

This set of individual, use-case based projects is designed to be cloned by developers for their own use.

Note: In order to be able to build the examples, you have to sign up for a 90-day Free Trial. After signing in with a HERE account, follow these steps to download the HERE Mobile SDK (Premium):

  1. Choose to Generate App ID and App Code for use with the HERE Mobile SDK for Android: Generate App ID and App Code

  2. Enter the package name of the example you want to build, e.g. com.here.android.example.map.basic. The package name entered here must match the name in your app: Enter package name

  3. Click on GENERATE to obtain the App ID, App Code, and License Key: Enter package name

  4. Click on Download SDK to get a files named like HERE_Android_SDK_Premium_v3.16.2_101.zip (your version number might differ).

  5. Extract HERE_Android_SDK_Premium_v3.16.2_101.zip as well as the contained HERE-sdk.zip.

  6. Copy the contained HERE-sdk/libs/HERE-sdk.aar file to your example's libs directory. Again taking the map-rendering example, the libs directory would be here.

  7. Replace the instances of the {YOUR_APP_ID}, {YOUR_APP_CODE} and {YOUR_LICENSE_KEY} placeholders in the example's AndroidManifest.xml with your obtained values. Yet again looking at the map-rendering examples, this would be here, here and here.

  8. Replace the instances of the {YOUR_LABEL_NAME} placeholders in the example's AndroidManifest.xml with your own custom values. Do not reuse HERE Mobile SDK defaults.

  9. Launch Android Studio and import the example's build.gradle file.

  10. Run the app.

License

Unless otherwise noted in LICENSE files for specific files or directories, the LICENSE in the root applies to all content in this repository.

HERE Mobile SDK for Android (Premium)

All of the following projects use latest version(currently 3.16) of the HERE Mobile SDK for Android (Premium)