RoutingSummary
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Durée et distance entre le point de départ du calcul d'itinéraire et un lieu dans la réponse, ainsi qu'une deuxième étape entre ce lieu et la destination, le cas échéant. Remarque:L'ajout de routingSummaries
dans le masque de champ sans inclure le paramètre routingParameters.origin
ou le paramètre searchAlongRouteParameters.polyline.encodedPolyline
dans la requête génère une erreur.
Représentation JSON |
{
"legs": [
{
object (Leg )
}
],
"directionsUri": string
} |
Champs |
legs[] |
object (Leg )
Les étapes du trajet. Lorsque vous calculez la durée et la distance du trajet à partir d'un point de départ défini, legs contient une seule section contenant la durée et la distance entre le point de départ et la destination. Lorsque vous effectuez une recherche sur un itinéraire, legs contient deux sections: une du point de départ au lieu et une du lieu à la destination.
|
directionsUri |
string
Lien permettant d'afficher un itinéraire dans Google Maps à l'aide des points de cheminement du récapitulatif d'itinéraire donné. Il n'est pas garanti que le parcours généré par ce lien soit identique à celui utilisé pour générer le résumé du parcours. Le lien utilise les informations fournies dans la requête, à partir de champs tels que routingParameters et searchAlongRouteParameters , le cas échéant, pour générer le lien vers les itinéraires.
|
Pied
Une étape correspond à une partie d'un trajet entre un point de départ et une destination.
Représentation JSON |
{
"duration": string,
"distanceMeters": integer
} |
Champs |
duration |
string (Duration format)
Temps nécessaire pour effectuer cette partie du trajet. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s ". Exemple : "3.5s"
|
distanceMeters |
integer
Distance de cette étape du trajet.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eRouting Summary provides the duration and distance between an origin and a destination, or between an origin, a place, and a destination when searching along a route.\u003c/p\u003e\n"],["\u003cp\u003eIt includes a directions URI for viewing the route on Google Maps.\u003c/p\u003e\n"],["\u003cp\u003eA Leg within the Routing Summary represents a portion of the journey, containing duration and distance in meters.\u003c/p\u003e\n"],["\u003cp\u003eWhen searching along a route, the \u003ccode\u003elegs\u003c/code\u003e field will contain two legs: one from the origin to the place and another from the place to the destination.\u003c/p\u003e\n"]]],["The content details routing summary data, including journey legs and a directions link. A routing summary contains \"legs,\" with each leg representing a portion of a journey. Each `leg` provides `duration` (time to complete the leg) and `distanceMeters`. The `directionsUri` field provides a Google Maps link for directions. When searching along a route, the summary includes two legs, otherwise it only includes one. Including `routingSummaries` in a request requires including an `origin` or `encodedPolyline` parameter.\n"],null,["# RoutingSummary\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [Leg](#Leg)\n - [JSON representation](#Leg.SCHEMA_REPRESENTATION)\n\nThe duration and distance from the routing origin to a place in the response, and a second leg from that place to the destination, if requested. **Note:** Adding `routingSummaries` in the field mask without also including either the `routingParameters.origin` parameter or the `searchAlongRouteParameters.polyline.encodedPolyline` parameter in the request causes an error.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"legs\": [ { object (/maps/documentation/places/web-service/reference/rest/v1/RoutingSummary#Leg) } ], \"directionsUri\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `legs[]` | `object (`[Leg](/maps/documentation/places/web-service/reference/rest/v1/RoutingSummary#Leg)`)` The legs of the trip. When you calculate travel duration and distance from a set origin, `legs` contains a single leg containing the duration and distance from the origin to the destination. When you do a search along route, `legs` contains two legs: one from the origin to place, and one from the place to the destination. |\n| `directionsUri` | `string` A link to show directions on Google Maps using the waypoints from the given routing summary. The route generated by this link is not guaranteed to be the same as the route used to generate the routing summary. The link uses information provided in the request, from fields including `routingParameters` and `searchAlongRouteParameters` when applicable, to generate the directions link. |\n\nLeg\n---\n\nA leg is a single portion of a journey from one location to another.\n\n| JSON representation |\n|-----------------------------------------------------------|\n| ``` { \"duration\": string, \"distanceMeters\": integer } ``` |\n\n| Fields ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `duration` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` The time it takes to complete this leg of the trip. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `distanceMeters` | `integer` The distance of this leg of the trip. |"]]