- Requête HTTP
- Corps de la requête
- Corps de la réponse
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Itinéraire
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- RouteLabel
- RouteLeg
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Polyline
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- RouteLegStep
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- NavigationInstruction
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Manœuvre
- RouteLegStepTravelAdvisory
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- RouteLegStepLocalizedValues
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- RouteLegStepTransitDetails
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- TransitStopDetails
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- TransitStop
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- TransitDetailsLocalizedValues
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- LocalizedTime
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- TransitLine
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- TransitAgency
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- TransitVehicle
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- TransitVehicleType
- RouteLegTravelAdvisory
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- RouteLegLocalizedValues
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- StepsOverview
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- MultiModalSegment
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Fenêtre d'affichage
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- RouteLocalizedValues
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- GeocodingResults
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- GeocodedWaypoint
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
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 d'un en-tête HTTP/gRPC X-Goog-FieldMask
(voir les paramètres et en-têtes 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 sur la création des chemins d'accès aux champs.
Par exemple, dans cette méthode:
- Masque de champ de tous les champs disponibles (pour inspection manuelle):
X-Goog-FieldMask: *
- Masque de champ pour la durée, la distance et 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 avec caractère générique (*
) ou de spécifier le masque de champ au niveau supérieur (routes
), pour les raisons suivantes:
- En sélectionnant uniquement les champs dont vous avez besoin, vous permettez à notre serveur d'économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
- Sélectionner uniquement les champs dont vous avez besoin dans 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 un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs du niveau supérieur, vous risquez de constater une dégradation des performances. En effet, tout nouveau champ ajouté sera automatiquement inclus dans la réponse.
- En ne sélectionnant que les champs dont vous avez besoin, vous pouvez réduire la taille de réponse 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 sur l'itinéraire (à l'exclusion des terminaux) permettant de s'arrêter à ou de passer. Jusqu'à 25 points de cheminement intermédiaires sont acceptés. |
travelMode |
Facultatif. Spécifie le mode de transport. |
routingPreference |
Facultatif. Spécifie comment calculer 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 génère une erreur ou une latence plus longue, une erreur est renvoyée. Vous ne pouvez spécifier cette option que lorsque |
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 correspond par défaut à l'heure à laquelle vous avez effectué la requête. REMARQUE: Vous ne pouvez spécifier une Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
arrivalTime |
Facultatif. Heure d'arrivée. REMARQUE: Ne peut être défini que lorsque Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
computeAlternativeRoutes |
Facultatif. Indique s'il faut calculer des itinéraires bis 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 itinéraires sont calculés. |
languageCode |
Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la section Identifiant de paramètres régionaux Unicode. Consultez la page Langues acceptées pour obtenir la liste des langues disponibles. 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 forme de valeur ccTLD ("domaine de premier niveau") à deux caractères. Pour en savoir plus, consultez Domaines de premier niveau de premier niveau de code pays. |
units |
Facultatif. Spécifie les unités de mesure des 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. 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, un calcul d'itinéraire de référence |
extraComputations[] |
Facultatif. Liste des calculs supplémentaires pouvant être utilisés pour finaliser 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 affecte la valeur renvoyée dans le champ de durée de |
transitPreferences |
Facultatif. Spécifie les préférences qui influencent la route renvoyée pour les routes |
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 n'est pas en mesure de calculer les résultats des itinéraires 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 les informations de réponse de geocoding pour les points de cheminement spécifiés en tant qu'adresses. |
PolylineQuality
Ensemble de valeurs spécifiant 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 à l'aide de plus de points que OVERVIEW , au prix 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 d'aperçu, composée à l'aide d'un petit nombre de points. Utilisez cette valeur lorsque vous affichez un aperçu de la route. Cette option offre une latence de requête inférieure à celle de l'option HIGH_QUALITY . |
PolylineEncoding
Spécifie le type de polyligne souhaité à renvoyer.
Enums | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Aucune préférence de type de polyligne 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 LineString GeoJSON. |
ReferenceRoute
Route 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. Les itinéraires associés à cette valeur sont déterminés comme optimisés pour des paramètres tels que la consommation de carburant. |
ExtraComputation
Calculs supplémentaires à effectuer pour traiter la requête.
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 |
Consommation de carburant estimée de l'itinéraire. |
TRAFFIC_ON_POLYLINE |
Polylignes tenant compte du 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. Ce contenu n'est destiné qu'à être affiché. Ne l'analysez pas par programmation. |
Itinéraire
Contient un itinéraire composé d'une série de segments de route reliés entre eux, qui rejoignent des points de cheminement de départ, d'arrivée et intermédiaires.
Représentation JSON |
---|
{ "routeLabels": [ enum ( |
Champs | |
---|---|
routeLabels[] |
Libellés pour |
legs[] |
Ensemble de sections (segments de chemin entre des points de cheminement) qui constituent l'itinéraire. Chaque section correspond au trajet entre deux |
distanceMeters |
Distance parcourue en mètres. |
duration |
Temps nécessaire pour parcourir l'itinéraire. Si vous définissez Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
staticDuration |
Durée du trajet sur l'itinéraire 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 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 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 d'itinéraire encodé en base64 et adapté au Web, qui peut être transmis au SDK Navigation, qui permet à ce dernier de reconstruire l'itinéraire pendant la navigation et, en cas de réitinéraire, d'honorer l'intention initiale lorsque vous avez créé l'itinéraire en appelant v2.computeRoutes. Les clients doivent traiter ce jeton comme un blob opaque. Ne comparez pas sa valeur entre les requêtes. Ce jeton peut changer même si exactement le même itinéraire a été renvoyé. REMARQUE: |
RouteLabel
Libellés pour
utiles pour identifier les propriétés spécifiques de l'itinéraire afin de les comparer aux autres.Route
Enums | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
Par défaut : non utilisé. |
DEFAULT_ROUTE |
La valeur par défaut "best" pour le calcul de la route. |
DEFAULT_ROUTE_ALTERNATE |
Une alternative au "meilleur" par défaut via un routage réseau. Des 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 déterminés comme étant optimisés pour des paramètres éco tels que la consommation de carburant. |
RouteLeg
Contient un segment entre des points de cheminement autres que via
.
Représentation JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Champs | |
---|---|
distanceMeters |
Distance de trajet de la section de l'itinéraire, exprimée en mètres. |
duration |
Temps nécessaire pour parcourir l'étape. Si Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
staticDuration |
Durée du trajet du trajet, 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 section, qui inclut les polylignes 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 des étapes indiquant 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 un trajet. |
localizedValues |
Représentations textuelles des propriétés de |
stepsOverview |
Présentation des informations sur les étapes dans ce |
Polyline
Encapsule une polyligne encodée.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union polyline_type . Encapsule le type de polyligne. La valeur par défaut est "encodé_polyligne". polyline_type ne peut être qu'un des éléments suivants : |
|
encodedPolyline |
L'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. |
RouteLegStep
Contient un segment de
. Une étape correspond à une seule instruction de navigation. Les sections de l'itinéraire sont constituées de marches.RouteLeg
Représentation JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Champs | |
---|---|
distanceMeters |
Distance de trajet de cette étape, en mètres. Dans certains cas, il est possible que ce champ ne contienne pas de valeur. |
staticDuration |
Durée du trajet pour cette étape, sans tenir compte des conditions de circulation. Dans certains cas, il est possible que ce champ ne contienne pas 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 |
Lieu de départ de cette étape. |
endLocation |
Fin 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 trafic, sur une étape de l'itinéraire. |
localizedValues |
Représentations textuelles des propriétés de |
transitDetails |
Informations sur cette étape si le mode de transport est |
travelMode |
Mode de transport utilisé pour cette étape. |
Manœuvre
Ensemble de valeurs qui spécifient l'action de navigation à effectuer pour l'étape actuelle (par exemple, tourner à gauche, fusionner ou droite).
Enums | |
---|---|
MANEUVER_UNSPECIFIED |
Non utilisé. |
TURN_SLIGHT_LEFT |
Tournez légèrement vers la gauche. |
TURN_SHARP_LEFT |
Tournez brusquement vers la gauche. |
UTURN_LEFT |
Faites demi-tour sur la gauche. |
TURN_LEFT |
Tournez à gauche. |
TURN_SLIGHT_RIGHT |
Tournez légèrement sur la droite. |
TURN_SHARP_RIGHT |
Tournez brusquement vers la droite. |
UTURN_RIGHT |
Faites demi-tour sur la droite. |
TURN_RIGHT |
Tournez à droite. |
STRAIGHT |
Allez tout droit. |
RAMP_LEFT |
Prendre la rampe à gauche. |
RAMP_RIGHT |
Prenez la rampe à droite. |
MERGE |
Fusionner dans le trafic. |
FORK_LEFT |
Prenez la bifurcation à gauche. |
FORK_RIGHT |
Prenez la droite. |
FERRY |
Prendre le ferry. |
FERRY_TRAIN |
Prenez le train qui mène au ferry. |
ROUNDABOUT_LEFT |
Au rond-point, tournez à gauche. |
ROUNDABOUT_RIGHT |
Au rond-point, tournez à droite. |
DEPART |
Manœuvre initiale. |
NAME_CHANGE |
Utilisé pour 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 trafic sur une étape de l'itinéraire.
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 au format texte. |
staticDuration |
Durée sans tenir compte des conditions de circulation, représentée sous forme de texte. |
RouteLegStepTransitDetails
Informations supplémentaires pour 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 |
Indique 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 la station terminus. |
headway |
Spécifie l'heure prévue en tant que 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 à une attente de 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 l'arrêt de départ et l'arrêt d'arrivée. Ce nombre inclut l'arrêt d'arrivée, mais exclut celui 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 permettre aux usagers d'identifier un trajet en transports en commun. Le texte doit identifier de manière unique un trajet au cours d'une journée de service. Exemple : "538" est le |
TransitStopDetails
Détails sur les arrêts de transports en commun pour le RouteLegStep
.
Représentation JSON |
---|
{ "arrivalStop": { object ( |
Champs | |
---|---|
arrivalStop |
Informations sur l'arrêt d'arrivée de l'étape. |
arrivalTime |
Heure d'arrivée estimée de l'étape. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
departureStop |
Informations sur l'arrêt de départ de l'étape. |
departureTime |
Heure de départ estimée de l'étape. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. 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 mise en forme avec le fuseau horaire correspondant. |
departureTime |
Heure dans sa représentation textuelle mise en forme 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. 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[] |
Agence (ou agences) de transports en commun qui gère cette ligne de transports en commun. |
name |
Nom complet de cette ligne de transports en commun (par exemple, "8 Avenue des Champs-Élysées"). |
uri |
URI de cette ligne de transports en commun fourni par l'agence de transports en commun. |
color |
Couleur couramment utilisée pour la signalisation de cette ligne. Représenté au format hexadécimal. |
iconUri |
URI de l'icône associée à cette ligne. |
nameShort |
Nom court de cette ligne de transports en commun. Ce nom correspond généralement à un numéro de ligne, tel que "M7" ou "355". |
textColor |
Couleur couramment utilisée dans le texte de la signalisation associée à cette ligne. Représenté au format hexadécimal. |
vehicle |
Type de véhicule circulant sur cette ligne de transports en commun. |
TransitAgency
Agence de transports en commun gérant 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 au format régional de l'agence de transports en commun. |
uri |
URI de l'agence de transports en commun. |
TransitVehicle
Informations sur un véhicule utilisé sur les itinéraires en 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ée à ce type de véhicule, en fonction des panneaux de transports en commun locaux. |
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 de l'étape, comme les éventuelles restrictions de zone de trafic.
Représentation JSON |
---|
{ "tollInfo": { object ( |
Champs | |
---|---|
tollInfo |
Contient des informations sur les péages pour le |
speedReadingIntervals[] |
Intervalles de lecture de la vitesse indiquant la densité du trafic Applicable dans le cas des 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 au format 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 identique à "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[] |
Résumé des informations concernant différents segments multimodaux de |
MultiModalSegment
Fournit des informations résumées sur les différents segments multimodaux de RouteLeg.steps
. Un segment multimodal est défini comme un ou plusieurs éléments 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
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 région fermée (elle inclut ses limites). 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 différents cas de figure:
Si
low
=high
, la fenêtre d'affichage est constituée de ce seul point.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 longitudes est vide.Si
low.latitude
>high.latitude
, la plage de latitude 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 spécifié dans les définitions ci-dessus). Si la fenêtre d'affichage est vide, cela génère une erreur.
Par exemple, cette fenêtre d'affichage englobe 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 au format texte. |
duration |
Durée tenant compte des conditions de circulation, représentée sous forme de 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 sous forme de texte. |
transitFare |
Tarif de transports en commun représenté au format texte. |
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 géocodé à l'origine. |
destination |
Point de cheminement géocodé de la destination. |
intermediates[] |
Liste de points de cheminement géocodés intermédiaires contenant chacun un champ d'index qui correspond à la position du point de cheminement basée sur zéro, dans l'ordre dans lequel ils ont été spécifiés dans la requête. |
GeocodedWaypoint
Informations sur les emplacements utilisés comme points de cheminement. Renseigné uniquement pour les points de cheminement d'adresse. Comprend des détails sur les résultats de geocoding afin de déterminer à quel endroit 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[] |
Type(s) du résultat, sous la forme de zéro, une ou plusieurs balises de type. Types acceptés: 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. |