HERE Android SDK

2324 Pages·2016·27.47 MB·English

HERE Android SDK
Developer's Guide
Premium Edition Version 3.3
HERE Android SDK Developer's Guide 2
►  Notices  
Important Information

Notices
Topics: This section contains document notices.
• Legal Notices
• Document Information
• Service Support
HERE Android SDK Developer's Guide 3
►  Notices  
Legal Notices
© 2016 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.
HERE Android SDK Developer's Guide 4
►  Notices  
Document Information

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

Document
   Name: HERE Android SDK Developer's Guide
   ID: 72d9fd3-1481926831-3db914db
   Status: FINAL
   Date: 2016-Dec-16, 22:26 (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.
HERE Android SDK Developer's Guide 5
►  Contents  
Contents
Notices 2
....................................................................................................................................................................
Legal Notices............................................................................................................................................................3
Document Information...........................................................................................................................................4
Service Support........................................................................................................................................................4
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 16
.........................................................................................................................
System Requirements..........................................................................................................................................17
Authenticating Applications................................................................................................................................17
Examples on GitHub.............................................................................................................................................18
Embedding the Map Service...............................................................................................................................19
Maps..........................................................................................................................................................................20
Gestures...............................................................................................................................................................26
Map Schemes......................................................................................................................................................30
MapEngine Class.................................................................................................................................................35
Objects and Interaction....................................................................................................................................36
Marker Clustering...............................................................................................................................................50
Positioning...........................................................................................................................................................53
HERE Positioning................................................................................................................................................57
Map Matching......................................................................................................................................................61
HERE Android SDK Developer's Guide 6
►  Contents  
Offline Maps (MapLoader)................................................................................................................................62
Shared Map Resources.....................................................................................................................................65
Traffic Information............................................................................................................................................65
Traffic History.....................................................................................................................................................67
3D Landmarks.....................................................................................................................................................69
Extruded Buildings.............................................................................................................................................70
Custom Raster Tiles..........................................................................................................................................74
Mobile Asset Management...............................................................................................................................77
Fleet Connectivity..............................................................................................................................................80
Transit...................................................................................................................................................................83
Map Customization............................................................................................................................................94
Directions................................................................................................................................................................97
Car and Pedestrian Routing.............................................................................................................................98
Bicycle Routing.................................................................................................................................................103
Truck Routing...................................................................................................................................................104
Transit Routing.................................................................................................................................................105
Indoor Venue Routing.....................................................................................................................................109
Offline Routing.................................................................................................................................................114
Route Serialization..........................................................................................................................................114
Places.....................................................................................................................................................................115
Geocoding and Reverse Geocoding............................................................................................................116
Search and Discovery.....................................................................................................................................118
Offline Search...................................................................................................................................................126
Custom Locations and Geometries................................................................................................................126
Custom Location Extension 2.......................................................................................................................127
Using CLE2 Offline..........................................................................................................................................132
Street-Level..........................................................................................................................................................134
Street-Level Imagery......................................................................................................................................134
Street-Level Objects.......................................................................................................................................140
Turn-by-Turn Navigation...................................................................................................................................144
Navigation Events............................................................................................................................................148
Voice Instructions............................................................................................................................................152
Traffic-Aware Navigation...............................................................................................................................155
HERE Android SDK Developer's Guide 7
►  Contents  
Audio Management.............................................................................................................................................157
Urban Mobility......................................................................................................................................................159
Coverage Search..............................................................................................................................................159
Transit Station Search....................................................................................................................................161
Next Nearby Departures................................................................................................................................164
3D Venues.............................................................................................................................................................166
Venue Zoom......................................................................................................................................................176
LiveSight..............................................................................................................................................................178
Starting and Stopping LiveSight..................................................................................................................180
Adding and Interacting with LiveSight Content........................................................................................182
Customizing LiveSight....................................................................................................................................188
Platform Data Extension...................................................................................................................................193
Chapter 4: Supplemental Information 201
..............................................................................
Creating a Simple Application..........................................................................................................................202
Adding a MapFragment at Runtime................................................................................................................210
Size Management................................................................................................................................................211
Map Rendering Order.........................................................................................................................................211
Development Tips...............................................................................................................................................214
Signpost Parsing.................................................................................................................................................216
Chapter 5: Coverage Information 219
.........................................................................................
Downloadable Maps by Country/Region.......................................................................................................220
Map Label Languages........................................................................................................................................225
Navigation Voices................................................................................................................................................228
Safety Camera Coverage..................................................................................................................................230
Chapter 6: API Reference 232
..............................................................................................................
HERE Android SDK Developer's Guide 8
►  Overview  
Chapter
1
Overview
Topics: The HERE Android SDK offers APIs to enable developers to access
• What is the HERE Android S... HERE location-based assets and bring a rich and immersive
• Feature List location experience to their applications with beautiful and
• Legal Requirements accurate maps, a global database of Places and a world-class
routing capability. The powerful client-side HERE APIs for Android
include a sophisticated engine for rendering map data and route
calculation. In addition to downloading map data dynamically as
needed, it also supports offline maps through use of previously
cached map data or previously downloaded map packages.
The articles that follow introduce the HERE Android SDK, explain
essential concepts and describe the common use cases it
supports.
HERE Android SDK Developer's Guide 9
►  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
HERE Android SDK Developer's Guide 10
►  Overview  
• Traffic 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)
• 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