HERE Android SDK

1951 Pages·2017·26.62 MB·English

HERE Android SDK
Developer's Guide
Premium Edition Version 3.3.1
HERE Android SDK Developer's Guide
►  Notices
Important Information  
Notices
Topics: This section contains document notices.
• Legal Notices
• Document Information
• Service Support
2
HERE Android SDK Developer's Guide
►  Notices
Legal Notices
© 2017 HERE Global B.V. and its Affiliate(s). All rights reserved.
This material, including documentation and any related computer programs, is protected by copyright
controlled by HERE. All rights are reserved. Copying, including reproducing, storing, adapting or translating,
any or all of this material requires the prior written consent of HERE. This material also contains confidential
information, which may not be disclosed to others without the prior written consent of HERE.
Trademark Acknowledgements
HERE is trademark or registered trademark of HERE Global B.V.
Other product and company names mentioned herein may be trademarks or trade names of their respective
owners.
Disclaimer
This content is provided "as-is" and without warranties of any kind, either express or implied, including, but
not limited to, the implied warranties of merchantability, fitness for a particular purpose, satisfactory quality
and non-infringement. HERE does not warrant that the content is error free and HERE does not warrant or
make any representations regarding the quality, correctness, accuracy, or reliability of the content. You
should therefore verify any information contained in the content before acting on it.
To the furthest extent permitted by law, under no circumstances, including without limitation the negligence
of HERE, shall HERE be liable for any damages, including, without limitation, direct, special, indirect, punitive,
consequential, exemplary and/ or incidental damages that result from the use or application of this content,
even if HERE or an authorized representative has been advised of the possibility of such damages.
3
HERE Android SDK Developer's Guide
►  Notices
Document Information

Product
   Name: HERE Android SDK
   Version: Premium Edition Version 3.3.1

Document
   Name: HERE Android SDK Developer's Guide
   ID: 13dc7ca-1495235125-3db914db
   Status: FINAL
   Date: 2017-May-19, 23:19 (GMT)

Service Support
If you need assistance with this or any other HERE product, select one of the following options.
• If you have a HERE representative, contact them when you have questions/issues.
• If you manage your applications and accounts through developer.here.com, log into your account
and check the pages on the SLA report or API Health. If this does not clarify the issue, then check
stackoverflow.com/questions/tagged/here-api.
• If you have an evaluation plan, check stackoverflow.com/questions/tagged/here-api.
• If you have questions about billing or your account, Contact Us.
• If you have purchased your plan/product from a HERE reseller, contact your reseller.
4
HERE Android SDK Developer's Guide
►  Contents
Contents
Chapter 1: Overview............................................................................................................................................................................8
What is the HERE Android SDK?.................................................................................................................................................................9
Feature List.............................................................................................................................................................................................................9
Legal Requirements..........................................................................................................................................................................................11
Chapter 2: Quick Start..................................................................................................................................................................12
Running the Sample Application..............................................................................................................................................................13
Chapter 3: User Guide...................................................................................................................................................................15
System Requirements.....................................................................................................................................................................................16
Authenticating Applications........................................................................................................................................................................16
Examples on GitHub........................................................................................................................................................................................17
HERE Map Data...................................................................................................................................................................................................17
Embedding the Map Service.......................................................................................................................................................................18
Maps.........................................................................................................................................................................................................................19
Gestures..............................................................................................................................................................................................................24
Map Schemes..................................................................................................................................................................................................28
MapEngine Class............................................................................................................................................................................................31
Objects and Interaction.............................................................................................................................................................................32
Marker Clustering..........................................................................................................................................................................................44
Traffic Information........................................................................................................................................................................................47
Offline Maps (MapLoader)........................................................................................................................................................................49
Shared Map Resources...............................................................................................................................................................................51
Traffic History..................................................................................................................................................................................................51
3D Landmarks..................................................................................................................................................................................................53
Extruded Buildings.......................................................................................................................................................................................54
Custom Raster Tiles.....................................................................................................................................................................................57
Mobile Asset Management.......................................................................................................................................................................60
Fleet Connectivity.........................................................................................................................................................................................63
Transit..................................................................................................................................................................................................................65
Map Customization.......................................................................................................................................................................................75
Positioning............................................................................................................................................................................................................78
5
HERE Android SDK Developer's Guide
►  Contents
Basic Positioning...........................................................................................................................................................................................78
Advanced Positioning by HERE.............................................................................................................................................................82
Map Matching..................................................................................................................................................................................................89
Directions..............................................................................................................................................................................................................90
Car and Pedestrian Routing...................................................................................................................................................................90
Bicycle Routing...............................................................................................................................................................................................95
Truck Routing..................................................................................................................................................................................................96
Transit Routing...............................................................................................................................................................................................97
Indoor Venue Routing..............................................................................................................................................................................101
Offline Routing.............................................................................................................................................................................................105
Route Serialization.....................................................................................................................................................................................105
Places....................................................................................................................................................................................................................106
Geocoding and Reverse Geocoding..................................................................................................................................................106
Search and Discovery...............................................................................................................................................................................108
Offline Search................................................................................................................................................................................................116
Custom Locations and Geometries.......................................................................................................................................................116
Custom Location Extension 2................................................................................................................................................................117
Using CLE2 Offline.......................................................................................................................................................................................121
Street-Level........................................................................................................................................................................................................123
Street-Level Imagery.................................................................................................................................................................................123
Street-Level Objects..................................................................................................................................................................................129
Turn-by-Turn Navigation.............................................................................................................................................................................132
Navigation Events.......................................................................................................................................................................................135
Voice Instructions.......................................................................................................................................................................................139
Traffic-Aware Navigation.........................................................................................................................................................................142
Audio Management........................................................................................................................................................................................143
Urban Mobility..................................................................................................................................................................................................144
Coverage Search..........................................................................................................................................................................................145
Transit Station Search..............................................................................................................................................................................147
Next Nearby Departures.........................................................................................................................................................................149
3D Venues............................................................................................................................................................................................................151
Venue Zoom...................................................................................................................................................................................................159
Private Venues..............................................................................................................................................................................................161
LiveSight.............................................................................................................................................................................................................162
Starting and Stopping LiveSight.........................................................................................................................................................163
Adding and Interacting with LiveSight Content..........................................................................................................................165
Customizing LiveSight...............................................................................................................................................................................170
Platform Data Extension.............................................................................................................................................................................174
6
HERE Android SDK Developer's Guide
►  Contents
Chapter 4: Supplemental Information................................................................................................................182
Creating a Simple Application.................................................................................................................................................................183
Requesting Android Permissions...........................................................................................................................................................189
Adding a MapFragment at Runtime......................................................................................................................................................191
3D Venues FAQ.................................................................................................................................................................................................191
Size Management............................................................................................................................................................................................197
Map Rendering Order...................................................................................................................................................................................197
Development Tips...........................................................................................................................................................................................199
Signpost Parsing.............................................................................................................................................................................................202
Chapter 5: Coverage Information..............................................................................................................................205
Downloadable Maps by Country/Region...........................................................................................................................................206
Map Label Languages...................................................................................................................................................................................210
Navigation Voices............................................................................................................................................................................................212
Safety Camera Coverage.............................................................................................................................................................................214
Chapter 6: API Reference......................................................................................................................................................216
7
HERE Android SDK Developer's Guide
►  Overview
Chapter 1
Overview
Topics: The articles that follow introduce the HERE Android SDK, explain
• What is the HERE Android S... essential concepts and describe the common use cases it supports.
• Feature List
• Legal Requirements
8
HERE Android SDK Developer's Guide
►  Overview
What is the HERE Android SDK?
The HERE Android SDK provides a set of programming interfaces that enable developers to build an
immersive, geographically-aware Android applications by leveraging a powerful and flexible mapping
platform. Through this SDK, developers can add rich location features such as routing, interactive maps,
and global place search to their applications. The powerful client-side HERE Android SDK also includes
a sophisticated engine for rendering map data and calculated routes. In addition to dynamic map data
downloads, the SDK also supports offline maps using previously cached map data or downloaded map
packages.
Feature List
The main features offered by the HERE Android SDK are listed below.
Not all features are enabled by default. The features available to you are determined based on your business
plan.
Note: The HERE Android SDK is designed for standalone Android APK development. Using the HERE
SDK for platform-embedded app development (apps that ship with the device ROM) is not supported.
Mapping:
• Dynamically download vector maps for more than 190 countries in over 60 languages
• Preload maps for offline usage
• Map styles: normal street map, satellite map, transit map, and more
• Textured 3D landmarks
• Street-level imagery
• Touch gestures (including rotate, tilt, pan, flick, and pinch zoom)
• Overlay objects on the map such as polylines, polygons, icons, and routes
• Map marker clusters
• Overlay 3D map objects
• Overlay custom raster tiles on the map (for example, to display heat maps)
• Ability to render raster tiles and map objects interleaved within different map layers
• 3D venue (indoor) maps
• Show real-time traffic flow and incidents
• 3D Extruded Buildings
• Transit object interaction
Search:
• Search through a broad set of geographical content across the globe, (including streets, address points,
and categorized places)
• Search for a specific place or explore by categories
• Access rich details for a Point of Interest from third-party content sources (including images, ratings,
reviews, and editorials)
9
HERE Android SDK Developer's Guide
►  Overview
• Perform geocoding and reverse geocoding lookups
• Offline Places search, Geocoding, Reverse Geocoding
Directions:
• Online Car, Public Transit, Bicylce, Truck, and Pedestrian Route Directions
• Routing options (Highways, Tolls, Fastest etc.)
• Specify preferred route type (fastest or shortest) and route options (such as avoiding toll roads,
motorways, and parks)
• Alternate routes
• Saving a route as a file
• Offline route calculation
• Driving directions with traffic taken into account
• Public Transit directions using online timetables
• Indoor routing
Turn-by-turn Navigation:
• Online turn-by-turn navigation for pedestrian, car, and truck routes
• Offline turn-by-turn navigation for pedestrian and car routes
• Natural-sounding guidance instructions, such as "turn left at the gas station" and "at the next light, turn
right"
• Recorded audio and speech synthesis voices in a variety of languages. For a list of the available
languages, see the Developer's Guide.
• Approximate user coordinates to the nearest road or navigation route
• Approximate user tunnel position, even when there is no GPS signal
• Dynamic information including signposts, the driver's current street lane, and speed
• Realistic previews of certain junctions and lanes
HERE Positioning:
• Wi-Fi, Cellular, and BT network-based positioning, including:
Online Outdoor positioning
▫
Online-Offline Hybrid Outdoor positioning
▫
Indoor positioning
▫
Private Indoor positioning
▫
LiveSight:
• Track the position of a device in space and animate view accordingly
• Seamless transitions from Map to LiveSight and back again
• Gesture support allows the user to interact with content, custom gestures can also be defined
• Content transitions and interaction are animated using hardware acceleration
• "Radar" UI support, which provides the user with more context regarding their position relative to
content
• Highly configurable LiveSight engine allows the user experience to be customized
Other Features:
• Custom location and custom location geometry search
10