Positionne les prérequis à l'aide d'Amazon Location - Amazon Location Service
Création d'une ressource d'index des lieuxAuthentification 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.

Positionne les prérequis à l'aide d'Amazon Location

Avant de commencer le géocodage, le géocodage inversé ou la recherche de lieux, suivez les étapes préalables :

Création d'une ressource d'index des lieux

Commencez par créer une ressource d'index des lieux dans votre AWS compte.

Lorsque vous créez une ressource d'index géographique, vous pouvez choisir parmi les fournisseurs de données disponibles pour prendre en charge les requêtes de géocodage, de géocodage inversé et de recherches :

  1. Esri : pour plus d'informations sur la couverture d'Esri dans la région qui vous intéresse, consultez la section Couverture du géocodage Esri dans la documentation Esri.

  2. HERETechnologies — Pour plus d'informations sur HERE la couverture dans la région qui vous intéresse, consultez la section couverture du HERE géocodage dans la HERE documentation.

  3. Grab — Grab fournit des données uniquement pour l'Asie du Sud-Est. Pour plus d'informations sur la couverture de Grab, consultez Pays/régions et zone couverts ce guide.

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 d'index de lieux à l'aide de la console Amazon Location Service

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

  2. Dans le volet de navigation de gauche, choisissez Placer les index.

  3. Choisissez Créer un index des lieux.

  4. Remplissez les cases suivantes :

    • Nom — Entrez le nom de la ressource d'index des lieux. Par exemple, ExamplePlaceIndex. 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. Sous Fournisseurs de données, choisissez un fournisseur de données disponible à utiliser avec votre ressource d'index des lieux.

    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.

  6. Sous Options de stockage des données, indiquez si vous avez l'intention de stocker les résultats de recherche à partir de votre ressource d'index des lieux.

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

  8. Choisissez Créer un index des lieux.

API

Pour créer une ressource d'index des lieux à l'aide d'Amazon Location APIs

Utilisez l'CreatePlaceIndexopération depuis Amazon Location PlacesAPIs.

L'exemple suivant est une API demande de création d'une ressource d'index de lieux appelée ExamplePlaceIndex en utilisant le fournisseur de données Esri.

POST /places/v0/indexes
Content-type: application/json

{
   "DataSource": "Esri",
   "DataSourceConfiguration": { 
      "IntendedUse": "SingleUse"
   },
   "Description": "string",
   "IndexName": "ExamplePlaceIndex",
   "Tags": { 
      "Tag1" : "Value1" 
   }
}
AWS CLI

Pour créer une ressource d'index de lieux à l'aide de AWS CLI commandes

Utilisez la commande create-place-index.

L'exemple suivant crée une ressource d'index de lieux appelée ExamplePlaceIndex utilisant Esri en tant que fournisseur de données. 

aws location \
  create-place-index \
  --data-source "Esri" \
  --description "Example place index" \
  --index-name "ExamplePlaceIndex" \
  --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 d'index des lieux 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, SearchPlaceIndexForTextCommand } 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 = {
  IndexName: "ExamplePlaceIndex",
  Text: "Anyplace",
  BiasPosition: [-123.4567, 45.6789]
};

const command = new SearchPlaceIndexForTextCommand(input);

const response = await client.send(command);