Una solicitud de matriz de rutas toma como entrada un array de puntos de ruta de origen y destino. Luego, la API de Routes calcula la ruta desde cada punto de referencia de origen hasta cada punto de referencia de destino. Por ejemplo, si especificas dos puntos de referencia de origen y dos puntos de referencia de destino, la API calcula cuatro rutas independientes.
La respuesta de la API contiene un array, en el que cada elemento corresponde a la ruta de un punto de referencia de origen a un punto de referencia de destino. Por lo tanto, si especificas dos puntos de referencia de origen y dos puntos de referencia de destino, el array de respuestas contiene cuatro elementos, uno para cada ruta calculada.
Con la respuesta, puedes proporcionar a tus clientes diferentes opciones de ruta y, luego, permitir que el usuario seleccione la ruta adecuada para sus requisitos.
Acerca de las máscaras de campo
Cuando llames a un método para calcular una ruta, debes especificar una máscara de campo que defina qué campos deseas que se muestren en la respuesta. No hay una lista predeterminada de campos que se muestran. Si omites esta lista, los métodos mostrarán un error.
En los ejemplos de este documento, se muestra todo el objeto de respuesta sin tener en cuenta las máscaras de campo. En un entorno de producción, tu respuesta solo incluiría los campos que especifiques de forma explícita en la máscara de campo.
Para obtener más información, consulta Elige qué información mostrar.
Acerca de la visualización de los derechos de autor
Cuando muestres los resultados a los usuarios, debes incluir la siguiente declaración de derechos de autor:
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 origen y destino de entrada que se usan para calcular la ruta. Eso significa que el primer punto de referencia de origen y el primer punto de referencia de destino
en la solicitud están en el índice 0 del array.
Por ejemplo, una ruta en la respuesta contiene lo siguiente:
"originIndex": 1, "destinationIndex": 0
Estas propiedades indican que la ruta se calculó desde el punto de referencia de origen en el índice 1 del array de entrada y desde el punto de referencia de destino en el índice 0.
Para la siguiente ruta, haz lo siguiente:
"originIndex": 4, "destinationIndex": 1
La ruta se calculó a partir del punto de referencia de origen en el índice 4 del array de entrada y del punto de referencia de destino en el índice 1 del array de entrada.
Información acerca de la respuesta
El objeto JSON que representa la respuesta de la API contiene un array, en el que cada elemento del array define la ruta desde un punto de referencia de origen hasta un punto de referencia 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)
}
}
…
]