Prerequisiti

Prima di iniziare la geocodifica, la geocodifica inversa o la ricerca di luoghi, segui i passaggi preliminari:

Creazione di una risorsa per l'indice dei luoghi

Inizia creando una risorsa dedicata all'indice dei luoghi nel tuo AWS account.

Quando crei una risorsa per l'indice dei luoghi, puoi scegliere tra i fornitori di dati disponibili per supportare le query per la geocodifica, la geocodifica inversa e le ricerche:

1. Esri: per ulteriori informazioni sulla copertura di Esri nella regione di interesse, vedere la copertura di geocodifica Esri nella documentazione Esri.

2. Tecnologie HERE — Per ulteriori informazioni sulla copertura di HERE nella tua regione di interesse, consulta la copertura di geocodifica HERE nella documentazione HERE.

3. Grab: Grab fornisce dati solo per il sud-est asiatico. Per ulteriori informazioni sulla copertura di Grab, consulta Paesi/regioni e aree coperte questa guida.

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

Console

Per creare una risorsa relativa all'indice dei luoghi utilizzando la console Amazon Location Service

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

2. Nel riquadro di navigazione a sinistra, scegli Posiziona indici.

3. Scegli Crea indice dei luoghi.

4. Compila le seguenti caselle:

   • Nome: inserisci un nome per la risorsa dell'indice dei luoghi. Ad esempio, ExamplePlaceIndex. Massimo 100 caratteri. Le voci valide includono caratteri alfanumerici, trattini, punti e caratteri di sottolineatura.

   • Descrizione: immettere una descrizione facoltativa.

5. In Fornitori di dati, scegli un fornitore di dati disponibile da utilizzare con la tua risorsa relativa all'indice dei luoghi.

   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 diAWS.

6. In Opzioni di archiviazione dei dati, specifica se intendi archiviare i risultati della ricerca dalla risorsa dell'indice dei luoghi.

7. (Facoltativo) In Tag, immettere Key (Chiave) e Value (Valore) di un tag. Questo aggiunge un tag alla nuova risorsa dell'indice dei luoghi. Per ulteriori informazioni, consulta Tagging delle risorse.

8. Scegli Crea indice dei luoghi.

API

Per creare una risorsa relativa all'indice dei luoghi utilizzando le API di Amazon Location

Usa l'CreatePlaceIndexoperazione dalle API di Amazon Location Places.

L'esempio seguente è una richiesta API per creare una risorsa di indice dei luoghi chiamata ExamplePlaceIndexutilizzando il provider di dati Esri.

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

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

AWS CLI

Per creare una risorsa relativa all'indice dei luoghi utilizzando i comandi AWS CLI

Utilizza il comando create-place-index.

L'esempio seguente crea una risorsa di indice dei luoghi chiamata ExamplePlaceIndexutilizzando Esri come fornitore di dati.

aws location \
  create-place-index \
  --data-source "Esri" \
  --description "Example place index" \
  --index-name "ExamplePlaceIndex" \
  --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 l'indice dei luoghi e sei pronto per iniziare a inserire 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, 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);