- Requête HTTP
- Corps de la requête
- Corps de la réponse
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- RouteTokenOptions
- RouteTokenBehavior
- Route
- RouteLabel
- RouteLeg
- RouteLegStep
- NavigationInstruction
- Manœuvre
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Fenêtre d'affichage
- RouteLocalizedValues
- RouteTokenUpdateFidelity
- PolylineDetails
- AltitudeInfo
- PolylinePointIndex
- IncidentInfo
- IncidentType
- SegmentInfo
- FerryInfo
- RoadFeatureState
- HighwayInfo
- TollInfo
- TunnelInfo
- VignetteInfo
- HovInfo
- RestrictionInfo
- PredictedSpeedInfo
- PredictedSpeedInterval
- GeocodingResults
- GeocodedWaypoint
Affiche l'itinéraire principal, ainsi que les autres itinéraires facultatifs en fonction d'un ensemble de points de cheminement terminaux et intermédiaires.
REMARQUE:Cette méthode nécessite la spécification d'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 d'un en-tête HTTP/gRPC X-Goog-FieldMask
(voir les en-têtes et paramètres d'URL disponibles). La valeur est une liste de chemins d'accès de champs séparés par une virgule. Consultez la documentation détaillée pour savoir comment construire les chemins d'accès aux champs.
Par exemple, dans cette méthode:
- Masque de champ de tous les champs disponibles (pour l'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 l'utilisation du masque de champ de réponse utilisant le caractère générique (*
) ou la spécification du masque de champ au niveau supérieur (routes
), pour les raisons suivantes:
- En sélectionnant uniquement les champs dont vous avez besoin, vous aidez notre serveur à économiser les cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
- Le fait de ne sélectionner que les champs dont vous avez besoin pour votre job de production garantit des performances de latence stables. Nous ajouterons peut-être d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter du temps de calcul supplémentaire. Si vous sélectionnez tous les champs, ou tous les champs du premier niveau, vous risquez de constater une dégradation des performances. En effet, les nouveaux champs que nous ajoutons seront automatiquement inclus dans la réponse.
- Si vous ne sélectionnez que les champs dont vous avez besoin, vous réduirez la taille des réponses et, par conséquent, le débit du réseau.
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 terminaux) permettant de s'arrêter ou de passer. Vous pouvez ajouter jusqu'à 25 points de cheminement intermédiaires. |
travelMode |
Facultatif. Spécifie le mode de transport. |
routingPreference |
Facultatif. Spécifie le mode de calcul de la route. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer la route. Si la préférence de routage entraîne une erreur ou une latence extra longue, une erreur est renvoyée. Vous ne pouvez spécifier cette option que si |
polylineQuality |
Facultatif. Indique 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 Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
arrivalTime |
Facultatif. Heure d'arrivée. REMARQUE: Ne peut être défini que lorsque Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
computeAlternativeRoutes |
Facultatif. Indique si des itinéraires bis doivent être calculés en plus de l'itinéraire. Aucun autre itinéraire n'est renvoyé pour les requêtes comportant des points de cheminement intermédiaires. |
routeModifiers |
Facultatif. Ensemble de conditions à remplir qui affectent la façon dont les routes sont calculées. |
languageCode |
Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez Identifiant des paramètres régionaux Unicode. Consultez la page Langues acceptées pour obtenir la liste des langues acceptées. Si vous ne fournissez pas cette valeur, la langue d'affichage est déduite de l'emplacement de la requête 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 de premier niveau avec code pays. |
units |
Facultatif. Spécifie les unités de mesure pour les champs d'affichage. Ces champs incluent le champ |
optimizeWaypointOrder |
Facultatif. Si cette règle est définie sur "True", le service tente de réduire 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 routes de référence à calculer dans le cadre de la requête, en plus de la route par défaut. Une route de référence est une route dont l'objectif de calcul est différent de celui de la route par défaut. Par exemple, le calcul d'un itinéraire de référence |
extraComputations[] |
Facultatif. Une liste des calculs supplémentaires qui peuvent être utilisés pour terminer la requête. Remarque: Ces calculs supplémentaires peuvent renvoyer des champs supplémentaires sur la réponse. Ces champs supplémentaires doivent également être spécifiés dans le masque de champ à renvoyer dans la réponse. |
routeToken |
Facultatif. Obsolète: utilisez plutôt |
routeTokenOptions |
Facultatif. Les jetons de route permettent à une requête de dépendre d'une route précédemment sélectionnée. |
trafficModel |
Facultatif. Spécifie les hypothèses à utiliser pour calculer le temps de trajet. Ce paramètre affecte la valeur renvoyée dans le champ de durée des |
transitPreferences |
Facultatif. Spécifie les préférences qui influencent l'itinéraire renvoyé pour les routes |
navigationSessionId |
Facultatif. ID de session de navigation généré par le client et utilisé pour associer cette requête d'itinéraire aux journaux de navigation du client pour l'analyse de la navigation. Il doit s'agir d'un UUID généré de manière aléatoire, conforme à la norme RFC 4122 et propre à une session de navigation spécifique. |
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 des itinéraires calculés (jusqu'à trois) lorsque vous spécifiez |
fallbackInfo |
Dans certains cas, lorsque le serveur n'est pas en mesure de calculer les résultats d'itinéraire avec toutes les préférences d'entrée, il peut avoir recours à 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 geocoding 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 en matière de qualité des polylignes n'est spécifiée. La valeur par défaut est OVERVIEW . |
HIGH_QUALITY |
Spécifie une polyligne de haute qualité, composée d'un plus grand nombre de points que OVERVIEW , au prix d'une taille de réponse accrue. Utilisez cette valeur lorsque vous avez besoin de plus de précision. |
OVERVIEW |
Spécifie une polyligne d'aperçu, composée d'un petit nombre de points. Utilisez cette valeur pour afficher une vue d'ensemble de la route. Cette option présente 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 |
Vous n'avez pas indiqué de préférence pour le type de polyligne. La valeur par défaut est ENCODED_POLYLINE . |
ENCODED_POLYLINE |
Spécifie une polyligne encodée à l'aide de l'algorithme d'encodage des polylignes. |
GEO_JSON_LINESTRING |
Spécifie une polyligne au format GeoJSON LineString. |
ReferenceRoute
Une route de référence prise en charge sur ComputeRoutesRequest.
Enums | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Non utilisé. Les requêtes contenant cette valeur échouent. |
FUEL_EFFICIENT |
Itinéraire économe en carburant. Les itinéraires associés à cette valeur ont été identifiés comme optimisés pour des paramètres tels que la consommation de carburant. |
ExtraComputation
Calculs supplémentaires à effectuer lors du traitement de la requête.
Enums | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Non utilisé. Les requêtes contenant cette valeur échoueront. |
TOLLS |
Informations sur le péage pour le ou les itinéraires. |
FUEL_CONSUMPTION |
Estimation de la consommation de carburant du ou des itinéraires. |
TRAFFIC_ON_POLYLINE |
Polylignes sensibles au trafic pour les itinéraires. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions présenté sous la forme d'une chaîne de texte HTML mise en forme. Ce contenu est destiné à être lu tel quel. Il est destiné à être affiché uniquement. Ne l'analysez pas par programmation. |
PREDICTED_SPEED_ON_POLYLINE_20KPH_BUCKETS |
Vitesse prédite en buckets de 20 km/h. |
PREDICTED_SPEED_ON_POLYLINE_10KPH_BUCKETS |
Vitesse prédite en buckets de 10 km/h. |
RouteTokenOptions
Options liées aux jetons de routage.
Représentation JSON |
---|
{
"routeToken": string,
"routeTokenBehavior": enum ( |
Champs | |
---|---|
routeToken |
Facultatif. Si cette valeur est définie, une route "semblable" à celle associée au jeton est générée, si possible. Vous devez quand même fournir les paramètres de requête d'origine (par exemple, l'origine, la destination, etc.). |
routeTokenBehavior |
Facultatif. Indication du traitement de |
RouteTokenBehavior
Modes compatibles avec les jetons de routage.
Enums | |
---|---|
ROUTE_TOKEN_BEHAVIOR_UNSPECIFIED |
Traitée comme GET_ROUTE_UPDATES pour des raisons de compatibilité. |
GET_ROUTE_UPDATES |
Si |origin| se trouve sur l'itinéraire représenté par routeToken , l'un des itinéraires obtenus est celui représenté par routeToken . Les routes restantes ne sont pas liées. Les mises à jour sont plus efficaces lorsque la valeur |origin| est proche du début de routeToken , c'est-à-dire que l'utilisateur n'est pas éloigné de l'endroit où routeToken a été généré. |
GET_SIMILAR_ROUTES |
L'itinéraire représenté par routeToken n'est pas inclus dans la réponse, mais les autres itinéraires présentent une similarité avec routeToken en tant que facteur de pondération dans leur classement. |
Route
Contient un itinéraire composé d'une série de segments de route reliés entre eux par des points de cheminement de départ, d'arrivée et intermédiaires.
Représentation JSON |
---|
{ "routeLabels": [ enum ( |
Champs | |
---|---|
routeLabels[] |
Étiquettes pour |
legs[] |
Ensemble de sections (segments de chemin entre les points de cheminement) composant 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 Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par " |
staticDuration |
Durée du trajet pour l'itinéraire, sans tenir compte des conditions de circulation Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par " |
polyline |
Polyligne de l'itinéraire. 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 la route. |
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 de route sécurisé pour le Web encodé en base64 qui peut être transmis au SDK Navigation. Il permet à ce dernier de reconstruire l'itinéraire pendant la navigation et, en cas de réacheminement, de respecter l'intention d'origine lorsque vous avez créé la route en appelant v2.computeRoutes. Les clients doivent traiter ce jeton comme un blob opaque. Il n'est pas destiné à la lecture ni à la mutation. REMARQUE: |
routeTokenUpdateFidelity |
Pour |
polylineDetails |
Contient des informations sur les détails situés le long de la polyligne. |
RouteLabel
Étiquettes pour
permettant d'identifier des propriétés spécifiques de l'itinéraire à comparer aux autresRoute
Enums | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
Par défaut : non utilisé. |
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. Des routes de ce type sont renvoyées lorsque est spécifié. |
FUEL_EFFICIENT |
Itinéraire économe en carburant. Les itinéraires associés à cette valeur ont été identifiés comme optimisés pour les paramètres éco, comme la consommation de carburant. |
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 à parcourir pour le trajet de l'itinéraire, en mètres. |
duration |
Temps nécessaire pour parcourir le trajet. Si Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par " |
staticDuration |
Durée du trajet pour le trajet, calculée en tenant compte des conditions de circulation. Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par " |
polyline |
La polyligne globale de cette section, qui inclut la polyligne de chaque |
startLocation |
Lieu de départ de cette section. Cet emplacement peut être différent du |
endLocation |
Lieu d'arrivée de cette section. Cet emplacement peut être différent du |
steps[] |
Tableau d'étapes représentant les segments de cette section. Chaque étape représente une instruction de navigation. |
travelAdvisory |
Contient les informations supplémentaires dont l'utilisateur doit être informé, telles que les éventuelles restrictions de zone de circulation, sur une section de l'itinéraire. |
localizedValues |
Représentations textuelles des propriétés de |
stepsOverview |
Informations générales sur les étapes de ce |
RouteLegStep
Contient un segment de
. Une étape correspond à une seule instruction de navigation. Les sections d'itinéraire sont composées d'étapes.RouteLeg
Représentation JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Champs | |
---|---|
distanceMeters |
Distance parcourue lors de cette étape, en mètres. Dans certains cas, ce champ peut ne pas contenir 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 contenir de valeur. Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par " |
polyline |
Polyligne associée à cette étape. |
startLocation |
Lieu de départ de cette étape. |
endLocation |
Lieu d'arrivée de cette étape. |
navigationInstruction |
Instructions de navigation |
travelAdvisory |
Contient les informations supplémentaires dont l'utilisateur doit être informé, telles que les éventuelles restrictions de zone de circulation, sur une étape du trajet. |
localizedValues |
Représentations textuelles des propriétés de |
transitDetails |
Détails concernant cette étape si le mode de transport est |
travelMode |
Mode de transport utilisé pour cette étape. |
Manœuvre
Ensemble de valeurs spécifiant l'action de navigation à effectuer pour l'étape actuelle (par exemple, tourner à gauche, fusionner ou tout droit).
Enums | |
---|---|
MANEUVER_UNSPECIFIED |
Non utilisé. |
TURN_SLIGHT_LEFT |
Tournez légèrement vers la gauche. |
TURN_SHARP_LEFT |
Tournez complètement à gauche. |
UTURN_LEFT |
Faire demi-tour à gauche. |
TURN_LEFT |
Tournez à gauche. |
TURN_SLIGHT_RIGHT |
Tournez légèrement vers la droite. |
TURN_SHARP_RIGHT |
Tournez complètement vers la droite. |
UTURN_RIGHT |
Faites un demi-tour vers la droite. |
TURN_RIGHT |
Tournez à droite. |
STRAIGHT |
Allez tout droit. |
RAMP_LEFT |
Prendre la rampe de gauche. |
RAMP_RIGHT |
Prenez la bretelle de droite. |
MERGE |
Intégrez le trafic. |
FORK_LEFT |
Prendre la bifurcation à gauche. |
FORK_RIGHT |
Prenez la bifurcation à droite. |
FERRY |
Prenez le ferry. |
FERRY_TRAIN |
Prendre le train menant au ferry. |
ROUNDABOUT_LEFT |
Au rond-point, tournez à gauche. |
ROUNDABOUT_RIGHT |
Au rond-point, tournez à droite. |
DEPART |
Manœuvre initiale. |
NAME_CHANGE |
Permet d'indiquer un changement de nom de rue. |
RouteLegStepTravelAdvisory
Contient les informations supplémentaires dont l'utilisateur doit être informé, telles que les éventuelles restrictions de zone de circulation sur une étape du trajet.
Représentation JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
Champs | |
---|---|
speedReadingIntervals[] |
REMARQUE: Actuellement, ce champ n'est pas renseigné. |
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 au format texte. |
RouteLegStepTransitDetails
Informations supplémentaires pour le RouteLegStep
concernant les routes TRANSIT
.
Représentation JSON |
---|
{ "stopDetails": { object ( |
Champs | |
---|---|
stopDetails |
Informations sur les arrêts d'arrivée et de départ pour 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 correspond souvent au terminus. |
headway |
Spécifie l'heure prévue sous la forme d'une durée entre les départs depuis le même arrêt à l'heure actuelle. Par exemple, avec une valeur de 600 secondes d'intervalle entre les passages, vous vous attendez à attendre 10 minutes si vous ratez votre bus. Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par " |
transitLine |
Informations sur la ligne de transports en commun utilisée à cette étape. |
stopCount |
Nombre d'arrêts entre l'arrêt de départ et l'arrêt d'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 part de l'arrêt A, passe par les arrêts B et C et arrive à l'arrêt D, stopCount renvoie 3. |
tripShortText |
Texte qui apparaît sur les horaires et les panneaux d'affichage pour identifier aux passagers un trajet en transport en commun. Le texte doit identifier de façon unique un trajet au cours d'une journée de service. Par exemple, "538" correspond au |
TransitStopDetails
Informations sur les arrêts de transports en commun du RouteLegStep
.
Représentation JSON |
---|
{ "arrivalStop": { object ( |
Champs | |
---|---|
arrivalStop |
Informations sur l'arrêt d'arrivée pour l'étape. |
arrivalTime |
Heure d'arrivée estimée pour l'étape. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
departureStop |
Informations sur l'arrêt de départ pour l'étape. |
departureTime |
Heure de départ estimée pour l'étape. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. 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 |
Position de l'arrêt, exprimée 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 mise en forme du texte avec le fuseau horaire correspondant. |
departureTime |
Heure dans sa représentation mise en forme du texte avec le 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[] |
La ou les agences de transports en commun qui desservent cette ligne de transports en commun. |
name |
Nom complet de cette ligne de transports en commun (par exemple, "8 avenue Locale"). |
uri |
URI de la ligne de transports en commun fourni par l'agence de transports en commun. |
color |
Couleur couramment utilisée dans la signalisation pour 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. Ce nom est normalement un numéro de ligne, tel que "M7" ou "355". |
textColor |
Couleur couramment utilisée dans le texte de la signalisation pour 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 gère une ligne de transports en commun.
Représentation JSON |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
Champs | |
---|---|
name |
Nom de l'agence de transports en commun. |
phoneNumber |
Numéro de téléphone au format spécifique aux paramètres régionaux de l'agence de transports en commun. |
uri |
URI de l'agence de transports en commun. |
TransitVehicle
Informations sur un véhicule utilisé dans les itinéraires de transports en commun.
Représentation JSON |
---|
{ "name": { object ( |
Champs | |
---|---|
name |
Nom du 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é à ce type de véhicule, en fonction de la signalétique locale pour les transports en commun. |
TransitVehicleType
Type de véhicule 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 du trajet, telles que les éventuelles restrictions de zone de circulation.
Représentation JSON |
---|
{ "tollInfo": { object ( |
Champs | |
---|---|
tollInfo |
Contient des informations sur les péages sur le |
speedReadingIntervals[] |
Intervalles de lecture de la vitesse détaillant la densité du trafic. Applicable en cas de préférences de routage 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 en tenant compte des conditions de circulation représentées au format texte. Remarque: Si vous n'avez pas demandé d'informations sur le trafic, cette valeur sera la même que "staticDuration". |
staticDuration |
Durée sans tenir compte des conditions de circulation, représentée au format texte. |
StepsOverview
Fournit des informations générales sur une liste de RouteLegStep
.
Représentation JSON |
---|
{
"multiModalSegments": [
{
object ( |
Champs | |
---|---|
multiModalSegments[] |
Résumé des informations sur les différents segments multimodaux de |
MultiModalSegment
Fournit des informations résumées sur les différents segments multimodaux du 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 |
L'index |
stepEndIndex |
L'index |
Fenêtre d'affichage
Une fenêtre d'affichage de latitude-longitude, représentée par deux points low
et high
opposés en diagonale. Une fenêtre d'affichage est considérée comme une zone fermée, c'est-à-dire qu'elle inclut ses limites. Les limites de latitude doivent être comprises entre -90 et 90 degrés inclus, et les limites de longitude doivent être comprises entre -180 et 180 degrés inclus. Différents cas sont possibles:
Si
low
=high
, la fenêtre d'affichage se compose de ce point unique.Si
low.longitude
>high.longitude
, la plage de longitudes est inversée (la fenêtre d'affichage traverse la ligne de longitude à 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 latitudes est vide.
Les champs low
et high
doivent tous les deux être renseignés, et la zone représentée ne peut pas être vide (comme indiqué dans les définitions ci-dessus). Une fenêtre d'affichage vide génère une erreur.
Par exemple, la fenêtre d'affichage suivante inclut entièrement 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 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 en tenant compte des conditions de circulation, représentée au format texte. Remarque: Si vous n'avez pas demandé d'informations sur le trafic, cette valeur sera identique à |
staticDuration |
Durée sans tenir compte des conditions de circulation, représentée au format texte. |
transitFare |
Tarif de transports en commun représenté sous forme de texte. |
RouteTokenUpdateFidelity
Pour les requêtes utilisant routeTokenBehavior
GET_ROUTE_UPDATES
, identifie les routes construites à partir du jeton route associé. (sans rapport avec l'routeToken
dans ce message).
Enums | |
---|---|
ROUTE_TOKEN_UPDATE_FIDELITY_UNSPECIFIED |
Ce routage n'a pas été généré à partir d'un jeton de routage. |
APPROXIMATE |
Cet itinéraire est reconstitué à partir d'un jeton d'itinéraire et est équivalent logiquement, mais sa géométrie n'est pas identique. |
IDENTICAL |
Cet itinéraire est identique à un jeton de route sur le plan géométrique. |
PolylineDetails
Détails correspondant à un indice donné ou à un segment contigu d'une polyligne Pour une polyligne comportant les points P_0, P_1, ... et P_N (index basé sur zéro), PolylineDetails
définit un intervalle et les métadonnées associées.
Représentation JSON |
---|
{ "altitudeInfo": [ { object ( |
Champs | |
---|---|
altitudeInfo[] |
Détails d'altitude le long de la polyligne |
incidentInfo[] |
Détails de l'incident le long de la polyligne |
segmentInfo[] |
Détails du segment le long de la polyligne |
ferryInfo[] |
Détails du ferry le long de la polyligne Ce champ n'est renseigné que si une requête spécifie le modificateur de route |
highwayInfo[] |
Détails de l'autoroute le long de la polyligne Ce champ n'est renseigné que si une requête spécifie le modificateur de route |
tollInfo[] |
Détails du péage le long de la polyligne Ce champ n'est renseigné que si une requête spécifie le modificateur de route |
tunnelInfo[] |
Détails du tunnel le long de la polyligne. Ce champ n'est renseigné que si une requête spécifie le modificateur de route |
vignetteInfo[] |
Détails de la vignette le long de la polyligne. Ce champ n'est renseigné que si une requête spécifie le modificateur de route |
hovInfo[] |
Détails Hov le long de la polyligne. Ce champ n'est renseigné que si une requête spécifie le modificateur de route |
restrictionInfo[] |
Informations de restriction le long de la polyligne. Ce champ n'est renseigné que si une requête spécifie le modificateur de route |
predictedSpeeds[] |
Bins à vitesse prédite le long de la polyligne. |
AltitudeInfo
Encapsule les informations sur l'altitude le long de la polyligne.
Représentation JSON |
---|
{
"polylinePointIndex": {
object ( |
Champs | |
---|---|
polylinePointIndex |
Emplacement de la mesure d'altitude le long de la polyligne. |
altitudeMeters |
Altitude en mètres par rapport à l'ellipsoïde WGS-84. |
PolylinePointIndex
Encapsule les index de début et de fin pour les détails d'une polyligne. Pour les cas où les données correspondent à un seul point, startIndex
et endIndex
sont é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 |
IncidentInfo
Encapsule les informations sur un incident le long de la polyligne.
Représentation JSON |
---|
{ "incidentType": enum ( |
Champs | |
---|---|
incidentType |
Type d'incident. |
estimatedDelay |
Délai estimé par rapport à la durée de balayage normale Uniquement renvoyée pour INCIDENT_JAM. Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par " |
polylinePointIndex |
Emplacement de l'incident le long de la polyligne |
IncidentType
Types d'incidents
Enums | |
---|---|
INCIDENT_TYPE_UNSPECIFIED |
Valeur par défaut. Cette valeur n'est pas utilisée. |
INCIDENT_ROAD_CLOSED |
Une route fermée. |
INCIDENT_CRASH |
Un plantage. |
INCIDENT_CONSTRUCTION |
Travaux. |
INCIDENT_JAM |
Embouteillage. |
SegmentInfo
Encapsule les informations sur les segments le long de la polyligne.
Représentation JSON |
---|
{
"placeId": string,
"polylinePointIndex": {
object ( |
Champs | |
---|---|
placeId |
ID de lieu pour cette section de route. |
polylinePointIndex |
Position du segment le long de la polyligne. |
FerryInfo
Encapsule les informations sur les ferries le long de la polyligne.
Représentation JSON |
---|
{ "ferryPresence": enum ( |
Champs | |
---|---|
ferryPresence |
Uniquement en sortie. Indique s'il existe un ferry pour une portion donnée de la polyligne. |
polylinePointIndex |
Emplacement des informations concernant le ferry le long de la polyligne. |
RoadFeatureState
Encapsule les états des éléments géographiques d'une route (par exemple, autoroutes, ferries, etc.) le long d'une portion de polyligne.
Enums | |
---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
L'état de l'élément routier n'a pas été calculé (valeur par défaut). |
EXISTS |
L'élément "Route" existe. |
DOES_NOT_EXIST |
L'élément "route" n'existe pas. |
HighwayInfo
Encapsule les informations sur les autoroutes le long de la polyligne.
Représentation JSON |
---|
{ "highwayPresence": enum ( |
Champs | |
---|---|
highwayPresence |
Uniquement en sortie. Indique s'il existe une autoroute pour une portion donnée de la polyligne. |
polylinePointIndex |
Position des informations relatives à l'autoroute le long de la polyligne. |
TollInfo
Encapsule les informations sur les péages le long de la polyligne.
Représentation JSON |
---|
{ "tollPresence": enum ( |
Champs | |
---|---|
tollPresence |
Uniquement en sortie. Indique si un péage est disponible pour une portion de la polyligne donnée. |
polylinePointIndex |
Position des informations de péage le long de la polyligne. |
TunnelInfo
Encapsule les informations sur les tunnels le long de la polyligne.
Représentation JSON |
---|
{ "tunnelPresence": enum ( |
Champs | |
---|---|
tunnelPresence |
Uniquement en sortie. Indique si un tunnel existe pour une portion donnée de la polyligne. |
polylinePointIndex |
Emplacement des informations liées au tunnel le long de la polyligne. |
VignetteInfo
Encapsule les informations sur les vignettes le long de la polyligne.
Représentation JSON |
---|
{ "vignettePresence": enum ( |
Champs | |
---|---|
vignettePresence |
Uniquement en sortie. Indique si un vignetage existe pour une portion donnée de la polyligne. |
polylinePointIndex |
Position des informations de vignetage le long de la polyligne. |
HovInfo
Encapsule les informations sur les sections/voies VMO le long de la polyligne.
Représentation JSON |
---|
{ "hovPresence": enum ( |
Champs | |
---|---|
hovPresence |
Uniquement en sortie. Indique s'il existe une route/voie VMO pour une portion donnée de la polyligne. |
polylinePointIndex |
Position des informations liées au covoiturage le long de la polyligne. |
RestrictionInfo
Encapsule les informations sur les différentes restrictions le long de la polyligne.
Représentation JSON |
---|
{ "restrictionPresence": enum ( |
Champs | |
---|---|
restrictionPresence |
Uniquement en sortie. Indique s'il existe une restriction pour une portion donnée de la polyligne. |
polylinePointIndex |
Emplacement des informations liées à la restriction le long de la polyligne. |
Champ d'union restriction . Encapsule les types de restrictions qui peuvent s'appliquer à une portion donnée de la polyligne. restriction ne peut être qu'un des éléments suivants : |
|
restrictedHeightMm |
Limite de hauteur, en millimètres. Ce champ n'est renseigné que lorsque la hauteur limitée oblige le conducteur à traverser une portion de route à faible capacité de circulation. |
PredictedSpeedInfo
Encapsule les informations sur les vitesses prédites le long de la polyligne.
Représentation JSON |
---|
{ "predictedSpeedInterval": { object ( |
Champs | |
---|---|
predictedSpeedInterval |
Plage de vitesses prédite sur cette partie de la polyligne. |
polylinePointIndex |
Emplacement de l'intervalle de vitesse prévu le long de la polyligne. |
PredictedSpeedInterval
Intervalle de vitesse prévu flexible. Si la limite supérieure n'est pas renseignée, cet intervalle inclut toutes les valeurs supérieures à la limite inférieure pour cet intervalle. Avec les options de bucket de 20 km/h, les intervalles sont: [0, 10) km/h [10, 30) km/h [30, 50) km/h [50, 70) km/h [70, 90) km/h [90, 110) km/h [110, 130) km/h, 130 km/h.
Représentation JSON |
---|
{ "lowerBoundKphInclusive": integer, "upperBoundKphExclusive": integer } |
Champs | |
---|---|
lowerBoundKphInclusive |
Cet intervalle représente les vitesses dans [ |
upperBoundKphExclusive |
Voir ci-dessus |
GeocodingResults
Contient
pour les points de cheminement de départ, de destination et intermédiaires. Renseigné uniquement pour les points de cheminement d'adresse.GeocodedWaypoints
Représentation JSON |
---|
{ "origin": { object ( |
Champs | |
---|---|
origin |
Point de cheminement d'origine géocodé. |
destination |
Point de cheminement géocodé de destination. |
intermediates[] |
Une liste de points de cheminement intermédiaires géocodés contenant chacun un champ d'indice correspondant à la position basée sur zéro du point de cheminement, dans l'ordre dans lequel il a été spécifié dans la requête. |
GeocodedWaypoint
Informations détaillées sur les lieux utilisés comme points de cheminement Renseigné uniquement pour les points de cheminement d'adresse. Comprend des détails sur les résultats du geocoding afin de déterminer sur quelle 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[] |
Type(s) du résultat, sous la forme de zéro ou plusieurs balises de type. Types compatibles: types d'adresse et types 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. |