Une requête de matrice d'itinéraires prend comme entrée un tableau de points de cheminement de départ et de destination. L'API Routes calcule ensuite l'itinéraire de chaque point de cheminement de départ à chaque point de cheminement de destination. Par exemple, si vous spécifiez deux points de cheminement de départ et deux points de cheminement de destination, l'API calcule quatre itinéraires distincts.
La réponse de l'API contient un tableau, où chaque élément correspond à l'itinéraire d'un point de cheminement de départ à un point de cheminement de destination. Par conséquent, si vous spécifiez deux points de cheminement de départ et deux points de cheminement de destination, le tableau de réponse contient quatre éléments, un pour chaque itinéraire calculé.
À l'aide de la réponse, vous pouvez proposer différentes options d'itinéraire à vos clients, puis laisser 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 masque de champ qui définit les champs que vous souhaitez renvoyer dans la réponse. Il n'existe pas de liste par défaut de champs renvoyés. Si vous omettez cette liste, les méthodes renvoient une erreur.
Les exemples de ce document montrent l'objet de réponse complet sans tenir compte des masques de champ. Dans un environnement de production, votre réponse n'inclurait 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 affichez les résultats à vos utilisateurs :
Powered by Google, ©YEAR Google
Exemple :
Powered by Google, ©2023 Google
Identifier l'itinéraire dans la réponse
Utilisez les propriétés de réponse originIndex et destinationIndex pour identifier chaque itinéraire dans la réponse. Ces propriétés contiennent l'index à base zéro des points de cheminement de départ et de destination utilisés pour calculer l'itinéraire. Cela signifie que le premier point de cheminement de départ et le premier point de cheminement de destination de la requête se trouvent à l'index 0 du tableau.
Par exemple, un itinéraire 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 cheminement de départ à l'index 1 du 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 de départ à l'index 4 du tableau d'entrée et à partir du point de cheminement de destination à l'index 1 du tableau d'entrée.
À propos des informations d'itinéraire dans la réponse
La réponse de l'API contient un tableau, où chaque élément définit l'itinéraire d'un point de cheminement de départ à un point de cheminement de destination. Ces éléments sont
RouteMatrixElements
dans la méthode gRPC ou le
corps de la réponse dans
la réponse HTTP.
Outre les propriétés originIndex et destinationIndex, chaque élément ne contient que des informations de base spécifiques à cet itinéraire, telles que distanceMeters, duration et travelAdvisory. Pour obtenir des informations plus détaillées sur un itinéraire, comme une polyligne, utilisez computeRoutes.
La réponse se présente comme suit :
[ // 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) } } … ]