Amazon Location Service Developer Guide Amazon Location Service Developer Guide
Total Page:16
File Type:pdf, Size:1020Kb
Amazon Location Service Developer Guide Amazon Location Service Developer Guide Amazon Location Service: Developer Guide Copyright © Amazon Web Services, Inc. and/or its affiliates. All rights reserved. Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by Amazon. Amazon Location Service Developer Guide Table of Contents What is Amazon Location Service? ....................................................................................................... 1 Key features .............................................................................................................................. 1 Related services ......................................................................................................................... 2 How Amazon Location Service Works ................................................................................................... 3 Overview ................................................................................................................................... 3 Maps ................................................................................................................................ 4 Places ............................................................................................................................... 4 Routes .............................................................................................................................. 5 Geofences ......................................................................................................................... 6 Trackers ............................................................................................................................ 6 Component definitions ............................................................................................................... 7 Maps ................................................................................................................................ 7 Places ............................................................................................................................... 7 Routes .............................................................................................................................. 8 Geofences ........................................................................................................................ 10 Trackers ........................................................................................................................... 11 Regions and endpoints .............................................................................................................. 12 Regions ........................................................................................................................... 12 Endpoints ........................................................................................................................ 12 Data providers ................................................................................................................................. 14 Esri ......................................................................................................................................... 14 Map styles ....................................................................................................................... 14 Coverage ......................................................................................................................... 20 Terms of use and data attribution ...................................................................................... 20 Error reporting ................................................................................................................. 21 HERE Technologies ................................................................................................................... 21 Map styles ....................................................................................................................... 21 Coverage ......................................................................................................................... 20 Terms of use and data attribution ...................................................................................... 22 Error reporting ................................................................................................................. 22 Common use cases ........................................................................................................................... 23 User engagement and geomarketing applications ......................................................................... 23 Asset tracking applications ........................................................................................................ 24 Delivery applications ................................................................................................................. 25 Getting started ................................................................................................................................ 27 Sign up for AWS ...................................................................................................................... 27 Manage access to your AWS resources ........................................................................................ 27 Grant access to Amazon Location Service .................................................................................... 28 Next steps ............................................................................................................................... 29 Accessing Amazon Location ............................................................................................................... 30 Allowing unauthenticated guest access using Amazon Cognito ....................................................... 30 Create an Amazon Cognito identity pool ............................................................................. 31 Using the Identity Pool from JavaScript .............................................................................. 35 Next steps ....................................................................................................................... 35 Using Amazon Location ..................................................................................................................... 36 Using maps ............................................................................................................................. 36 Display a map in your application ...................................................................................... 37 Geocoding, reverse geocoding, and searching .............................................................................. 70 Prerequisites .................................................................................................................... 70 Geocoding ....................................................................................................................... 73 Reverse geocoding ............................................................................................................ 76 Tutorial: Amazon Aurora PostgreSQL user-defined functions .................................................. 77 Calculating a route ................................................................................................................... 87 Prerequisites .................................................................................................................... 87 iii Amazon Location Service Developer Guide Calculate route ................................................................................................................ 90 Geofencing an area of interest ................................................................................................... 95 Step 1: Add geofences ...................................................................................................... 96 Step 2: Start tracking ....................................................................................................... 99 Step 3: Link a tracker to a geofence collection ................................................................... 103 Step 4: Evaluate device positions against geofences ............................................................ 104 Reacting to geofence events with EventBridge ........................................................................... 105 Create event rules .......................................................................................................... 105 Event examples .............................................................................................................. 106 Monitoring with CloudWatch .................................................................................................... 107 Metrics .......................................................................................................................... 108 View metrics .................................................................................................................. 109 Create CloudWatch alarms ..............................................................................................