HERE Android SDK PDF
Preview HERE Android SDK
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
Description:The list of books you might like
