Una solicitud de matriz de rutas toma como entrada un array de puntos de referencia 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 independientes.
La respuesta de la API contiene un array, en el que cada elemento corresponde a la ruta desde un punto de referencia de origen hasta un punto de referencia 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 proporcionarles 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 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 que se devuelven. Si omites esta lista, los métodos devuelven 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 tus 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 referencia de origen y destino de entrada que se usan para calcular la ruta. Esto significa que el primer punto de referencia de origen y el primer punto de referencia de destino
en 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 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:
"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.
Acerca de la información de la ruta en la respuesta
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. Estos elementos son
RouteMatrixElements
en el método gRPC o el
cuerpo de la respuesta en
la respuesta HTTP.
Junto con las propiedades originIndex y destinationIndex, cada elemento contiene solo información básica específica de esa ruta, como distanceMeters, duration y travelAdvisory. Para obtener información más detallada
sobre una ruta, como una polilínea, usa computeRoutes.
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) } } … ]