Una solicitud de matriz de ruta toma como entrada un array de origen y destino y puntos de referencia. Luego, la API de Routes calcula la ruta a partir de cada origen de referencia a cada punto de referencia de destino. Por ejemplo, si especificas dos valores de de referencia y dos puntos de referencia de destino, la API calcula cuatro puntos rutas.
La respuesta de la API contiene un array, en el que cada elemento de array corresponde al ruta desde un punto de referencia de origen hasta uno de destino. Por lo tanto, si especificar dos puntos de referencia de origen y dos puntos de referencia de destino; el conjunto de respuestas contiene cuatro elementos, uno para cada ruta calculada.
Con la respuesta, puedes proporcionar a tus clientes diferentes opciones de ruta. y, luego, dejar que el usuario seleccione la ruta adecuada para sus requisitos.
Acerca de las máscaras de campo
Cuando llamas a un método para procesar una ruta, debes especificar un campo que define qué campos quieres que se devuelvan en la respuesta. No hay la lista predeterminada de los campos que se muestran. Si omites esta lista, los métodos muestran un .
Los ejemplos de este documento muestran todo el objeto de respuesta sin tomar las máscaras de campo en mente. En un entorno de producción, tu respuesta solo incluya los campos que especifique explícitamente en la máscara de campo.
Para obtener más información, consulta el artículo Elige la información que deseas mostrar.
Información acerca de la visualización de los derechos de autor
Debes incluir la siguiente declaración de derechos de autor cuando muestres los resultados a tus usuarios:
Powered by Google, ©YEAR Google
Por ejemplo:
Powered by Google, ©2023 Google
Identifica la ruta en la respuesta
Usa las propiedades de respuesta originIndex
y destinationIndex
para identificar
cada ruta en la respuesta. Estas propiedades contienen el índice basado en cero de
los puntos de referencia origin y destination de entrada utilizados para calcular el
ruta. Es decir, el primer punto de referencia de origen y el primer punto de referencia de destino
de la solicitud están en el índice de array 0.
Por ejemplo, una ruta en la respuesta contiene lo siguiente:
"originIndex": 1, "destinationIndex": 0
Estas propiedades indican que la ruta se calculó a partir del origen punto de referencia en el índice 1 de la matriz de entrada, y desde el punto de referencia de destino en índice 0.
Para la siguiente ruta:
"originIndex": 4, "destinationIndex": 1
La ruta se calculó desde el punto de referencia de origen en el índice 4 de la y desde el punto de referencia de destino en el índice 1 del array de entrada.
Acerca de la respuesta
El Objeto JSON que representa la respuesta de la API contiene un array, en el que cada elemento define la ruta desde un punto de referencia de origen hasta uno de destino.
Junto con las propiedades originIndex
y destinationIndex
, cada ruta
contiene información específica de esa ruta, como distanceMeters
,
duration
y travelAdvisory
.
La respuesta tiene el siguiente formato:
[ // One array element for each combination of origin and destination waypoints. { // The route for source waypoint 0 and destination waypoint 0. "originIndex": 0, "destinationIndex": 0, "status": { object (Status) }, "condition": enum (RouteMatrixElementCondition), "distanceMeters": integer, "duration": string, "staticDuration": string, "travelAdvisory": { object (RouteTravelAdvisory) }, "fallbackInfo": { object (FallbackInfo) } } { // The route for source waypoint 0 and destination waypoint 1. "originIndex": 0, "destinationIndex": 1, "status": { object (Status) }, "condition": enum (RouteMatrixElementCondition), "distanceMeters": integer, "duration": string, "staticDuration": string, "travelAdvisory": { object (RouteTravelAdvisory) }, "fallbackInfo": { object (FallbackInfo) } } … ]