Method: computeRoutes

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 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 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 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 l'inspection manuelle): X-Goog-FieldMask: *
  • Masque de champ de durée, distance et 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 de ce masque de champ au niveau supérieur (routes) pour les raisons suivantes:

  • Sélectionner uniquement les champs dont vous avez besoin permet à notre serveur d'économiser des cycles de calcul et de vous renvoyer le résultat avec une latence plus faible.
  • Sélectionner uniquement les champs dont vous avez besoin pour votre job de production garantit des performances de latence stables. Nous pourrions ajouter 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 au niveau supérieur, vous risquez de constater une dégradation des performances, car tout nouveau champ que nous ajoutons sera 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 (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
Champs
origin

object (Waypoint)

Obligatoire. Point de cheminement de départ.

destination

object (Waypoint)

Obligatoire. Point de cheminement de destination.

intermediates[]

object (Waypoint)

Facultatif. Ensemble de points de cheminement sur l'itinéraire (à l'exclusion des terminaux) permettant de s'arrêter ou de passer à proximité. Vous pouvez ajouter jusqu'à 25 points de cheminement intermédiaires.

travelMode

enum (RouteTravelMode)

Facultatif. Spécifie le mode de transport.

routingPreference

enum (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 entraîne une erreur ou une latence extra longue, une erreur est renvoyée. Vous ne pouvez spécifier cette option que si travelMode est défini sur DRIVE ou TWO_WHEELER. Sinon, la requête échoue.

polylineQuality

enum (PolylineQuality)

Facultatif. Indique votre préférence pour la qualité de la polyligne.

polylineEncoding

enum (PolylineEncoding)

Facultatif. Spécifie l'encodage préféré pour la polyligne.

departureTime

string (Timestamp format)

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 définir un champ departureTime par le passé que si RouteTravelMode est défini sur TRANSIT. Les trajets en transports en commun sont disponibles pour les sept derniers jours ou les 100 prochains jours.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

arrivalTime

string (Timestamp format)

Facultatif. Heure d'arrivée. REMARQUE: Ne peut être défini que lorsque RouteTravelMode est défini sur TRANSIT. Vous pouvez spécifier departureTime ou arrivalTime, mais pas les deux. Les trajets en transports en commun sont disponibles pour les sept derniers jours ou les 100 prochains jours.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

computeAlternativeRoutes

boolean

Facultatif. Indique si des itinéraires alternatifs doivent être calculés 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

object (RouteModifiers)

Facultatif. Ensemble de conditions à remplir qui affectent le mode de calcul des itinéraires.

languageCode

string

Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour plus d'informations, consultez la section 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

string

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

enum (Units)

Facultatif. Spécifie les unités de mesure des champs d'affichage. Ces champs incluent le champ instruction dans NavigationInstruction. Cette valeur n'a aucune incidence sur les unités de mesure utilisées pour l'itinéraire, le trajet, la distance de pas et la durée. Si vous ne fournissez pas cette valeur, les unités d'affichage sont déduites de l'emplacement du premier point de départ.

optimizeWaypointOrder

boolean

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 via. Utilisez ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index pour rechercher le nouvel ordre. Si ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index n'est pas demandé dans l'en-tête X-Goog-FieldMask, la requête échoue. Si optimizeWaypointOrder est défini sur "false", ComputeRoutesResponse.optimized_intermediate_waypoint_index sera vide.

requestedReferenceRoutes[]

enum (ReferenceRoute)

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 associée à un objectif de calcul différent de celui de la route par défaut. Par exemple, le calcul d'un itinéraire de référence FUEL_EFFICIENT tient compte de différents paramètres permettant de générer un itinéraire économe en carburant optimal.

extraComputations[]

enum (ExtraComputation)

Facultatif. Une liste de calculs supplémentaires pouvant être utilisés pour finaliser 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 pour être renvoyés dans la réponse.

trafficModel

enum (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 "Duration" des champs Route et RouteLeg, qui contient la durée prévue du trafic en fonction des moyennes historiques. TrafficModel n'est disponible que pour les requêtes dont la valeur RoutingPreference est définie sur TRAFFIC_AWARE_OPTIMAL et RouteTravelMode sur DRIVE. La valeur par défaut est BEST_GUESS si du trafic est demandé et que TrafficModel n'est pas spécifié.

transitPreferences

object (TransitPreferences)

Facultatif. Spécifie les préférences qui influencent l'itinéraire renvoyé pour les itinéraires TRANSIT. REMARQUE: Vous ne pouvez spécifier un élément transitPreferences que lorsque RouteTravelMode est défini sur TRANSIT.

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 (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
Champs
routes[]

object (Route)

Contient un tableau des itinéraires calculés (jusqu'à trois) lorsque vous spécifiez compute_alternatives_routes et ne contient qu'un seul itinéraire dans le cas contraire. Lorsque ce tableau contient plusieurs entrées, la première est l'itinéraire le plus recommandé. Si le tableau est vide, cela signifie qu'aucune route n'a pu être trouvée.

fallbackInfo

object (FallbackInfo)

Dans certains cas, lorsque le serveur n'est pas en mesure de calculer les résultats d'itinéraires avec toutes vos 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

object (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'a été spécifiée. La valeur par défaut est OVERVIEW.
HIGH_QUALITY Spécifie une polyligne de haute qualité, composée à l'aide d'un plus grand nombre de points que OVERVIEW, au détriment de la taille des réponses. 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 pour afficher une vue d'ensemble de l'itinéraire. Avec cette option, la latence des requêtes est plus faible que celle de l'option HIGH_QUALITY.

PolylineEncoding

Spécifie le type de polyligne préféré à renvoyer.

Enums
POLYLINE_ENCODING_UNSPECIFIED Aucune préférence spécifiée 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.

Unités

Ensemble de valeurs indiquant l'unité de mesure utilisée sur l'écran.

Enums
UNITS_UNSPECIFIED Unités de mesure non spécifiées. La valeur par défaut est l'unité de mesure déduite de la requête.
METRIC Unités de mesure des métriques.
IMPERIAL Unités de mesure impériales (anglais).

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 optimisés en fonction de 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 tenant compte du trafic pour le ou 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 de manière programmatique.

Route

Contient un itinéraire composé d'une série de sections de route reliées entre elles par des points de départ, d'arrivée et intermédiaires.

Représentation JSON
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string
}
Champs
routeLabels[]

enum (RouteLabel)

Libellés pour Route permettant d'identifier des propriétés spécifiques de l'itinéraire en vue de les comparer aux autres.

legs[]

object (RouteLeg)

Ensemble de sections (segments de chemin entre les points de cheminement) qui composent l'itinéraire. Chaque section correspond au trajet entre deux Waypoints non via. Par exemple, un itinéraire sans point de cheminement intermédiaire ne comporte qu'une seule section. Un itinéraire qui comprend un point de cheminement intermédiaire autre que via comporte deux sections. Un itinéraire qui comprend un point de cheminement via intermédiaire comporte une section. L'ordre des étapes correspond à l'ordre des points de cheminement de origin à intermediates, en passant par destination.

distanceMeters

integer

Distance de l'itinéraire, en mètres.

duration

string (Duration format)

Temps nécessaire pour parcourir l'itinéraire. Si vous définissez routingPreference sur TRAFFIC_UNAWARE, cette valeur est identique à staticDuration. Si vous définissez routingPreference sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, cette valeur est calculée en tenant compte des conditions de circulation.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple: "3.5s".

staticDuration

string (Duration format)

Durée du trajet pour 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 "s". Exemple: "3.5s".

polyline

object (Polyline)

Polyligne de l'itinéraire global. Cette polyligne est la polyligne combinée de tous les legs.

description

string

Description de l'itinéraire.

warnings[]

string

Tableau d'avertissements à afficher lors de l'affichage de l'itinéraire.

viewport

object (Viewport)

Cadre de délimitation de la fenêtre d'affichage de la polyligne.

travelAdvisory

object (RouteTravelAdvisory)

Informations supplémentaires sur l'itinéraire.

optimizedIntermediateWaypointIndex[]

integer

Si vous définissez optimizeWaypointOrder sur "true", ce champ contient l'ordre optimisé des points de cheminement intermédiaires. Sinon, ce champ est vide. Par exemple, si vous indiquez les points de cheminement de départ: Los Angeles, Points de cheminement intermédiaires: Dallas, Bangor, Phoenix, Destination: New York, et que l'ordre des points de cheminement intermédiaire optimisé est Phoenix, Dallas, Bangor, ce champ contient les valeurs [2, 0, 1]. L'index commence par 0 pour le premier point de cheminement intermédiaire indiqué dans l'entrée.

localizedValues

object (RouteLocalizedValues)

Représentations textuelles des propriétés de Route.

routeToken

string

Jeton d'itinéraire sécurisé en base64 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 changement d'itinéraire, de respecter l'intention initiale lorsque vous avez créé l'itinéraire en appelant v2.computeRoutes. Les clients doivent traiter ce jeton comme un blob opaque. Il n'est pas destiné à lire ou à modifier. REMARQUE: Route.route_token n'est disponible que pour les requêtes pour lesquelles ComputeRoutesRequest.routing_preference est défini sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL. Route.route_token n'est pas compatible avec les requêtes comportant des points de cheminement Via.

RouteLabel

Libellés pour Route permettant d'identifier des propriétés spécifiques de l'itinéraire en vue de les comparer aux autres.

Enums
ROUTE_LABEL_UNSPECIFIED Par défaut : non utilisé.
DEFAULT_ROUTE "meilleure" route par défaut renvoyée pour le calcul de l'itinéraire.
DEFAULT_ROUTE_ALTERNATE Alternative au "meilleur" itinéraire par défaut Ce type de route est renvoyé lorsque computeAlternativeRoutes est spécifié.
FUEL_EFFICIENT Itinéraire économe en carburant. Les itinéraires associés à cette valeur sont optimisés en fonction des paramètres éco comme 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 (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
Champs
distanceMeters

integer

Distance parcourue pour le trajet de l'itinéraire, en mètres.

duration

string (Duration format)

Temps nécessaire pour parcourir l'étape. Si route_preference est défini sur TRAFFIC_UNAWARE, cette valeur est identique à staticDuration. Si route_preference correspond à TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, cette valeur est calculée en tenant compte des conditions de circulation.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple: "3.5s".

staticDuration

string (Duration format)

Durée du trajet pour 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 "s". Exemple: "3.5s".

polyline

object (Polyline)

Polyligne globale de cette section, qui inclut la polyligne de chaque step.

startLocation

object (Location)

Lieu de départ de cette section. Cet emplacement peut être différent de l'origin fourni. Par exemple, lorsque le origin fourni ne se trouve pas à proximité d'une route, il s'agit d'un point sur la route.

endLocation

object (Location)

Lieu d'arrivée de cette section. Cet emplacement peut être différent de l'destination fourni. Par exemple, lorsque le destination fourni ne se trouve pas à proximité d'une route, il s'agit d'un point sur la route.

steps[]

object (RouteLegStep)

Tableau d'étapes indiquant les segments de cette section. Chaque étape représente une instruction de navigation.

travelAdvisory

object (RouteLegTravelAdvisory)

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

object (RouteLegLocalizedValues)

Représentations textuelles des propriétés de RouteLeg.

stepsOverview

object (StepsOverview)

Informations générales sur la procédure à suivre dans ce RouteLeg. Ce champ n'est renseigné que pour les itinéraires TRANSIT.

Polyline

Encapsule une polyligne encodée.

Représentation JSON
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
Champs
Champ d'union polyline_type. Encapsule le type de polyligne. La valeur par défaut est coded_polyline. polyline_type ne peut être qu'un des éléments suivants :
encodedPolyline

string

Encoder la chaîne de la polyligne à l'aide de l'algorithme d'encodage des polylignes

geoJsonLinestring

object (Struct format)

Spécifie une polyligne au format GeoJSON LineString.

RouteLegStep

Contient un segment de RouteLeg. Une étape correspond à une seule instruction de navigation. Les sections d'itinéraire sont composées d'étapes.

Représentation JSON
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
Champs
distanceMeters

integer

Distance parcourue pour cette étape, en mètres. Dans certains cas, ce champ peut ne pas comporter de valeur.

staticDuration

string (Duration format)

Durée du trajet pour cette étape sans tenir compte des conditions de circulation Dans certains cas, ce champ peut ne pas comporter de valeur.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple: "3.5s".

polyline

object (Polyline)

Polyligne associée à cette étape.

startLocation

object (Location)

Lieu de départ de cette étape.

endLocation

object (Location)

Lieu d'arrivée de cette étape.

navigationInstruction

object (NavigationInstruction)

des instructions de navigation ;

travelAdvisory

object (RouteLegStepTravelAdvisory)

Contient les informations supplémentaires dont l'utilisateur doit être informé sur une étape du parcours, telles que les éventuelles restrictions de zone de circulation.

localizedValues

object (RouteLegStepLocalizedValues)

Représentations textuelles des propriétés de RouteLegStep.

transitDetails

object (RouteLegStepTransitDetails)

Détails concernant cette étape si le mode de transport est TRANSIT.

travelMode

enum (RouteTravelMode)

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 complètement vers la gauche.
UTURN_LEFT Faites un 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 bonne rampe.
MERGE Fusionner dans les embouteillages.
FORK_LEFT Prendre la bifurcation à gauche.
FORK_RIGHT Prenez la bifurcation à droite.
FERRY Prenez le ferry.
FERRY_TRAIN Prendre 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 Indique 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 de l'étape.

Représentation JSON
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Champs
speedReadingIntervals[]

object (SpeedReadingInterval)

REMARQUE: Ce champ n'est pas renseigné pour le moment.

RouteLegStepLocalizedValues

Représentations textuelles de certaines propriétés.

Représentation JSON
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Champs
distance

object (LocalizedText)

Distance de trajet représentée sous forme de texte.

staticDuration

object (LocalizedText)

Durée sans tenir compte des conditions de circulation (représentée sous forme de texte).

RouteLegStepTransitDetails

Informations supplémentaires sur le RouteLegStep lié aux routes TRANSIT.

Représentation JSON
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
Champs
stopDetails

object (TransitStopDetails)

Informations sur les arrêts d'arrivée et de départ pour l'étape.

localizedValues

object (TransitDetailsLocalizedValues)

Représentations textuelles des propriétés de RouteLegStepTransitDetails.

headsign

string

Spécifie le sens du trajet sur cette ligne, tel qu'indiqué sur le véhicule ou à l'arrêt de départ. La destination est souvent celle du terminus.

headway

string (Duration format)

Spécifie actuellement l'heure prévue sous la forme d'une durée entre deux départs depuis le même arrêt. 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 neuf chiffres au maximum après la virgule et se terminant par "s". Exemple: "3.5s".

transitLine

object (TransitLine)

Informations sur la ligne de transports en commun utilisée à cette étape.

stopCount

integer

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, le champ "stopCount" renvoie la valeur 3.

tripShortText

string

Texte qui s'affiche sur les tableaux d'horaires et les panneaux d'affichage pour indiquer aux passagers un trajet en transports 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 tripShortText du train Amtrak qui part de San Jose (Californie) à 15h10 en semaine à destination de Sacramento (Californie).

TransitStopDetails

Informations sur les arrêts de transport en commun du RouteLegStep.

Représentation JSON
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
Champs
arrivalStop

object (TransitStop)

Informations sur l'arrêt d'arrivée pour l'étape.

arrivalTime

string (Timestamp format)

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 fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

departureStop

object (TransitStop)

Informations sur l'arrêt de départ pour l'étape.

departureTime

string (Timestamp format)

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 fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

TransitStop

Informations sur un arrêt de transports en commun.

Représentation JSON
{
  "name": string,
  "location": {
    object (Location)
  }
}
Champs
name

string

Nom de l'arrêt de transports en commun.

location

object (Location)

L'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 (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
Champs
arrivalTime

object (LocalizedTime)

Heure dans sa représentation textuelle formatée, avec un fuseau horaire correspondant.

departureTime

object (LocalizedTime)

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 (LocalizedText)
  },
  "timeZone": string
}
Champs
time

object (LocalizedText)

Heure spécifiée sous forme de chaîne dans un fuseau horaire donné.

timeZone

string

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 (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
Champs
agencies[]

object (TransitAgency)

Agence (s) de transports en commun qui dessert cette ligne de transports en commun.

name

string

Nom complet de cette ligne de transports en commun. Par exemple, "8 Avenue Local".

uri

string

URI de cette ligne de transports en commun, tel que fourni par l'agence de transports en commun.

color

string

Couleur couramment utilisée pour la signalisation de cette ligne. Représenté en hexadécimal.

iconUri

string

URI de l'icône associée à cette ligne.

nameShort

string

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

string

Couleur couramment utilisée dans le texte de la signalétique pour cette ligne. Représenté en hexadécimal.

vehicle

object (TransitVehicle)

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

string

Nom de l'agence de transports en commun.

phoneNumber

string

Numéro de téléphone au format spécifique aux paramètres régionaux de l'agence de transports en commun.

uri

string

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 (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
Champs
name

object (LocalizedText)

Nom du véhicule, en majuscule.

type

enum (TransitVehicleType)

Type de véhicule utilisé.

iconUri

string

URI d'une icône associée à ce type de véhicule.

localIconUri

string

URI de l'icône associé à ce type de véhicule, en fonction du panneau des transports 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, telles que les éventuelles restrictions de zone de circulation.

Représentation JSON
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Champs
tollInfo

object (TollInfo)

Contient des informations sur les péages du RouteLeg en question. Ce champ n'est renseigné que si des péages sont prévus sur la RouteLeg. Si ce champ est défini, mais que le sous-champ "estimatedPrice" n'est pas renseigné, cela signifie que la route contient des péages, mais que nous ne connaissons pas le prix estimé. Si ce champ n'existe pas, le RouteLeg n'est pas payant.

speedReadingIntervals[]

object (SpeedReadingInterval)

Intervalles de lecture de vitesse détaillant la densité du trafic. Applicable en cas de préférences de routage TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent la totalité de la polyligne de RouteLeg sans chevauchement. Le point de départ d'un intervalle spécifié est identique au point d'arrivée de l'intervalle précédent.

Exemple :

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

RouteLegLocalizedValues

Représentations textuelles de certaines propriétés.

Représentation JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Champs
distance

object (LocalizedText)

Distance de trajet représentée sous forme de texte.

duration

object (LocalizedText)

Durée en 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".

staticDuration

object (LocalizedText)

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 (MultiModalSegment)
    }
  ]
}
Champs
multiModalSegments[]

object (MultiModalSegment)

Résumé des informations concernant différents segments multimodaux de RouteLeg.steps. Ce champ n'est pas renseigné si RouteLeg ne contient aucun segment multimodal dans les étapes.

MultiModalSegment

Fournit un résumé des informations sur les différents segments multimodaux de la 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 (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
Champs
navigationInstruction

object (NavigationInstruction)

NavigationInstruction pour le segment multimodal.

travelMode

enum (RouteTravelMode)

Mode de transport du segment multimodal.

stepStartIndex

integer

L'indice RouteLegStep correspondant qui correspond au début d'un segment multimodal

stepEndIndex

integer

L'index RouteLegStep correspondant à la fin d'un segment multimodal

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, 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 est constituée 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 et high.longitude = 180 degrés, la fenêtre d'affichage inclut toutes les longitudes.

  • Si low.longitude = 180 degrés et high.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 être renseignés, et la zone représentée ne peut pas être vide (comme indiqué dans les définitions ci-dessus). Si la fenêtre d'affichage est vide, une erreur se produit.

Par exemple, cette fenêtre d'affichage affiche entièrement New York:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Représentation JSON
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Champs
low

object (LatLng)

Obligatoire. Point bas de la fenêtre d'affichage.

high

object (LatLng)

Obligatoire. Point haut de la fenêtre d'affichage.

RouteLocalizedValues

Représentations textuelles de certaines propriétés.

Représentation JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
Champs
distance

object (LocalizedText)

Distance de trajet représentée sous forme de texte.

duration

object (LocalizedText)

Durée en 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.

staticDuration

object (LocalizedText)

Durée sans tenir compte des conditions de circulation (représentée sous forme de texte).

transitFare

object (LocalizedText)

Tarif de transports en commun représenté sous forme de texte.

GeocodingResults

Contient GeocodedWaypoints pour les points de cheminement de départ, de destination et intermédiaires. Renseigné uniquement pour les points de cheminement d'adresse.

Représentation JSON
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
Champs
origin

object (GeocodedWaypoint)

Point de cheminement géocodé d'origine.

destination

object (GeocodedWaypoint)

Point de cheminement géocodé de la destination.

intermediates[]

object (GeocodedWaypoint)

Une liste de points de cheminement géocodés intermédiaires contenant chacun un champ d'index qui correspond à 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

Détails 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 laquelle l'adresse a été géocodée.

Représentation JSON
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
Champs
geocoderStatus

object (Status)

Indique le code d'état résultant de l'opération de geocoding.

type[]

string

Type(s) du résultat, sous la forme de zéro ou plusieurs balises de type. Types compatibles: types d'adresses et de composants d'adresse.

partialMatch

boolean

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

string

ID de lieu pour ce résultat.

intermediateWaypointRequestIndex

integer

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.