Requisitos previos

Antes de empezar con la geocodificación, la geocodificación inversa o la búsqueda de lugares, siga estos pasos previos:

Crear un recurso de índice de ubicación

Comience por crear un recurso de índice de sitios en su cuenta. AWS

Al crear un recurso de índice de ubicación, puede elegir entre los proveedores de datos disponibles para admitir las consultas de geocodificación, geocodificación inversa y búsquedas:

1. Esri: para obtener más información sobre la cobertura de Esri en la región de su interés, consulte la cobertura de geocodificación de Esri en la documentación de Esri.

2. Tecnologías HERE: para obtener más información sobre la cobertura de HERE en la región que le interese, consulte la cobertura de geocodificación de HERE en la documentación de HERE.

3. Grab: Grab proporciona datos solo en el sudeste asiático. Para obtener más información sobre la cobertura de Grab, consulte Países, regiones y áreas cubiertas en esta guía.

Puede hacerlo mediante la consola de Amazon Location Service AWS CLI, la o las API de ubicación de Amazon.

Console

Para crear un recurso de índice de ubicación mediante la consola de Amazon Location Service

1. Abra la consola de Amazon Location Service en https://console.aws.amazon.com/location/.

2. En el panel de navegación izquierdo, elija Índices de ubicación.

3. Elija Crear índice de ubicación.

4. Complete las casillas siguientes:

   • Nombre: introduzca un nombre para el recurso de índice de ubicación. Por ejemplo, ExamplePlaceIndex. 100 caracteres como máximo. Entre las entradas válidas se incluyen caracteres alfanuméricos, guiones, puntos y guiones bajos.

   • Descripción : escriba una descripción opcional.

5. En Proveedores de datos, elija un proveedor de datos disponible para usarlo con su recurso de índice de ubicación.

   nota

   Si su aplicación rastrea o enruta los activos que utiliza en su empresa, como vehículos de reparto o empleados, no debe utilizar Esri como proveedor de geolocalización. Consulte la sección 82 de los Términos de servicio deAWS para obtener más detalles.

6. En Opciones de almacenamiento de datos, especifique si desea almacenar los resultados de búsqueda de su recurso de índice de ubicación.

7. (Opcional) En Etiquetas, escriba una Clave y un Valor de etiqueta. Esto añade una etiqueta a su nuevo recurso de índice de ubicación. Para obtener más información, consulte Etiquetado de los recursos.

8. Elija Crear índice de ubicación.

API

Para crear un recurso de índice de ubicación mediante las API de Amazon Location

Use la operación de CreatePlaceIndex de las API de Amazon Location Places.

El siguiente ejemplo es una solicitud de API para crear un recurso de índice de sitios llamado ExamplePlaceIndexmediante el proveedor de datos Esri.

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

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

AWS CLI

Para crear un recurso de índice de ubicación mediante comandos de AWS CLI

Utilice el comando create-place-index.

En el siguiente ejemplo, se crea un recurso de índice de sitios denominado ExamplePlaceIndexcon Esri como proveedor de datos.

aws location \
  create-place-index \
  --data-source "Esri" \
  --description "Example place index" \
  --index-name "ExamplePlaceIndex" \
  --tags Tag1=Value1

nota

La facturación depende del uso. Puede incurrir en cargos por el uso de otros servicios de AWS . Para obtener más información, consulte los precios de Amazon Location Service.

Autenticación de sus solicitudes

Una vez que haya creado un recurso de índice de ubicación y esté listo para empezar a incorporar funciones de ubicación a su aplicación, elija cómo autenticaría sus solicitudes:

• Para explorar las formas en las que puede acceder a los servicios, consulte Cómo acceder a Amazon Location Service.

• Si tiene un sitio web con usuarios anónimos, puede utilizar claves de API o Amazon Cognito.

  Ejemplo

  En el siguiente ejemplo, se muestra el uso de una clave de API para la autorización, el JavaScriptSDK v3 de AWS y la ubicación Ayudantes de autenticación de 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);