Indiquez comment et si vous souhaitez inclure les données sur le trafic

Les préférences de trafic que vous sélectionnez équilibrent la précision des détails de l'itinéraire avec les performances des requêtes. Lorsque vous faites une demande, vous devez déterminer il est préférable de renvoyer les résultats les plus précis possibles, ou de renvoyer les résultats le plus rapidement possible. L'API Routes fournit des options qui vous permettent de contrôler la qualité des données de réponse par rapport à la latence de la réponse.

Attention :Les requêtes qui utilisent TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL sont facturées à un taux plus élevé. En savoir plus sur la facturation

Définir le niveau des données sur le trafic

L'API Routes fournit RoutingPreference (REST) et RoutingPreference (gRPC) qui vous permettent de spécifier les préférences de routage pour le calcul des routes. Ces les préférences diffèrent dans le sens où elles tiennent compte des conditions de circulation calcul d'itinéraire. Chaque préférence de routage produit des résultats différents en ce qui concerne la qualité des routes, l'heure d'arrivée prévue estimée et la latence de réponse.

Les conditions de circulation définissent la vitesse de circulation. Exemple :

• En l'absence d'embouteillages, les conditions de circulation sont considérées comme normales. le trafic circule à la vitesse normale sans entrave.
• À l'approche de l'heure de pointe, la densité du trafic augmente, ce qui entraîne ralentissent, entraînant des conditions de circulation faibles à modérées.
• Dans un trafic de pare-chocs à pare-chocs, le débit s'interrompt, produisant les conditions de circulation.

Non sensible au trafic

Lorsque vous définissez la préférence de routage TRAFFIC_UNAWARE, les routes sont calculées sans tenir compte des conditions de circulation actuelles. Cette préférence de routage fournit la latence de réponse la plus faible (les réponses sont renvoyées le plus rapidement).

TRAFFIC_UNAWARE est le paramètre par défaut.

Si vous choisissez TRAFFIC_UNAWARE, l'itinéraire et la durée choisis sont basés sur le réseau routier et la durée moyenne les conditions de circulation, et non l'état actuel des routes. Par conséquent, l'itinéraire peut inclure des routes temporairement fermées. Les résultats d'une requête donnée peuvent varier au fil du temps en raison des modifications du réseau routier, de l'évolution des conditions de circulation moyennes et de la nature décentralisée du service. Les résultats peuvent également varier des itinéraires presque équivalents, à tout moment et à n'importe quelle fréquence.

Dans la réponse :

• L'heure d'arrivée prévue est contenue dans la propriété de réponse duration.

• Les propriétés de réponse duration et staticDuration contiennent les mêmes .

Utilisez cette préférence de routage lorsque vous souhaitez que les réponses soient renvoyées le plus rapidement possible. les détails d'un itinéraire approximatif sont suffisants.

Remarque :Ce paramètre est équivalent lorsque le trafic actuel n'est pas utilisé dans le API Directions et Distance Matrix

Sensible au trafic

Lorsque vous définissez la préférence de routage TRAFFIC_AWARE, les routes sont calculées en tenant compte des conditions de circulation actuelles. Par conséquent, l'itinéraire et le routage les détails reflètent plus précisément les conditions du monde réel. Étant donné que cette augmentation la qualité des données se fait au détriment de la latence des réponses, de l'optimisation des performances pour réduire une grande partie de la latence.

Dans la réponse :

• L'heure d'arrivée prévue qui prend en compte le trafic en temps réel est contenue dans le champ Propriété de réponse duration.

• La propriété de réponse staticDuration contient la durée du voyage. sur l'itinéraire sans tenir compte des conditions de circulation.

Utilisez cette préférence lorsque vous souhaitez obtenir des informations plus précises que TRAFFIC_UNAWARE. Pour autant, cela ne vous dérange pas que les réponses soient renvoyées avec une augmentation modérée de la latence.

Remarque :Ce paramètre est nouveau pour l'API Routes et n'a pas d'équivalent dans le API Directions et Distance Matrix

Optimisation basée sur le trafic

Lorsque vous définissez la préférence de routage TRAFFIC_AWARE_OPTIMAL, les routes sont sont calculées en tenant compte des conditions de circulation actuelles, mais pas optimisées sont appliquées. Dans ce mode, le serveur effectue une analyse plus exhaustive du réseau routier pour trouver l'itinéraire optimal.

La préférence de routage TRAFFIC_AWARE_OPTIMAL est équivalente au mode utilisé par sur maps.google.com et par Application mobile Google Maps

Lorsque vous utilisez cette option avec Compute Route Matrix, le nombre de dans une requête (nombre d'origines × nombre de destinations) ne peut pas dépasser 100. Pour en savoir plus sur les limites de Compute Route Matrix, consultez Calculer une matrice de routage

Dans la réponse :

• L'heure d'arrivée prévue qui prend en compte le trafic en temps réel est contenue dans le champ Propriété de réponse duration.

• La propriété de réponse staticDuration contient la durée du voyage. sur l'itinéraire sans tenir compte des conditions de circulation.

Cette préférence de routage fournit la latence de réponse la plus élevée (c'est-à-dire les réponses renvoyées avec le délai le plus long). Utilisez cette préférence de routage lorsque vous souhaitent obtenir des résultats de la meilleure qualité possible, quelle que soit la durée des réponses.

Remarque :Cette option équivaut à spécifier departure_time dans la propriété API Directions et Distance Matrix

Effet de la définition de l'heure de départ

Vous pouvez éventuellement utiliser la propriété departureTime pour définir l'heure de départ d'un voyage. Si vous ne définissez pas la propriété departureTime, elle est définie par défaut sur au moment de la demande.

• Pour TRAFFIC_UNAWARE, vous ne pouvez pas définir departureTime, car la sélection l'itinéraire et la durée sont basés sur le réseau routier et sont indépendants de la durée moyenne. les conditions de circulation.

• Pour TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL, qui acceptent les conditions de circulation en temps réel les conditions de circulation en temps réel, plus proche de departureTime de maintenant. Plus vous définissez l'heure de départ plus il est important de tenir compte de l'historique du trafic. et conditions d'exploitation.

Exemple de définition des préférences de routage

Le code JSON suivant montre comment définir la préférence de routage dans une corps de l'entité de message de la requête.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}

Configurer le trafic sur les polylignes

L'API Routes vous permet de demander des informations sur les conditions de circulation le long d'une polyligne tenant compte du trafic. Voir Pour en savoir plus, demandez des polylignes.