add initial files

Author: brmur

.doc_gen/metadata/location_metadata.yaml

@@ -36,6 +36,15 @@ location_CreateMap:
             - description:
               snippet_tags:
                 - location.kotlin.create.map.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location-services/actions
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - location.JavaScript.map.createMapV3
     Java:
       versions:
         - sdk_version: 2
@@ -80,6 +89,15 @@ location_CreateGeofenceCollection:
             - description:
               snippet_tags:
                 - location.kotlin.create.collection.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location-services/actions
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - location.JavaScript.geofence.createCollectionV3
     Java:
       versions:
         - sdk_version: 2
@@ -102,6 +120,15 @@ location_PutGeofence:
             - description:
               snippet_tags:
                 - location.kotlin.put.geo.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location-services/actions
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - location.JavaScript.geofence.putV3
     Java:
       versions:
         - sdk_version: 2
@@ -124,6 +151,15 @@ location_CreateTracker:
             - description:
               snippet_tags:
                 - location.kotlin.create.tracker.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location-services/actions
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - location.JavaScript.tracker.createTrackerV3
     Java:
       versions:
         - sdk_version: 2
@@ -146,6 +182,15 @@ location_BatchUpdateDevicePosition:
             - description:
               snippet_tags:
                 - location.kotlin.update.device.position.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location-services/actions
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - location.JavaScript.device.batchUpdatePositionV3
     Java:
       versions:
         - sdk_version: 2
@@ -168,6 +213,15 @@ location_GetDevicePosition:
             - description:
               snippet_tags:
                 - location.kotlin.get.device.position.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location-services/actions
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - location.JavaScript.position.getDevicePositionV3
     Java:
       versions:
         - sdk_version: 2
@@ -190,6 +244,15 @@ location_CreateRouteCalculator:
             - description:
               snippet_tags:
                 - location.kotlin.create.calculator.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location-services/actions
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - location.JavaScript.routes.createRouteCalcV3
     Java:
       versions:
         - sdk_version: 2
@@ -212,6 +275,15 @@ location_CalculateRoute:
             - description:
               snippet_tags:
                 - location.kotlin.calc.distance.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location-services/actions
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - location.JavaScript.distance.createDistAsyncV3
     Java:
       versions:
         - sdk_version: 2
@@ -234,6 +306,15 @@ location_DeleteGeofenceCollection:
             - description:
               snippet_tags:
                 - location.kotlin.delete.collection.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location-services/actions
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - location.JavaScript.geofence.deleteCollectionV3
     Java:
       versions:
         - sdk_version: 2
@@ -278,6 +359,15 @@ location_DeleteMap:
             - description:
               snippet_tags:
                 - location.kotlin.delete.map.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location-services/actions
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - location.JavaScript.geofence.deleteMapV3
     Java:
       versions:
         - sdk_version: 2
@@ -300,6 +390,15 @@ location_DeleteTracker:
             - description:
               snippet_tags:
                 - location.kotlin.delete.tracker.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location-services/actions
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - location.JavaScript.tracker.deleteTrackerV3
     Java:
       versions:
         - sdk_version: 2
@@ -322,6 +421,15 @@ location_DeleteRouteCalculator:
             - description:
               snippet_tags:
                 - location.kotlin.delete.calculator.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location-services/actions
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - location.JavaScript.calculator.deleteRouteCalculatorV3
     Java:
       versions:
         - sdk_version: 2
@@ -370,5 +478,14 @@ location_Scenario:
             - description: A wrapper class for &ALlong; SDK methods.
               snippet_tags:
                 - location.java2.actions.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location-services/scenarios
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - LocationServices.javascriptv3.Scenario.basics
   services:
     location: {}

javascriptv3/example_code/location-services/README.md

@@ -0,0 +1,58 @@
+# Amazon Location code examples for the SDK for JavaScript (v3)
+
+## Overview
+
+Shows how to use the AWS SDK for JavaScript (v3) to work with Amazon Location Service.
+
+## ⚠ Important
+
+- Running this code might result in charges to your AWS account. For more details, see [AWS Pricing](https://aws.amazon.com/pricing/) and [Free Tier](https://aws.amazon.com/free/).
+- 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege).
+- This code is not tested in every AWS Region. For more information, see [AWS Regional Services](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services).
+
+### Prerequisites
+
+For prerequisites, see the [README](../../../../README.md#prerequisites) in the `javascriptv3` folder.
+
+### Single Examples
+Code excerpts that show you how to call individual service functions.
+
+### Learn the Basics
+
+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.
+
+#### Run the scenario
+
+```bash
+node converse-tool-scenario.js
+```
+## Tests
+
+⚠ Running tests might result in charges to your AWS account.
+
+To find instructions for running these tests, see the [README](../../../../README.md#tests) in the `javascriptv3` folder.
+
+## Additional resources
+
+- [Amazon Location Developer Guide](https://docs.aws.amazon.com/location/latest/developerguide/what-is.html)
+- [Amazon Location API Reference](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html)
+- [SDK for JavaScript (v3) Amazon Location reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/location/)
+
+---
+
+Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+SPDX-License-Identifier: Apache-2.0

javascriptv3/example_code/location-services/actions/batch-update-device-position.js

@@ -0,0 +1,44 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+// snippet-start:[location.JavaScript.device.batchUpdatePositionV3]
+import { fileURLToPath } from "node:url";
+import {
+  BatchUpdateDevicePositionCommand,
+  LocationClient,
+  ResourceNotFoundException,
+} from "@aws-sdk/client-location";
+import data from "./inputs.json" with { type: "json" };
+const region = "eu-west-1";
+const locationClient = new LocationClient({ region: region });
+const updateDevicePosParams = {
+  TrackerName: `${data.inputs.trackerName}`,
+  Updates: [
+    {
+      DeviceId: `${data.inputs.deviceId}`,
+      SampleTime: new Date(),
+      Position: [-122.4194, 37.7749],
+    },
+  ],
+};
+async function main() {
+  try {
+    const command = new BatchUpdateDevicePositionCommand(updateDevicePosParams);
+    const response = await locationClient.send(command);
+    //console.log("response ", response.Errors[0].Error);
+
+    console.log(
+      `Device with id ${data.inputs.deviceId} was successfully updated in the location tracking system. `,
+      response,
+    );
+  } catch (error) {
+    console.log("error ", error);
+  }
+}
+
+// snippet-end:[location.JavaScript.device.batchUpdatePositionV3]
+
+// Invoke main function if this file was run directly.
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  main();
+}

javascriptv3/example_code/location-services/actions/calculate-distance-async.js

@@ -0,0 +1,47 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+// snippet-start:[location.JavaScript.distance.createDistAsyncV3]
+import { fileURLToPath } from "node:url";
+import {
+  CalculateRouteCommand,
+  ResourceNotFoundException,
+  LocationClient,
+} from "@aws-sdk/client-location";
+import data from "./inputs.json" with { type: "json" };
+
+const region = "eu-west-1";
+const locationClient = new LocationClient({ region: region });
+
+async function main() {
+  const routeCalcParams = {
+    CalculatorName: `${data.inputs.calculatorName}`,
+    DeparturePosition: [-122.3321, 47.6062],
+    DestinationPosition: [-123.1216, 49.2827],
+    TravelMode: "Car",
+    DistanceUnit: "Kilometers",
+  };
+  try {
+    const command = new CalculateRouteCommand(routeCalcParams);
+    const response = await locationClient.send(command);
+
+    console.log(
+      "Successfully calculated route. The distance in kilometers is : ",
+      response.Summary.Distance,
+    );
+  } catch (caught) {
+    if (caught instanceof ResourceNotFoundException) {
+      console.error(
+        `An conflict occurred: ${caught.message} \n Exiting program.`,
+      );
+      return;
+    }
+  }
+}
+
+// snippet-end:[location.JavaScript.distance.createDistAsyncV3]
+
+// Invoke main function if this file was run directly.
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  main();
+}