Welcome to the Developer's Guide for the HERE SDK for Android, version 184.108.40.206 (Lite Edition). Here you can find all necessary information to start building immersive location-aware apps today!
Why Use the HERE SDK for Android?
The new HERE SDK for Android enables you to build powerful map applications. Bundled along with it are many HERE assets, available on Android for customers to integrate with their own apps. It consumes data from the HERE platform incorporating microservices and highly modularized components. The HERE SDK for Android belongs to the HERE SDK product family, which also includes the HERE SDK for iOS.
- Backed by more than 30 years of expertise in mapping technology, the new lightweight HERE SDK for Android provides you with instant access to the freshest map data of the highest quality, consistency and accuracy.
- Build captivating native applications and benefit from one of the world’s most accurate and interactive map data that is captured via a comprehensive and precise industrial process with the HERE True vehicles.
- Explore maps that are fast and smooth to interact with, pan/zoom across map views of varying resolutions, and enable the display of various elements such as routes and POIs on highly customizable map views.
Which Edition is best for me?
We have made the HERE SDK available in two different editions, the Lite Edition and the Explore Edition. While each edition provides a tailored map experience, the main difference between both editions is the integration of a different map renderer.
- Lite Renderer (available only for the Lite Edition): This light-weighted map renderer is less resource-hungry and provides support for a vast amount of mobile devices while still being able to show beautifully looking and highly customizable maps. Choose the Lite Edition when you want to run your app on as much devices as possible and a smooth performance is important for you even on older low-end devices.
- Premium Renderer (available only for the Explore Edition): The Premium Renderer offers visually appealing true 3D maps that provide a smooth map experience and highly performant map rendering tailored for high-end devices. Benefit from premium features such as multiple map view instances, full 3D camera control to fly through a map scene and seemless map scheme switches. Choose the Explore Edition when you want to benefit from the best looking maps and support for older devices is less critical for you.
At the time of writing, version 220.127.116.11 is the current release of the HERE SDK for Android, which includes:
- Latest map data from the HERE platform for more than 190 countries with weekly map updates.
- Resource-friendly vector tile map rendering.
- 2D / 2.5D rendering including building footprints, extruded buildings, carto POIs and more.
- Highly customizable map styles featuring a powerful WYSIWYG customization tool, including predefined styles such as normal street map and satellite map.
- Support for custom raster layers from external sources.
- Support for all common map interactions and gestures (including pan, flick, and pinch zoom).
- Pickable overlay objects on the map such as polylines, polygons, circles, images, and routes.
- Attachable native Android views as map overlays.
- Highly customizable map marker support (including anchor points and multiple images).
- Metadata support for most map items (for example, to identify search results on the map).
- Search through a broad set of geographical content across the globe (including streets, address points, categories, and places).
- Access localized details for a Point of Interest (POI).
- Enhance the search experience with auto suggestions.
- Perform geocoding and reverse geocoding lookups.
- All address details are already localized and can be accessed in various languages.
- Get real-time traffic information for nearby and remote traffic incidents.
- Embedded support for instant visualization of traffic flows on the map.
- Embedded support for instant visualization of traffic incidents on the map.
- All traffic information is already localized and can be accessed in various languages.
- Online car route directions.
- Online pedestrian route directions.
- Online truck route directions with highly customizable truck options.
- Online bicycle route directions (BETA stage).
- Specify preferred route type (fastest or shortest) and route options (such as speed profiles, route restrictions, vignette options, and more).
- Calculate traffic-aware routes indicating potential traffic delay times, as well as traffic-optimized routes to avoid traffic.
- Customizable route shapes utilizing different types of waypoints.
- Localized maneuver instructions are available for each route.
- Alternate routes.
- The minimum API level supported by the HERE SDK for Android is API 21, Android 5.0 (Lollipop), which allows you to reach more than approximately 90% of all Android devices on the market.
- Java and Kotlin are both supported. The HERE SDK provides Java interfaces, thus the examples are given in Java, but can be converted to Kotlin seamlessly if you prefer.
- The HERE SDK supports AndroidX, but it is not a requirement. You can still use the support library.
- The accompanying example apps have been developed using Android Studio 3.5.
- The HERE SDK for Android supports Android 32-bit devices with x86 or ARMv7 architecture and 64-bit devices with x86_64 or ARM64/v8 architecture.
- Additional hardware requirements:
- Support for OpenGL ES 2.0 or higher.
- At least 512 MB memory (RAM).
- At least 10 MB free disk space (ROM).
Where to Start?
If you are interested in building your first app showing a HERE map, have a look at our Get Started section to guide you through the first simple steps.
Register or sign in at developer.here.com to get your credentials and to download the Android library (the HERE SDK binary to include in your app(s)).
A quick overview of the main concepts and conventions can be found here.
- In the examples section, you can find the links to our example applications that accompany this user guide.
- The API Reference can be found in your downloaded SDK package or on developer.here.com.
The use of the HERE SDK for Android is governed by the terms and conditions which you have accepted separately, either when signing up via the developer.here.com portal or otherwise executing an agreement with HERE. For your use of the documentation presented on this website, these terms apply.
In addition to the above terms, the following shall apply: Components of the HERE SDK for Android collect certain information from your application. Such information includes access credentials (
Open Source Software Notices
If you use the HERE SDK for Android in your application, you must embed the HERE copyright and various open source software licenses or link to a copy hosted on your project's webspace. You can find a copy of these licenses in the HERE_NOTICE file, which is included in your HERE SDK package.