- Requête HTTP
- Corps de la requête
- Corps de la réponse
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Route
- RouteLabel
- RouteLeg
- Polyline
- RouteLegStep
- NavigationInstruction
- Maneuver
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Fenêtre d'affichage
- RouteLocalizedValues
- PolylineDetails
- TunnelInfo
- RoadFeatureState
- PolylinePointIndex
- RestrictionInfo
- FlyoverInfo
- NarrowRoadInfo
- BridgeInfo
- SkywayInfo
- GeocodingResults
- GeocodedWaypoint
Renvoie l'itinéraire principal ainsi que d'autres itinéraires facultatifs, en fonction d'un ensemble de points de cheminement terminaux et intermédiaires.
REMARQUE : Cette méthode nécessite que vous spécifiiez un masque de champ de réponse dans l'entrée. Vous pouvez fournir le masque de champ de réponse à l'aide du paramètre d'URL $fields ou fields, ou à l'aide d'un en-tête HTTP/gRPC X-Goog-FieldMask (consultez les paramètres d'URL et en-têtes disponibles). La valeur est une liste de chemins d'accès aux champs séparés par une virgule. Consultez la documentation détaillée sur la construction des chemins d'accès aux champs.
Par exemple, dans cette méthode :
- Masque de champ de tous les champs disponibles (pour une inspection manuelle) :
X-Goog-FieldMask: * - Masque de champ de la durée, de la distance et de la polyligne au niveau de l'itinéraire (exemple de configuration de production) :
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google déconseille d'utiliser le masque de champ de réponse générique (*) ou de spécifier le masque de champ au niveau supérieur (routes) pour les raisons suivantes :
- En ne sélectionnant que les champs dont vous avez besoin, vous aidez notre serveur à économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
- En ne sélectionnant que les champs dont vous avez besoin dans votre job de production, vous garantissez des performances de latence stables. Nous pourrons être amenés à ajouter d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs au niveau supérieur, vous risquez de constater une dégradation des performances, car tout nouveau champ que nous ajouterons sera automatiquement inclus dans la réponse.
- En ne sélectionnant que les champs dont vous avez besoin, vous obtenez une réponse de plus petite taille, et donc un débit réseau plus élevé.
Requête HTTP
POST https://routes.googleapis.com/directions/v2:computeRoutes
L'URL utilise la syntaxe de transcodage gRPC.
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Représentation JSON |
|---|
{ "origin": { object ( |
| Champs | |
|---|---|
origin |
Obligatoire. Point de cheminement de départ. |
destination |
Obligatoire. Point de cheminement de destination. |
intermediates[] |
Facultatif. Ensemble de points de cheminement le long de l'itinéraire (à l'exclusion des points de terminaison), pour s'arrêter ou passer. Vous pouvez ajouter jusqu'à 25 points de cheminement intermédiaires. |
travelMode |
Facultatif. Spécifie le mode de transport. |
routingPreference |
Facultatif. Spécifie comment calculer l'itinéraire. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer l'itinéraire. Si la préférence de routage entraîne une erreur ou une latence très longue, une erreur est renvoyée. Vous ne pouvez spécifier cette option que si |
polylineQuality |
Facultatif. Spécifie votre préférence pour la qualité de la polyligne. |
polylineEncoding |
Facultatif. Spécifie l'encodage préféré pour la polyligne. |
departureTime |
Facultatif. Heure de départ. Si vous ne définissez pas cette valeur, elle est définie par défaut sur l'heure à laquelle vous avez effectué la requête. REMARQUE : Vous ne pouvez spécifier une valeur Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
arrivalTime |
Facultatif. Heure d'arrivée. REMARQUE : Ce champ est ignoré lorsque les requêtes spécifient un Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
computeAlternativeRoutes |
Facultatif. Indique s'il faut calculer des itinéraires bis en plus de l'itinéraire. Aucun itinéraire alternatif n'est renvoyé pour les requêtes comportant des points de cheminement intermédiaires. |
routeModifiers |
Facultatif. Ensemble de conditions à remplir qui affectent le calcul des itinéraires. |
languageCode |
Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez Unicode Locale Identifier. Consultez la section Langues acceptées pour obtenir la liste des langues compatibles. Si vous ne fournissez pas cette valeur, la langue d'affichage est déduite de l'emplacement de la demande d'itinéraire. |
regionCode |
Facultatif. Code régional, spécifié sous la forme d'une valeur ccTLD (domaine de premier niveau) à deux caractères. Pour en savoir plus, consultez Domaines nationaux de premier niveau. |
units |
Facultatif. Spécifie les unités de mesure des champs d'affichage. Ces champs incluent le champ |
optimizeWaypointOrder |
Facultatif. Si ce champ est défini sur "true", le service tente de minimiser le coût global de l'itinéraire en réorganisant les points de cheminement intermédiaires spécifiés. La requête échoue si l'un des points de cheminement intermédiaires est un point de cheminement |
requestedReferenceRoutes[] |
Facultatif. Spécifie les itinéraires de référence à calculer dans le cadre de la requête, en plus de l'itinéraire par défaut. Un itinéraire de référence est un itinéraire dont l'objectif de calcul est différent de celui de l'itinéraire par défaut. Par exemple, le calcul d'un itinéraire de référence |
extraComputations[] |
Facultatif. Liste des calculs supplémentaires pouvant être utilisés pour répondre à la requête. Remarque : Ces calculs supplémentaires peuvent renvoyer des champs supplémentaires dans la réponse. Ces champs supplémentaires doivent également être spécifiés dans le masque de champ pour être renvoyés dans la réponse. |
trafficModel |
Facultatif. Spécifie les hypothèses à utiliser pour calculer le temps de trajet. Ce paramètre influe sur la valeur renvoyée dans le champ "duration" de |
transitPreferences |
Facultatif. Spécifie les préférences qui influencent l'itinéraire renvoyé pour les itinéraires |
Corps de la réponse
v2.computeRoutes le message de réponse.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
|---|
{ "routes": [ { object ( |
| Champs | |
|---|---|
routes[] |
Contient un tableau d'itinéraires calculés (jusqu'à trois) lorsque vous spécifiez |
fallbackInfo |
Dans certains cas, lorsque le serveur ne peut pas calculer les résultats de l'itinéraire avec toutes les préférences d'entrée, il peut utiliser une autre méthode de calcul. Lorsque le mode de remplacement est utilisé, ce champ contient des informations détaillées sur la réponse de remplacement. Sinon, ce champ n'est pas défini. |
geocodingResults |
Contient des informations de réponse de géocodage pour les points de cheminement spécifiés en tant qu'adresses. |
PolylineQuality
Ensemble de valeurs qui spécifient la qualité de la polyligne.
| Enums | |
|---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Aucune préférence de qualité de polyligne spécifiée. La valeur par défaut est OVERVIEW. |
HIGH_QUALITY |
Spécifie une polyligne de haute qualité, composée de plus de points que OVERVIEW, au détriment d'une taille de réponse plus importante. Utilisez cette valeur lorsque vous avez besoin de plus de précision. |
OVERVIEW |
Spécifie une polyligne de présentation, composée d'un petit nombre de points. Utilisez cette valeur lorsque vous affichez un aperçu de l'itinéraire. Cette option offre une latence de requête inférieure à celle de l'option HIGH_QUALITY. |
PolylineEncoding
Spécifie le type de polyligne à renvoyer.
| Enums | |
|---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Aucune préférence de type de polyligne n'a été spécifiée. La valeur par défaut est ENCODED_POLYLINE. |
ENCODED_POLYLINE |
Spécifie une polyligne encodée à l'aide de l'algorithme d'encodage de polyligne. |
GEO_JSON_LINESTRING |
Spécifie une polyligne au format GeoJSON LineString. |
ReferenceRoute
Un itinéraire de référence compatible sur ComputeRoutesRequest.
| Enums | |
|---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Non utilisé. Les requêtes contenant cette valeur échouent. |
FUEL_EFFICIENT |
Itinéraire économe en carburant. |
SHORTER_DISTANCE |
Itinéraire avec une distance de trajet plus courte. Cette fonctionnalité est expérimentale. Pour les requêtes Pour les requêtes Cette fonctionnalité n'est pas compatible avec d'autres modes de transport, via des points de cheminement intermédiaires ou |
ExtraComputation
Calculs supplémentaires à effectuer lors de l'exécution de la requête. D'autres valeurs pourront être ajoutées à l'avenir.
| Enums | |
|---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Non utilisé. Les requêtes contenant cette valeur échoueront. |
TOLLS |
Informations sur les péages pour le ou les itinéraires. |
FUEL_CONSUMPTION |
Estimation de la consommation de carburant pour le ou les itinéraires. |
TRAFFIC_ON_POLYLINE |
Polylignes prenant en compte le trafic pour le ou les itinéraires. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstruction présenté sous la forme d'une chaîne de texte HTML formatée. Ce contenu est destiné à être lu tel quel. Il est uniquement destiné à l'affichage. Ne l'analysez pas de manière programmatique. |
FLYOVER_INFO_ON_POLYLINE |
Informations sur les survols pour le ou les itinéraires. Le masque de champ routes.polyline_details.flyover_info doit être spécifié pour renvoyer ces informations. Ces données ne seront actuellement renseignées que pour certaines agglomérations en Inde. Cette fonctionnalité est expérimentale, et le SKU/les frais sont susceptibles d'être modifiés. |
NARROW_ROAD_INFO_ON_POLYLINE |
Informations sur les routes étroites pour le ou les itinéraires. Le masque de champ routes.polyline_details.narrow_road_info doit être spécifié pour renvoyer ces informations. Ces données ne seront actuellement renseignées que pour certaines agglomérations en Inde. Cette fonctionnalité est expérimentale, et le SKU/les frais sont susceptibles d'être modifiés. |
TUNNEL_INFO_ON_POLYLINE |
Informations sur les tunnels pour le ou les itinéraires. Le masque de champ routes.polyline_details.tunnel_info doit être spécifié pour renvoyer ces informations. |
BRIDGE_INFO_ON_POLYLINE |
Informations sur les ponts pour le ou les itinéraires. Le masque de champ routes.polyline_details.bridge_info doit être spécifié pour renvoyer ces informations. |
SKYWAY_INFO_ON_POLYLINE |
Informations sur les passerelles pour le ou les itinéraires. Le masque de champ routes.polyline_details.skyway_info doit être spécifié pour renvoyer ces informations. |
Route
Contient un itinéraire, qui se compose d'une série de segments de route connectés qui relient les points de cheminement de départ, d'arrivée et intermédiaires.
| Représentation JSON |
|---|
{ "routeLabels": [ enum ( |
| Champs | |
|---|---|
routeLabels[] |
Étiquettes de l'objet |
legs[] |
Ensemble d'étapes (segments de chemin entre des points de cheminement) qui composent l'itinéraire. Chaque section correspond au trajet entre deux |
distanceMeters |
Distance de l'itinéraire, en mètres. |
duration |
Durée nécessaire pour parcourir l'itinéraire. Si vous définissez Lorsque
Dans tous les autres cas, les vitesses des véhicules de tourisme sont utilisées, même si d'autres dimensions ou poids de véhicule sont spécifiés dans Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
staticDuration |
Durée du trajet sans tenir compte des conditions de circulation. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
polyline |
La polyligne de l'itinéraire global. Cette polyligne est la polyligne combinée de tous les |
description |
Description de l'itinéraire. |
warnings[] |
Tableau d'avertissements à afficher lors de l'affichage de l'itinéraire. |
viewport |
Cadre de délimitation de la fenêtre d'affichage de la polyligne. |
travelAdvisory |
Informations supplémentaires sur l'itinéraire. |
optimizedIntermediateWaypointIndex[] |
Si vous définissez |
localizedValues |
Représentations textuelles des propriétés de |
routeToken |
Jeton opaque pouvant être transmis au SDK Navigation pour reconstruire l'itinéraire pendant la navigation et, en cas de changement d'itinéraire, respecter l'intention d'origine lors de la création de l'itinéraire. Traitez ce jeton comme un blob opaque. Ne comparez pas sa valeur entre les requêtes, car elle peut changer même si le service renvoie exactement le même itinéraire. REMARQUE : |
polylineDetails |
Contient des informations sur les détails le long de la polyligne. |
RouteLabel
Étiquettes de l'objet , utiles pour identifier des propriétés spécifiques de l'itinéraire à comparer à d'autres.Route
| Enums | |
|---|---|
ROUTE_LABEL_UNSPECIFIED |
Valeur par défaut, non utilisée. |
DEFAULT_ROUTE |
"Meilleur" itinéraire par défaut renvoyé pour le calcul de l'itinéraire. |
DEFAULT_ROUTE_ALTERNATE |
Alternative au "meilleur" itinéraire par défaut. Les itinéraires de ce type sont renvoyés lorsque est spécifié. |
FUEL_EFFICIENT |
Itinéraire économe en carburant. Les itinéraires associés à cette valeur sont optimisés pour les paramètres écologiques tels que la consommation de carburant. |
SHORTER_DISTANCE |
Itinéraire plus court. Cette fonctionnalité est expérimentale. |
RouteLeg
Contient un segment entre des points de cheminement non-via.
| Représentation JSON |
|---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
| Champs | |
|---|---|
distanceMeters |
Distance de l'étape de l'itinéraire, en mètres. |
duration |
Durée nécessaire pour parcourir l'étape. Si Lorsque
Dans tous les autres cas, les vitesses des véhicules de tourisme sont utilisées, même si d'autres dimensions ou poids de véhicule sont spécifiés dans Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
staticDuration |
Durée du trajet sur l'étape, calculée sans tenir compte des conditions de circulation. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
polyline |
Polyligne globale de cette étape, qui inclut la polyligne de chaque |
startLocation |
Lieu de départ de cette étape. Cet emplacement peut être différent de l'emplacement |
endLocation |
Emplacement de fin de cette étape. Cet emplacement peut être différent de l'emplacement |
steps[] |
Tableau d'étapes indiquant les segments de cette étape. Chaque étape représente une instruction de navigation. |
travelAdvisory |
Contient les informations supplémentaires dont l'utilisateur doit être informé, telles que les restrictions possibles de la zone de circulation, sur une étape de l'itinéraire. |
localizedValues |
Représentations textuelles des propriétés de |
stepsOverview |
Présentation des étapes de ce |
Polyline
Encapsule une polyligne encodée.
| Représentation JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "encodedPolyline": string, "geoJsonLinestring": { object } // End of mutually exclusive fields. } |
| Champs | |
|---|---|
| Encapsule le type de polyligne. La valeur par défaut est "encoded_polyline". Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse : | |
encodedPolyline |
Encodage de chaîne de la polyligne à l'aide de l'algorithme d'encodage de polyligne |
geoJsonLinestring |
Spécifie une polyligne au format LineString GeoJSON. |
| Fin des champs mutuellement exclusifs. | |
RouteLegStep
Contient un segment d'un . Une étape correspond à une instruction de navigation unique. Les étapes d'un itinéraire sont composées de segments.RouteLeg
| Représentation JSON |
|---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
| Champs | |
|---|---|
distanceMeters |
Distance de trajet de cette étape, en mètres. Dans certains cas, ce champ peut ne pas avoir de valeur. |
staticDuration |
Durée du trajet pour cette étape, sans tenir compte des conditions de circulation. Dans certains cas, ce champ peut ne pas avoir de valeur. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
polyline |
Polyligne associée à cette étape. |
startLocation |
Emplacement de départ de cette étape. |
endLocation |
Emplacement de fin de cette étape. |
navigationInstruction |
Instructions de navigation. |
travelAdvisory |
Contient les informations supplémentaires dont l'utilisateur doit être informé, telles que les restrictions possibles de la zone de circulation, sur une étape d'un segment. |
localizedValues |
Représentations textuelles des propriétés de |
transitDetails |
Informations relatives à cette étape si le mode de transport est |
travelMode |
Mode de transport utilisé pour cette étape. |
Manoeuvre
Ensemble de valeurs qui spécifient l'action de navigation à effectuer pour l'étape actuelle (par exemple, tourner à gauche, s'insérer ou continuer tout droit).
| Enums | |
|---|---|
MANEUVER_UNSPECIFIED |
Non utilisé. |
TURN_SLIGHT_LEFT |
Tournez légèrement vers la gauche. |
TURN_SHARP_LEFT |
Tournez brusquement à gauche. |
UTURN_LEFT |
Faites demi-tour à gauche. |
TURN_LEFT |
Tournez à gauche. |
TURN_SLIGHT_RIGHT |
Tournez légèrement vers la droite. |
TURN_SHARP_RIGHT |
Tournez complètement à droite. |
UTURN_RIGHT |
Faites demi-tour par la droite. |
TURN_RIGHT |
Tournez à droite. |
STRAIGHT |
Continuez tout droit. |
RAMP_LEFT |
Prenez la bretelle de gauche. |
RAMP_RIGHT |
Prenez la bretelle de droite. |
MERGE |
Insérez-vous dans la circulation. |
FORK_LEFT |
Prenez la bifurcation à gauche. |
FORK_RIGHT |
Prenez la bifurcation à droite. |
FERRY |
Prenez le ferry. |
FERRY_TRAIN |
Prenez le train qui mène au ferry. |
ROUNDABOUT_LEFT |
Tournez à gauche au rond-point. |
ROUNDABOUT_RIGHT |
Tournez à droite au rond-point. |
DEPART |
Manœuvre initiale. |
NAME_CHANGE |
Utilisé pour indiquer un changement de nom de rue. |
DESTINATION |
Utilisé pour indiquer l'arrivée à une destination. |
RouteLegStepTravelAdvisory
Contient les informations supplémentaires dont l'utilisateur doit être informé, telles que les restrictions possibles de la zone de circulation sur une étape d'un segment.
| Représentation JSON |
|---|
{
"speedReadingIntervals": [
{
object ( |
| Champs | |
|---|---|
speedReadingIntervals[] |
REMARQUE : Ce champ n'est pas renseigné pour le moment. |
RouteLegStepLocalizedValues
Représentations textuelles de certaines propriétés.
| Représentation JSON |
|---|
{ "distance": { object ( |
| Champs | |
|---|---|
distance |
Distance de trajet représentée sous forme de texte. |
staticDuration |
Durée sans tenir compte des conditions de circulation, représentée sous forme de texte. |
RouteLegStepTransitDetails
Informations supplémentaires sur le RouteLegStep liées aux routes TRANSIT.
| Représentation JSON |
|---|
{ "stopDetails": { object ( |
| Champs | |
|---|---|
stopDetails |
Informations sur les arrêts d'arrivée et de départ de l'étape. |
localizedValues |
Représentations textuelles des propriétés de |
headsign |
Spécifie le sens du trajet sur cette ligne tel qu'indiqué sur le véhicule ou à l'arrêt de départ. La direction est souvent le terminus. |
headway |
Indique l'heure prévue sous forme de durée entre les départs depuis le même arrêt à l'heure actuelle. Par exemple, si la valeur de headway_secs est de 600, vous attendrez environ 10 minutes si vous manquez votre bus. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
transitLine |
Informations sur la ligne de transports en commun utilisée à cette étape. |
stopCount |
Nombre d'arrêts entre le départ et l'arrivée. Ce nombre inclut l'arrêt d'arrivée, mais exclut l'arrêt de départ. Par exemple, si votre itinéraire consiste à partir de l'arrêt A pour arriver à l'arrêt D en passant par les arrêts B et C, |
tripShortText |
Texte qui apparaît sur les horaires et les panneaux d'affichage pour identifier un trajet en transports en commun pour les passagers. Le texte doit identifier de manière unique un trajet au cours d'une journée de service. Par exemple, "538" est le |
TransitStopDetails
Détails sur les arrêts de transport en commun pour RouteLegStep.
| Représentation JSON |
|---|
{ "arrivalStop": { object ( |
| Champs | |
|---|---|
arrivalStop |
Informations sur l'arrêt d'arrivée de l'étape. |
arrivalTime |
Heure d'arrivée prévue pour l'étape. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
departureStop |
Informations sur l'arrêt de départ de l'étape. |
departureTime |
Heure de départ estimée pour l'étape. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
TransitStop
Informations sur un arrêt de transports en commun.
| Représentation JSON |
|---|
{
"name": string,
"location": {
object ( |
| Champs | |
|---|---|
name |
Nom de l'arrêt de transports en commun. |
location |
Emplacement de l'arrêt exprimé en coordonnées de latitude/longitude. |
TransitDetailsLocalizedValues
Descriptions localisées des valeurs pour RouteTransitDetails.
| Représentation JSON |
|---|
{ "arrivalTime": { object ( |
| Champs | |
|---|---|
arrivalTime |
Heure dans sa représentation textuelle formatée avec un fuseau horaire correspondant. |
departureTime |
Heure dans sa représentation textuelle formatée avec un fuseau horaire correspondant. |
LocalizedTime
Description localisée de l'heure.
| Représentation JSON |
|---|
{
"time": {
object ( |
| Champs | |
|---|---|
time |
Heure spécifiée sous forme de chaîne dans un fuseau horaire donné. |
timeZone |
Contient le fuseau horaire. La valeur correspond au nom du fuseau horaire, tel que défini dans la base de données des fuseaux horaires de l'IANA (par exemple, "America/New_York"). |
TransitLine
Contient des informations sur la ligne de transports en commun utilisée à cette étape.
| Représentation JSON |
|---|
{ "agencies": [ { object ( |
| Champs | |
|---|---|
agencies[] |
L'agence (ou les agences) de transports en commun qui gère cette ligne de transports en commun. |
name |
Nom complet de la ligne de transports en commun. Exemple : "8 Avenue Local". |
uri |
URI de cette ligne de transports en commun, fourni par l'agence de transports en commun. |
color |
Couleur couramment utilisée pour désigner cette ligne. Représenté en hexadécimal. |
iconUri |
URI de l'icône associée à cette ligne. |
nameShort |
Nom court de cette ligne de transports en commun. Il s'agit généralement d'un numéro de ligne tel que "M7" ou "355". |
textColor |
Couleur couramment utilisée pour le texte sur les panneaux de cette ligne. Représenté en hexadécimal. |
vehicle |
Type de véhicule utilisé sur cette ligne de transports en commun. |
TransitAgency
Agence de transports en commun qui exploite une ligne de transports en commun.
| Représentation JSON |
|---|
{ "name": string, "phoneNumber": string, "uri": string } |
| Champs | |
|---|---|
name |
Nom de cette agence de transports en commun. |
phoneNumber |
Numéro de téléphone de l'agence de transports en commun au format international. |
uri |
URI de l'agence de transports en commun. |
TransitVehicle
Informations sur un véhicule utilisé sur des itinéraires de transports en commun.
| Représentation JSON |
|---|
{ "name": { object ( |
| Champs | |
|---|---|
name |
Nom de ce véhicule, en majuscules. |
type |
Type de véhicule utilisé. |
iconUri |
URI d'une icône associée à ce type de véhicule. |
localIconUri |
URI de l'icône associée à ce type de véhicule d'après la signalétique locale pour les transports en commun. |
TransitVehicleType
Type de véhicules pour les itinéraires en transports en commun.
| Enums | |
|---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
Non utilisé. |
BUS |
Bus. |
CABLE_CAR |
Véhicule tracté par un câble, généralement en surface. Les téléphériques peuvent être de type GONDOLA_LIFT. |
COMMUTER_TRAIN |
Train de banlieue. |
FERRY |
Ferry. |
FUNICULAR |
Véhicule tracté par un câble le long d'une pente prononcée. Un funiculaire se compose généralement de deux rames, chacune agissant comme contrepoids de l'autre. |
GONDOLA_LIFT |
Téléphérique. |
HEAVY_RAIL |
Métro. |
HIGH_SPEED_TRAIN |
Train à grande vitesse. |
INTERCITY_BUS |
Bus interurbain. |
LONG_DISTANCE_TRAIN |
Train longue distance. |
METRO_RAIL |
Métro léger. |
MONORAIL |
Monorail. |
OTHER |
Tous les autres véhicules. |
RAIL |
Train. |
SHARE_TAXI |
Type de bus pouvant faire monter et descendre des passagers n'importe où sur la ligne. |
SUBWAY |
Métro léger souterrain. |
TRAM |
Métro léger en surface. |
TROLLEYBUS |
Trolleybus. |
RouteLegTravelAdvisory
Contient les informations supplémentaires dont l'utilisateur doit être informé lors d'une étape, telles que d'éventuelles restrictions de circulation.
| Représentation JSON |
|---|
{ "tollInfo": { object ( |
| Champs | |
|---|---|
tollInfo |
Contient des informations sur les péages pour l' |
speedReadingIntervals[] |
Intervalles de lecture de la vitesse indiquant la densité du trafic. Ce champ n'est renseigné que pour les requêtes dont la valeur Exemple : |
RouteLegLocalizedValues
Représentations textuelles de certaines propriétés.
| Représentation JSON |
|---|
{ "distance": { object ( |
| Champs | |
|---|---|
distance |
Distance de trajet représentée sous forme de texte. |
duration |
Durée, représentée sous forme de texte et localisée dans la région de la requête. Prend en compte les conditions de circulation. Remarque : Si vous n'avez pas demandé d'informations sur le trafic, cette valeur est identique à celle de staticDuration. |
staticDuration |
Durée sans tenir compte des conditions de circulation, représentée sous forme de texte. |
StepsOverview
Fournit des informations générales sur une liste de RouteLegStep.
| Représentation JSON |
|---|
{
"multiModalSegments": [
{
object ( |
| Champs | |
|---|---|
multiModalSegments[] |
Informations résumées sur les différents segments multimodaux de |
MultiModalSegment
Fournit des informations récapitulatives sur les différents segments multimodaux de RouteLeg.steps. Un segment multimodal est défini comme un ou plusieurs RouteLegStep contigus ayant le même RouteTravelMode. Ce champ n'est pas renseigné si RouteLeg ne contient aucun segment multimodal dans les étapes.
| Représentation JSON |
|---|
{ "navigationInstruction": { object ( |
| Champs | |
|---|---|
navigationInstruction |
NavigationInstruction pour le segment multimodal. |
travelMode |
Mode de transport du segment multimodal. |
stepStartIndex |
Index |
stepEndIndex |
Index |
Fenêtre d'affichage
Une fenêtre d'affichage de latitude/longitude, représentée par deux points low et high diagonalement opposés. Une fenêtre d'affichage est considérée comme une région fermée, c'est-à-dire qu'elle inclut sa limite. Les limites de latitude doivent être comprises entre -90 et 90 degrés inclus, et les limites de longitude entre -180 et 180 degrés inclus. Voici quelques exemples :
Si
low=high, la fenêtre d'affichage se compose de ce point unique.Si
low.longitude>high.longitude, la plage de longitude est inversée (la fenêtre d'affichage traverse la ligne de longitude de 180 degrés).Si
low.longitude= -180 degrés ethigh.longitude= 180 degrés, la fenêtre d'affichage inclut toutes les longitudes.Si
low.longitude= 180 degrés ethigh.longitude= -180 degrés, la plage de longitude est vide.Si
low.latitude>high.latitude, la plage de latitude est vide.
low et high doivent être renseignés, et la zone représentée ne peut pas être vide (comme spécifié par les définitions ci-dessus). Un viewport vide entraînera une erreur.
Par exemple, cette fenêtre d'affichage englobe entièrement la ville de New York :
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
| Représentation JSON |
|---|
{ "low": { object ( |
| Champs | |
|---|---|
low |
Obligatoire. Point bas de la fenêtre d'affichage. |
high |
Obligatoire. Point le plus haut de la fenêtre d'affichage. |
RouteLocalizedValues
Représentations textuelles de certaines propriétés.
| Représentation JSON |
|---|
{ "distance": { object ( |
| Champs | |
|---|---|
distance |
Distance de trajet représentée sous forme de texte. |
duration |
Durée, représentée sous forme de texte et localisée dans la région de la requête. Prend en compte les conditions de circulation. Remarque : Si vous n'avez pas demandé d'informations sur le trafic, cette valeur est identique à |
staticDuration |
Durée sans tenir compte des conditions de circulation, représentée sous forme de texte. |
transitFare |
Tarif des transports en commun représenté sous forme de texte. |
PolylineDetails
Détails correspondant à un index ou à un segment contigu d'une polyligne. Étant donné une polyligne avec les points P_0, P_1, ... , P_N (index de base zéro), PolylineDetails définit un intervalle et les métadonnées associées.
| Représentation JSON |
|---|
{ "tunnelInfo": [ { object ( |
| Champs | |
|---|---|
tunnelInfo[] |
Détails du tunnel le long de la polyligne. Ce champ est renseigné si la requête spécifie le modificateur d'itinéraire |
restrictionInfo[] |
Détails des restrictions le long de la polyligne. Ce champ n'est renseigné que si une requête spécifie le modificateur d'itinéraire |
flyoverInfo[] |
Détails du survol le long de la polyligne. |
narrowRoadInfo[] |
Détails des routes étroites le long de la polyligne. |
bridgeInfo[] |
Détails des ponts le long de la polyligne. |
skywayInfo[] |
Détails de la passerelle le long de la polyligne. |
TunnelInfo
Encapsule les informations sur les tunnels le long de la polyligne.
| Représentation JSON |
|---|
{ "tunnelPresence": enum ( |
| Champs | |
|---|---|
tunnelPresence |
Indique si un tunnel existe pour une section donnée de la polyligne. |
polylinePointIndex |
Emplacement des informations relatives au tunnel le long de la polyligne. |
RoadFeatureState
Encapsule les états des caractéristiques de la route le long d'un segment de polyligne.
| Enums | |
|---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
L'état de la caractéristique de route n'a pas été calculé (valeur par défaut). |
EXISTS |
La caractéristique de la route existe. |
DOES_NOT_EXIST |
La route n'existe pas. |
PolylinePointIndex
Encapsule les index de début et de fin d'un détail de polyligne. Pour les instances où les données correspondent à un seul point, startIndex et endIndex seront égaux.
| Représentation JSON |
|---|
{ "startIndex": integer, "endIndex": integer } |
| Champs | |
|---|---|
startIndex |
Index de début de ce détail dans la polyligne. |
endIndex |
Index de fin de ce détail dans la polyligne. |
RestrictionInfo
Encapsule des informations sur les différentes restrictions le long de la polyligne.
| Représentation JSON |
|---|
{ "restrictionPresence": enum ( |
| Champs | |
|---|---|
restrictionPresence |
Uniquement en sortie. Indique si une restriction existe pour un tronçon donné de la polyligne. |
polylinePointIndex |
Emplacement des informations liées aux restrictions le long de la polyligne. |
| Encapsule les types de restrictions pouvant s'appliquer à un segment donné de la polyligne. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse : | |
restrictedHeightMm |
Hauteur maximale, en millimètres. Ce champ est renseigné lorsque la hauteur limitée empêche le passage ou entraîne une faible hauteur libre pour le véhicule spécifié. |
restrictedWeightKg |
Limite de poids, en kilogrammes. Ce champ est renseigné lorsque la restriction de poids empêche le passage ou est proche du poids du véhicule spécifié. |
hazardousGoods |
Ce champ est défini sur "true" lorsque le transport de marchandises dangereuses est limité. |
trucksProhibited |
Ce champ est défini sur "true" lorsque les camions sont interdits. |
| Fin des champs mutuellement exclusifs. | |
FlyoverInfo
Encapsule les informations sur les survols le long de la polyligne.
| Représentation JSON |
|---|
{ "flyoverPresence": enum ( |
| Champs | |
|---|---|
flyoverPresence |
Uniquement en sortie. Indique si un survol existe pour un tronçon donné de la polyligne. |
polylinePointIndex |
Emplacement des informations liées au survol le long de la polyligne. |
NarrowRoadInfo
Encapsule des informations sur les routes étroites le long de la polyligne.
| Représentation JSON |
|---|
{ "narrowRoadPresence": enum ( |
| Champs | |
|---|---|
narrowRoadPresence |
Uniquement en sortie. Indique si une route étroite existe pour un tronçon donné de la polyligne. |
polylinePointIndex |
Emplacement des informations sur les routes étroites le long de la polyligne. |
BridgeInfo
Encapsule des informations sur les ponts le long de la polyligne.
| Représentation JSON |
|---|
{ "bridgePresence": enum ( |
| Champs | |
|---|---|
bridgePresence |
Indique si un pont existe pour un tronçon donné de la polyligne. |
polylinePointIndex |
Emplacement des informations relatives au pont le long de la polyligne. |
SkywayInfo
Encapsule des informations sur les passerelles le long de la polyligne.
| Représentation JSON |
|---|
{ "skywayPresence": enum ( |
| Champs | |
|---|---|
skywayPresence |
Indique si une passerelle existe pour un tronçon donné de la polyligne. |
polylinePointIndex |
Emplacement des informations relatives à la passerelle le long de la polyligne. |
GeocodingResults
Contient pour les points de départ, de destination et de cheminement intermédiaire. Renseigné uniquement pour les points de cheminement d'adresse.GeocodedWaypoints
| Représentation JSON |
|---|
{ "origin": { object ( |
| Champs | |
|---|---|
origin |
Point de cheminement géocodé d'origine. |
destination |
Point de cheminement géocodé de destination. |
intermediates[] |
Liste de points de cheminement géocodés intermédiaires, chacun contenant un champ d'index correspondant à la position (commençant par zéro) du point de cheminement dans l'ordre dans lequel ils ont été spécifiés dans la requête. |
GeocodedWaypoint
Détails sur les lieux utilisés comme points de cheminement. Renseigné uniquement pour les points de cheminement d'adresse. Inclut des détails sur les résultats de géocodage afin de déterminer à quoi l'adresse a été géocodée.
| Représentation JSON |
|---|
{
"geocoderStatus": {
object ( |
| Champs | |
|---|---|
geocoderStatus |
Indique le code d'état résultant de l'opération de geocoding. |
type[] |
Le ou les types du résultat, sous la forme de zéro ou plusieurs tags de type. Types compatibles : Types d'adresses et de composants d'adresse. |
partialMatch |
Indique que le geocoder n'a pas renvoyé de correspondance exacte pour la requête d'origine, bien qu'il ait pu trouver une partie de l'adresse demandée. Nous vous recommandons d'examiner la requête d'origine pour vérifier qu'elle ne contient pas d'erreur de syntaxe et/ou que l'adresse est bien complète. |
placeId |
ID de lieu pour ce résultat. |
intermediateWaypointRequestIndex |
Index du point de cheminement intermédiaire correspondant dans la requête. Renseigné uniquement si le point de cheminement correspondant est un point de cheminement intermédiaire. |