Method: computeRoutes

Renvoie l'itinéraire principal entre le point de départ et la destination demandés pour le mode de transport demandé.

Requête HTTP

POST https://mapstools.googleapis.com/v1: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)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "departureTime": string,
  "arrivalTime": string
  // End of mutually exclusive fields.
}
Champs
origin

object (Waypoint)

Obligatoire. Point de cheminement de départ.
destination

object (Waypoint)

Obligatoire. Point de cheminement de destination.
travelMode

enum (RouteTravelMode)

Facultatif. Spécifie le mode de transport.
intermediateWaypoints[]

object (Waypoint)

Facultatif. Arrêts intermédiaires entre le point de départ et la destination, à traverser dans l'ordre. Vous pouvez ajouter jusqu'à 25 points de cheminement intermédiaires.

Si vous spécifiez plus de 10 points de cheminement intermédiaires, les coûts et la latence seront plus élevés. Les points de cheminement intermédiaires ne sont pas acceptés lorsque travelMode est défini sur TRANSIT.
routingPreference

enum (RoutingPreference)

Facultatif. Détermine comment les données de trafic sont utilisées pour calculer l'itinéraire. ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL n'est pas compatible lorsque travelMode est défini sur WALK ou BICYCLE. Pour TRANSIT, il permet d'obtenir des données en temps réel sur les transports en commun, telles que les retards et les annulations.
locationBias

object (LatLng)

Facultatif. Un lieu vers lequel orienter les résultats de recherche, par exemple pour lever l'ambiguïté des requêtes textuelles de points de cheminement.
includePolyline

boolean

Facultatif. Indique si la polyligne encodée doit être incluse dans les itinéraires de la réponse. La valeur par défaut est false. Lorsque la valeur est définie sur true, Route.encoded_polyline est renvoyé.
computeAlternativeRoutes

boolean

Facultatif. Indique s'il faut calculer des itinéraires alternatifs en plus de l'itinéraire recommandé. La valeur par défaut est "false", auquel cas seul l'itinéraire recommandé est renvoyé. Lorsque la valeur est "true", tous les itinéraires disponibles sont renvoyés, bien que des alternatives ne soient pas disponibles pour chaque requête.
Indique quand partir du point de départ ou arriver au point de cheminement final. Si aucune valeur n'est spécifiée, l'heure de départ par défaut est l'heure actuelle. Pour TRANSIT, l'heure doit être comprise entre sept jours dans le passé et 100 jours dans le futur. Pour les autres modes de transport, l'heure ne doit pas être passée et doit être comprise dans les 365 prochains jours. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
departureTime

string (Timestamp format)

Facultatif. Indique que l'itinéraire doit être calculé en fonction de l'heure de départ.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
arrivalTime

string (Timestamp format)

Facultatif. Indique que l'itinéraire doit être calculé en fonction de l'heure d'arrivée.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
Fin des champs mutuellement exclusifs.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de ComputeRoutesResponse.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

  • https://www.googleapis.com/auth/maps-platform.mapstools