Prérequis

Avant de commencer à calculer les itinéraires, suivez les étapes préalables :

Création d'une ressource de calcul d'itinéraire

Avant de calculer un itinéraire, créez une ressource de calcul d'itinéraire dans votre AWS compte.

Lorsque vous créez une ressource de calcul d'itinéraire, vous pouvez choisir parmi les fournisseurs de données disponibles :

1. Esri — Pour plus d'informations sur la couverture d'Esri dans la région qui vous intéresse, consultez les informations d'Esri sur les réseaux routiers et la couverture du trafic.

2. Technologies HERE — Pour plus d'informations sur la couverture de HERE dans la région qui vous intéresse, consultez les rubriques Couverture des itinéraires automobiles HERE et Couverture des itinéraires des camions HERE.

3. Grab — Pour plus d'informations sur la couverture de Grab, voirPays/régions et zone couverts.

Note

Si votre application assure le suivi ou le routage des ressources que vous utilisez dans votre entreprise, comme les véhicules de livraison ou les employés, vous ne devez pas utiliser Esri comme fournisseur de géolocalisation. Consultez la section 82 des Conditions de service AWS pour plus de détails.

Vous pouvez le faire à l'aide de la console Amazon Location ServiceAWS CLI, ou des API Amazon Location.

Console

Pour créer une ressource de calcul d'itinéraire à l'aide de la console Amazon Location

1. Ouvrez la console Amazon Location à l'adresse https://console.aws.amazon.com/location/.

2. Dans le volet de navigation de gauche, choisissez Calculateurs d'itinéraires.

3. Choisissez Créer un calculateur d'itinéraire.

4. Remplissez les cases suivantes :

   • Nom — Entrez le nom de la ressource du calculateur d'itinéraire. Par exemple, ExampleCalculator. 100 caractères maximum. Les entrées valides incluent les caractères alphanumériques, les traits d'union, les points et les traits de soulignement.

   • Description — Entrez une description facultative.

5. Pour les fournisseurs de données, choisissez un fournisseur de données à utiliser comme calculateur d'itinéraire.

6. (Facultatif) Sous Tags (Balises), entrez des paramètres Key (Clé) et Value (Valeur) de balise. Cela ajoute une balise à votre nouvelle ressource de calcul d'itinéraire. Pour plus d'informations, veuillez consulter la rubrique Balisage de vos ressources.

7. Choisissez Créer un calculateur d'itinéraire.

API

Pour créer une ressource de calcul d'itinéraire à l'aide des API Amazon Location

Utilisez l'CreateRouteCalculatoropération depuis les API Amazon Location Places.

L'exemple suivant est une demande d'API pour créer une ressource de calcul d'itinéraire appelée à ExampleCalculatorl'aide du fournisseur de données Esri.

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

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

AWS CLI

Pour créer une ressource de calcul d'itinéraire à l'aide de AWS CLI commandes

Utilisez la commande create-route-calculator.

L'exemple suivant crée une ressource de calcul d'itinéraire appelée ExampleCalculatoren utilisant Esri comme fournisseur de données.

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

Note

La facturation dépend de votre utilisation. L'utilisation d'autres AWS services peut entraîner des frais. Pour plus d'informations, consultez les tarifs d'Amazon Location Service.

Authentification de vos demandes

Une fois que vous avez créé une ressource de calcul d'itinéraire et que vous êtes prêt à intégrer des fonctionnalités de localisation dans votre application, choisissez la manière dont vous souhaitez authentifier vos demandes :

• Pour découvrir comment accéder aux services, consultez la section Accès à Amazon Location Service.

• Si vous avez un site Web avec des utilisateurs anonymes, vous pouvez utiliser des clés d'API ou Amazon Cognito.

  Exemple

  L'exemple suivant montre l'utilisation d'une clé d'API pour l'autorisation, à l'aide du JavaScriptSDK AWS v3 et de l'Amazon Location. JavaScript Aide à l'authentification

  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);