Une requête de matrice de routes utilise en entrée un tableau de points de départ et de destination des points de cheminement. L'API Routes calcule ensuite l'itinéraire à partir de chaque point de départ point de cheminement vers chaque point de cheminement de destination. Par exemple, si vous spécifiez deux origines et deux points de cheminement de destination, l'API calcule quatre points routes.
La réponse de l'API contient un tableau, où chaque élément de tableau correspond au d'un point de cheminement d'origine à un point de cheminement de destination. Par conséquent, si vous spécifie deux points de cheminement d'origine et deux points de cheminement de destination, le tableau de réponse contient quatre éléments, un pour chaque itinéraire calculé.
La réponse vous permet de proposer différentes options d'itinéraire à vos clients. puis laissez l'utilisateur sélectionner l'itinéraire adapté à ses besoins.
À propos des masques de champ
Lorsque vous appelez une méthode pour calculer un itinéraire, vous devez spécifier un champ qui définit les champs à renvoyer dans la réponse. Il n'y a aucun liste par défaut des champs renvoyés. Si vous omettez cette liste, les méthodes renvoient une .
Les exemples de ce document montrent l'intégralité de l'objet de réponse de masques de champ. Dans un environnement de production, votre réponse serait n'incluez que les champs que vous spécifiez explicitement dans le masque de champ.
Pour en savoir plus, consultez Choisir les informations à renvoyer.
À propos de l'affichage des droits d'auteur
Vous devez inclure la déclaration de droits d'auteur suivante lorsque vous présentez les résultats à vos utilisateurs:
Powered by Google, ©YEAR Google
Exemple :
Powered by Google, ©2023 Google
Identifier la route dans la réponse
Utilisez les propriétés de réponse originIndex et destinationIndex pour identifier
chaque route dans la réponse. Ces propriétés contiennent l'index basé sur zéro de
Les points de cheminement origin et destination d'entrée utilisés pour calculer le
via un routage réseau. Cela signifie que le premier point de cheminement d'origine et le premier point de cheminement de destination
de la requête correspondent à l'index de tableau 0.
Par exemple, une route dans la réponse contient:
"originIndex": 1, "destinationIndex": 0
Ces propriétés indiquent que l'itinéraire a été calculé à partir du point de départ point de cheminement à l'indice 1 dans le tableau d'entrée et à partir du point de cheminement de destination à l'index 0.
Pour l'itinéraire suivant:
"originIndex": 4, "destinationIndex": 1
L'itinéraire a été calculé à partir du point de cheminement d'origine (index 4) dans l'entrée et à partir du point de cheminement de destination au niveau de l'index 1 du tableau d'entrée.
À propos de la réponse
La Objet JSON représentant la réponse de l'API contient un tableau, où chaque élément de tableau définit l'itinéraire d'un point de cheminement de départ à un point de cheminement de destination.
Avec les propriétés originIndex et destinationIndex, chaque itinéraire
contient des informations spécifiques à cet itinéraire, telles que distanceMeters,
duration et travelAdvisory.
La réponse se présente sous la forme suivante:
[ // 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) } } … ]