Requisitos previos para calcular rutas con Amazon Location

En esta página se describen los requisitos previos para empezar a utilizar las funciones de rutas del servicio, que te 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 AWS cuenta 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. HERETecnologías: para obtener más información sobre HERE la cobertura en su región de interés, consulte la cobertura de rutas para HERE automóviles y la cobertura de rutas para HERE camiones.

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.

Puedes hacerlo mediante la consola de Amazon Location Service AWS CLI, la o Amazon LocationAPIs.

Console

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

1. Abre 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. Máximo 100 caracteres. 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 utilizando la ubicación de Amazon APIs

Usa la CreateRouteCalculator operación desde Amazon Location PlacesAPIs.

El siguiente ejemplo es una API solicitud para crear un recurso de calculadora de rutas llamado ExampleCalculator utilizando 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 comandos AWS CLI

Utilice el comando create-route-calculator.

En el siguiente ejemplo se crea un recurso de calculadora de rutas denominado ExampleCalculator utilización 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 API Keys o Amazon Cognito.

  Ejemplo

  En el siguiente ejemplo, se muestra el uso de una API clave de autorización, el uso de la AWS JavaScriptSDKversión 3 y la ubicación JavaScript Ayudante de autenticación de 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);