Planificación de rutas con una matriz de rutas en Amazon Location - Amazon Location Service

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Planificación de rutas con una matriz de rutas en Amazon Location

Puede utilizar Amazon Location Service para crear entradas para su software de planificación y optimización de rutas. Puede crear resultados de ruta, incluidos el tiempo y la distancia de viaje, para las rutas entre un conjunto de posiciones de salida y un conjunto de posiciones de destino.

Por ejemplo, dadas las posiciones de salida A y B y las posiciones de destino X e Y, Amazon Location Service mostrará el tiempo y la distancia de viaje para las rutas de A a X, A a Y, B a X y B a Y.

Puede calcular las rutas con diferentes modos de transporte, evasiones y condiciones del tráfico. Por ejemplo, puede especificar que el vehículo es un camión de 15 metros de largo y la ruta calculada utilizará esas restricciones para determinar el tiempo y la distancia de viaje.

El número de resultados mostrados (y de rutas calculadas) es el número de posiciones de salida multiplicado por el número de posiciones de destino. Se le cobrará por cada ruta calculada, no por cada solicitud al servicio, por lo que una matriz de rutas con 10 salidas y 10 destinos se facturará como 100 rutas.

Calcular una matriz de rutas

Puede calcular una matriz de rutas entre un conjunto de posiciones de salida y un conjunto de posiciones de destino. Los resultados de la ruta incluirán el tiempo de viaje y la distancia de viaje.

Requisito previo

Envíe una solicitud mediante la operación CalculateRouteMatrix. Una solicitud simple contiene los siguientes campos obligatorios:

  • DeparturePositions: el conjunto de posiciones de partida de las cuales calcular las rutas. Definido como una matriz de [longitude, latitude]

  • DestinationPositions: el conjunto de posiciones de destino de las cuales calcular las rutas. Definido como una matriz de [longitude, latitude].

nota

Si especifica una posición de salida o destino que no se encuentra en una carretera, Amazon Location mueve la posición a la carretera más cercana.

Opcionalmente, puede especificar una hora de salida y un modo de viaje en su solicitud.

Puedes usar la ubicación AWS CLI o la de AmazonAPIs.

API

El siguiente ejemplo es una CalculateRouteMatrix solicitud que utiliza el recurso de la calculadora de rutas ExampleCalculator. La solicitud especifica el cálculo de la matriz de rutas desde las posiciones de salida [-122.7565, 49.0021 ] y [-122.2014, 47.6101] a las posiciones de destino [-122.3394, 47.6159 ] y [-122.4813, 48.7511].

POST /routes/v0/calculators/ExampleCalculator/calculate/route-matrix Content-type: application/json { "DeparturePositions": [ [-122.7565,49.0021], [-122.2014,47.6101] ], "DestinationPositions": [ [-122.3394, 47.6159], [-122.4813,48.7511] ] }
AWS CLI

El siguiente ejemplo es un calculate-route-matrix comando que utiliza el recurso de calculadora de rutas ExampleCalculator. La solicitud especifica el cálculo de la matriz de rutas desde las posiciones de salida [-122.7565, 49.0021 ] y [-122.2014, 47.6101] a las posiciones de destino [-122.3394, 47.6159 ] y [-122.4813, 48.7511].

aws location \ calculate-route-matrix \ --calculator-name ExampleCalculator \ --departure-positions "[[-122.7565,49.0021],[-122.2014,47.6101]]" \ --destination-positions "[[-122.3394,47.6159],[-122.4813,48.7511]]"

De forma predeterminada, la respuesta muestra Distance en kilómetros. Puede cambiar la unidad de medida a millas mediante el siguiente parámetro opcional:

  • DistanceUnit: especifica el sistema de unidades que se utilizará para los resultados de distancia.

POST /routes/v0/calculators/ExampleCalculator/calculate/route-matrix Content-type: application/json { "DeparturePositions": [ [-122.7565,49.0021], [-122.2014,47.6101] ], "DestinationPositions": [ [-122.3394, 47.6159], [-122.4813,48.7511] ], "DistanceUnit": "Miles" }

Restricciones en las posiciones de salida y destino

Al calcular una matriz de rutas, existen restricciones en las posiciones de salida y destino. Estas restricciones varían según el proveedor utilizado por el recurso RouteCalculator.

Limitación Esri Grab HERE
Número de posiciones Hasta 10 posiciones de salida y 10 posiciones de destino. Hasta 350 posiciones de salida y 350 posiciones de destino.

Hasta 350 posiciones de salida y 350 posiciones de destino.

Para rutas más largas, se aplican restricciones adicionales. Consulte la sección.

Distancia entre posiciones Cualquier par de posiciones de salida y destino deben estar a menos de 400 km una de la otra (40 km para las rutas de senderismo).

Todas las posiciones de salida y destino deben estar dentro de un círculo de 180 km de diámetro.

Para rutas más largas, se aplican restricciones adicionales. Consulte la sección.

Longitud de la ruta Las rutas no se completarán si el tiempo total de viaje de la ruta es superior a 400 minutos.

No se calcularán las rutas que se desvíen más de 10 km fuera de un círculo alrededor de los puntos de salida y destino.

Para rutas más largas, se aplican restricciones adicionales. Consulte la sección.

Regiones En Corea no se admite el cálculo de una matriz de rutas. Disponible en el sudeste asiático. Para obtener una lista de los países o regiones compatibles y más información, consulte Países, regiones y áreas cubiertas. Sin restricciones adicionales.

Planificación de rutas más larga

Calcular una matriz de resultados de rutas es útil para una planificación eficiente de la ruta, pero el cálculo puede llevar algún tiempo. Todos los proveedores de datos de Amazon Location Service limitan el número de rutas o la distancia de las rutas que se pueden calcular. Por ejemplo, HERE permite crear rutas entre 350 posiciones de salida y destino, pero esas posiciones deben estar dentro de un círculo de 180 km. ¿Qué hacer si quiere planificar rutas más largas?

Puede calcular una matriz de rutas con longitudes no restringidas para un número menor de rutas utilizando a RouteCalculator with HERE como proveedor de datos. Esto no cambia la forma en que llamas a la sucursal de Amazon CalculateRouteMatrixAPI, simplemente permite rutas más largas si cumples con los requisitos.

Los requisitos para calcular rutas de mayor longitud son:

  • RouteCalculatorDeben usar el proveedor HERE de datos.

  • El número de posiciones de salida no debe ser superior a 15.

  • El número total de rutas a calcular no debe ser superior a 100.

  • No se permiten rutas de larga distancia para camiones que eviten peajes cuando las rutas superen los 1000 km. Esta combinación es más lenta de calcular y puede provocar que se agote el tiempo de espera de la llamada. Puede calcular estas rutas de forma individual con la CalculateRouteoperación.

Si su llamada no cumple estos requisitos (por ejemplo, solicita 150 cálculos de rutas en una sola llamada), CalculateRouteMatrix volverá a permitir solo las reglas de ruta más cortas. A continuación, podrá calcular las rutas, siempre que las posiciones estén dentro de un círculo de 180 km.

Al calcular rutas más largas, tenga en cuenta lo siguiente:

  • Las rutas más largas pueden tardar más en calcularse, incluso más que el tiempo máximo para Amazon LocationAPIs. Si tiene tiempos de espera frecuentes con rutas específicas, puede probar con un número menor de rutas en cada destino de llamada a CalculateRouteMatrix.

  • Si añade más puntos de destino o de salida a su solicitud CalculateRouteMatrix, la operación puede cambiar al modo más restringido y puede obtener un error para una ruta que se puede calcular sin problemas cuando hay menos rutas que crear. En este caso, reduzca el número de posiciones de destino o salida y realice varias solicitudes para obtener el conjunto completo de cálculos de rutas que necesita.

Ejemplo de respuesta

El siguiente es un ejemplo de solicitud con la respuesta correspondiente cuando se llama a la CalculateRouteMatrix operación desde Amazon Location RoutesAPI.

Example request
POST /routes/v0/calculators/ExampleCalculator/calculate/route-matrix Content-type: application/json { "DeparturePositions": [ [-122.7565,49.0021], [-122.2014,47.6101] ], "DestinationPositions": [ [-122.3394, 47.6159], [-122.4813,48.7511] ] }
Example response
{ "RouteMatrix": [ [ { "Distance": 178.764, "DurationSeconds": 7565 }, { "Distance": 39.795, "DurationSeconds": 1955 } ], [ { "Distance": 15.31, "DurationSeconds": 1217 }, { "Distance": 142.506, "DurationSeconds": 6279 } ] ], "Summary": { "DataSource": "Here", "RouteCount": 4, "ErrorCount": 0, "DistanceUnit": "Kilometers" } }