Una solicitud de matriz de rutas toma como entrada un array de waypoints 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 de destino, la API calculará cuatro rutas separadas.
La respuesta de la API contiene un array, en el que cada elemento corresponde a la ruta desde un punto de ruta de origen hasta un punto de ruta de destino. Por lo tanto, si especificas dos puntos de referencia de origen y dos de destino, el array de respuesta contendrá cuatro elementos, uno para cada ruta calculada.
Con la respuesta, puedes proporcionar a tus clientes diferentes opciones de rutas y, luego, permitir que el usuario seleccione la ruta adecuada para sus requisitos.
Acerca de las máscaras de campo
Cuando llamas 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 devueltos. Si omites esta lista, los métodos mostrarán un error.
En los ejemplos de este documento, se muestra el objeto de respuesta completo sin tener en cuenta las máscaras de campos. En un entorno de producción, tu respuesta solo incluiría los campos que especificas de forma explícita en la máscara de campo.
Para obtener más información, consulta Cómo elegir la información que se devolverá.
Acerca de la visualización de 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 ruta de origen y destino de entrada que se usan para calcular la ruta. Esto significa que el primer punto de partida y el primer punto de destino de la solicitud se encuentran 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 ruta de origen en el índice 1 del array de entrada y desde el punto de ruta de destino en el índice 0.
Para la siguiente ruta, haz lo siguiente:
"originIndex": 4, "destinationIndex": 1
La ruta se calculó desde el punto de ruta de origen en el índice 4 del array de entrada y desde el punto de ruta 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 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) } } … ]