Prerequisiti

Prima di iniziare a calcolare i percorsi, segui i passaggi preliminari:

Crea una risorsa per il calcolo dei percorsi

Prima di poter calcolare un percorso, crea una risorsa per il calcolo del percorso nel tuo AWS account.

Quando crei una risorsa per il calcolo del percorso, puoi scegliere tra i fornitori di dati disponibili:

1. Esri: per ulteriori informazioni sulla copertura di Esri nella regione di interesse, consulta i dettagli di Esri sulle reti stradali e sulla copertura del traffico.

2. Tecnologie HERE — Per ulteriori informazioni sulla copertura di HERE nella tua area di interesse, consulta HERE Car Routing Coverage e HERE Truck Routing coverage.

3. Grab — Per ulteriori informazioni sulla copertura di Grab, consulta. Paesi/regioni e aree coperte

Nota

Se la tua applicazione esegue il tracciamento o l’instradamento di risorse utilizzate nella tua azienda, ad esempio veicoli per la consegna o dipendenti, non devi utilizzare Esri come provider di geolocalizzazione. Per ulteriori dettagli, consulta la sezione 82 dei Termini di servizio di AWS.

Puoi farlo utilizzando la console Amazon Location ServiceAWS CLI, o le API Amazon Location.

Console

Per creare una risorsa per il calcolo del percorso utilizzando la console Amazon Location

1. Apri la console Amazon Location all'indirizzo https://console.aws.amazon.com/location/.

2. Nel riquadro di navigazione a sinistra, scegli Calcolatori di percorso.

3. Scegli Crea calcolatore di percorso.

4. Compila le seguenti caselle:

   • Nome: inserisci un nome per la risorsa del calcolatore del percorso. Ad esempio, ExampleCalculator. Massimo 100 caratteri. Le voci valide includono caratteri alfanumerici, trattini, punti e caratteri di sottolineatura.

   • Descrizione: immettere una descrizione opzionale.

5. Per i fornitori di dati, scegli un fornitore di dati da utilizzare come calcolatore di percorso.

6. (Facoltativo) In Tag, immettere Key (Chiave) e Value (Valore) di un tag. Questo aggiunge un tag alla tua nuova risorsa per il calcolo del percorso. Per ulteriori informazioni, consulta Tagging delle risorse.

7. Scegli Crea calcolatore di percorso.

API

Per creare una risorsa per il calcolo del percorso utilizzando le API di Amazon Location

Usa l'CreateRouteCalculatoroperazione dalle API di Amazon Location Places.

L'esempio seguente è una richiesta API per creare una risorsa di calcolo del percorso chiamata ExampleCalculatorutilizzando il provider di dati Esri.

POST /routes/v0/calculators
Content-type: application/json

{
   "CalculatorName": "ExampleCalculator",
   "DataSource": "Esri",
   "Description": "string",
   "Tags": { 
      "Tag1" : "Value1" 
   }
}

AWS CLI

Per creare una risorsa per il calcolo del percorso utilizzando i comandi AWS CLI

Utilizza il comando create-route-calculator.

L'esempio seguente crea una risorsa per il calcolo del percorso chiamata ExampleCalculatorutilizzando Esri come fornitore di dati.

aws location \
  create-route-calculator \
  --calculator-name "ExampleCalculator" \
  --data-source "Esri" \
  --tags Tag1=Value1

Nota

La fatturazione dipende dall'utilizzo. Potresti incorrere in commissioni per l'uso di altri servizi. AWS Per ulteriori informazioni, consulta i prezzi di Amazon Location Service.

Autenticazione delle tue richieste

Una volta creata una risorsa per il calcolo del percorso e sei pronto per iniziare a integrare le funzionalità di localizzazione nella tua applicazione, scegli come autenticare le tue richieste:

• Per scoprire come accedere ai servizi, consulta Accedere ad Amazon Location Service.

• Se hai un sito Web con utenti anonimi, potresti voler utilizzare le chiavi API o Amazon Cognito.

  Esempio

  L'esempio seguente mostra l'utilizzo di una chiave API per l'autorizzazione, l'utilizzo di AWS JavaScript SDK v3 e Amazon Location. JavaScript Aiutante di autenticazione

  import { LocationClient, CalculateRouteCommand } from "@aws-sdk/client-location";
  import { withAPIKey } from "@aws/amazon-location-utilities-auth-helper";
  
  const apiKey = "v1.public.your-api-key-value"; // API key
  
  // Create an authentication helper instance using an API key
  const authHelper = await withAPIKey(apiKey);
  
  const client = new LocationClient({
    region: "<region>", // region containing Cognito pool
    ...authHelper.getLocationClientConfig(), // Provides configuration required to make requests to Amazon Location
  });
  
  const input = {
    CalculatorName: "ExampleCalculator",
    DeparturePosition: [-123.4567, 45.6789],
    DestinationPosition: [-123.123, 45.234],
  };
  
  const command = new CalculateRouteCommand(input);
  
  const response = await client.send(command);