Shows how to use the AWS SDK for JavaScript (v3) to work with Amazon Location Service.

Amazon Location lets you easily and securely add maps, places, routes, geofences, and trackers, to your applications.

• Running this code might result in charges to your AWS account. For more details, see AWS Pricing and Free Tier.
• Running the tests might result in charges to your AWS account.
• We recommend that you grant your code least privilege. At most, grant only the minimum permissions required to perform the task. For more information, see Grant least privilege.
• This code is not tested in every AWS Region. For more information, see AWS Regional Services.

For prerequisites, see the README in the javascriptv3 folder.

• Hello Amazon Location (ListGeofenceCollections)

Code examples that show you how to perform the essential operations within a service.

• Learn the basics

Code excerpts that show you how to call individual service functions.

• BatchUpdateDevicePosition
• CalculateRoute
• CreateGeofenceCollection
• CreateMap
• CreateRouteCalculator
• CreateTracker
• DeleteGeofenceCollection
• DeleteMap
• DeleteRouteCalculator
• DeleteTracker
• GetDevicePosition
• PutGeofence

Note: All code examples are written in ECMAscript 6 (ES6). For guidelines on converting to CommonJS, see JavaScript ES6/CommonJS syntax.

Run a single action

node ./actions/<fileName>

Run a scenario

Most scenarios can be run with the following command:

node ./scenarios/<fileName>

Run with options

Some actions and scenarios can be run with options from the command line:

node ./scenarios/<fileName> --option1 --option2

util.parseArgs is used to configure these options. For the specific options available to each script, see the parseArgs usage for that file.

This example shows you how to get started using Amazon Location.

node ./hello.js

This example shows you how to do the following:

• Create an Amazon Location map.
• Create an Amazon Location API key.
• Display Map URL.
• Create a geofence collection.
• Store a geofence geometry.
• Create a tracker resource.
• Update the position of a device.
• Retrieve the most recent position update for a specified device.
• Create a route calculator.
• Determine the distance between Seattle and Vancouver.
• Use Amazon Location higher level APIs.
• Delete the Amazon Location Assets.

⚠ Running tests might result in charges to your AWS account.

To find instructions for running these tests, see the README in the javascriptv3 folder.

• Amazon Location Developer Guide
• Amazon Location API Reference
• SDK for JavaScript (v3) Amazon Location reference

Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

SPDX-License-Identifier: Apache-2.0