Requisitos previos para calcular rutas utilizando Amazon Location

En esta página se describen los requisitos previos para empezar a utilizar las características de enrutamiento del servicio, que le permiten calcular rutas y tiempos de viaje optimizados entre varias ubicaciones. Abarca temas esenciales, como la configuración de los permisos de acceso, la configuración de los recursos necesarios en su cuenta de AWS y cualquier dependencia o herramienta adicional que necesite en función de su caso de uso o entorno de desarrollo específicos.

Creación de un recurso de la calculadora de rutas

Para poder calcular una ruta, cree un recurso de la calculadora de rutas en su cuenta de AWS.

Al crear un recurso de calculadora de rutas, puede elegir entre los proveedores de datos disponibles:

1. Esri: para obtener información adicional sobre la cobertura de Esri en la región de su interés, consulte Información de Esri sobre la cobertura de redes de calle y tráfico.

2. HERE Technologies: para obtener información adicional sobre la cobertura de HERE en la región de su interés, consulte Cobertura de enrutamiento de automóviles de HERE y Cobertura de enrutamiento de camiones de HERE.

3. Grab: para obtener más información sobre la cobertura de Grab, consulte Países, regiones y áreas cubiertas.

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 de AWS para obtener más detalles.

Para ello, puede utilizar la consola de Amazon Location Service, la AWS CLI o las API de Amazon Location.

Console

Para crear un recurso de calculadora de rutas mediante la consola de ubicación de Amazon

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

2. En el panel de navegación izquierdo, elija Calculadoras de rutas.

3. Elija Crear calculadora de rutas.

4. Complete las casillas siguientes:

   • Nombre: introduzca un nombre para el recurso de calculadora de rutas. Por ejemplo, ExampleCalculator. 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 el caso de los proveedores de datos, elija un proveedor de datos para usarlo como calculadora de rutas.

6. (Opcional) En Etiquetas, escriba una clave y un valor de etiqueta. Esto añade una etiqueta a su nuevo recurso de calculadora de rutas. Para obtener más información, consulte Etiquetado de los recursos.

7. Elija Crear calculadora de rutas.

API

Para crear un recurso de calculadora de rutas mediante las API de Amazon Location

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

El siguiente ejemplo es una solicitud de API para crear un recurso de calculadora de rutas denominado ExampleCalculator con el proveedor de datos Esri.

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

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

AWS CLI

Para crear un recurso de la calculadora de rutas utilizando comandosAWS CLI

Utilice el comando create-route-calculator.

En el siguiente ejemplo, se crea un recurso de calculadora de rutas denominado ExampleCalculator usando Esri como proveedor de datos.

aws location \
  create-route-calculator \
  --calculator-name "ExampleCalculator" \
  --data-source "Esri" \
  --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 calculadora de rutas y esté listo para empezar a incorporar funciones de localización en 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

  El siguiente ejemplo muestra el uso de una clave API para la autorización, utilizando AWS JavaScript SDK v3, y Amazon Location Ayudante de autenticación de JavaScript.

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