Conditions préalables au calcul des itinéraires à l'aide d'Amazon Location - Amazon Location Service
Création d'une ressource de calcul d'itinéraireAuthentification de vos demandes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Conditions préalables au calcul des itinéraires à l'aide d'Amazon Location

Cette page décrit les conditions requises pour commencer à utiliser les fonctionnalités de routage du service, qui vous permettent de calculer des itinéraires et des temps de trajet optimisés entre plusieurs sites. Il couvre des sujets essentiels, tels que la configuration des autorisations d'accès, la configuration des ressources requises au sein de votre AWS compte et les dépendances ou outils supplémentaires nécessaires en fonction de votre cas d'utilisation ou de votre environnement de développement spécifiques.

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. HERETechnologies — Pour plus d'informations sur HERE la couverture dans la région qui vous intéresse, consultez les rubriques Couverture des itinéraires HERE automobiles et Couverture des itinéraires des HERE camions.

  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 Service AWS CLI, du ou de l'Amazon LocationAPIs.

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éraires à l'aide d'Amazon Location APIs

Utilisez l'CreateRouteCalculatoropération depuis Amazon Location PlacesAPIs.

L'exemple suivant est une API demande de création d'une ressource de calcul d'itinéraire appelée ExampleCalculator en utilisant le 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 ExampleCalculator utilisant Esri en tant que 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 la tarification 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 API Keys ou Amazon Cognito.

    Exemple

    L'exemple suivant montre l'utilisation d'une API clé pour l'autorisation, à l'aide de la AWS JavaScriptSDKversion 3, et de l'emplacement JavaScript Aide à l'authentification Amazon.

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