Cálculo de una ruta utilizando Amazon Location
Puede usar Amazon Location Service para calcular las rutas entre un origen y un destino, con hasta 23 puntos de referencia a lo largo de la ruta, para diferentes modos de transporte, puntos a evitar y condiciones del tráfico.
nota
Primero debe crear un recurso de calculadora de rutas y configurar la autenticación para sus solicitudes a Amazon Location. Para obtener más información, consulte Requisitos previos para calcular rutas utilizando Amazon Location.
Empiece a calcular las rutas
Envíe una solicitud sencilla mediante la operación CalculateRoute. Una solicitud simple contiene los siguientes campos obligatorios:
-
DeparturePosition: la posición inicial desde la que se calcula la ruta. Definido como[longitude, latitude] -
DestinationPosition: la posición final en la que se calculará la ruta. Definido como[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.
Si lo desea, puede especificar puntos de referencia, una hora de salida y un modo de viaje en su solicitud.
Puede usar la AWS CLI o las API de Amazon Location.
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 Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159], "DistanceUnit": "Miles" }
Establecer puntos de referencia
Al calcular una ruta, puede especificar hasta 23 puntos de escala intermedios entre la posición de salida y la posición de destino utilizando las posiciones de los puntos de referencia.
-
WaypointPositions: especifica una lista ordenada de posiciones intermedias para incluirlas a lo largo de una ruta entre la posición de salida y la posición de destino.nota
Si especifica una posición de punto de referencia que no se encuentra en una carretera, Amazon Location mueve la posición a la carretera más cercana.
La siguiente solicitud CalculateRoute calcula una ruta con 2 puntos de referencia:
-
La posición de salida es [-122.7565, 49.0021] y la posición de destino es [-122.3394, 47.6159].
-
Para el parámetro de solicitud
WaypointPositions:-
La primera posición de parada es [
-122.1884, 48.0936]. -
La primera posición de parada es [
-122.3493, 47.6205].
-
-
Para incluir la geometría de la cadena de líneas del tramo entre estos dos puntos de referencia, defina el siguiente parámetro opcional en
true:-
IncludeLegGeometry: incluye la geometría de cada ruta entre un par de posiciones de la respuesta.
-
POST /routes/v0/calculators/ExampleCalculator/calculate/route Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159], "WaypointPositions":[ [-122.1884,48.0936], [-122.3493,47.6205] ], "IncludeLegGeometry":true}
Ejemplo de respuesta
El siguiente es un ejemplo de solicitud con la respuesta correspondiente cuando se llama a la operación CalculateRoute desde la API Amazon Location Routes con el valor IncludeLegGeometry en true, que incluye la geometría de cadena de líneas de cada ruta entre un par de posiciones de la respuesta.
