Zu verwendenden Traffic-Modelltyp angeben

Trafficmodelle nutzen bestimmte Algorithmen und Faktoren, um vorherzusagen, Bedingungen wirken sich auf die Gesamtreisezeit für eine bestimmte Route aus. Routes API verschiedene Arten von Traffic-Modellen zur Priorisierung verschiedener Faktoren die Berechnung der Dauer von Zugriffen. Sie können den Typ des Traffic-Modells angeben, die für die Berechnung der Dauer Ihrer Routen oder Routen verwendet werden, Matrixstruktur. Wenn Sie den Typ des Traffic-Modells festlegen, wird der im Das Feld duration variiert je nach ausgewähltem Traffic-Modell.

Sowohl die Compute Routes als auch die Routes API Compute Route Matrix-Methoden unterstützen Trafficmodelltypen.

Standardmäßig verwenden beide Methoden den Traffic-Modelltyp BEST_GUESS.

So legen Sie einen Traffic-Typ fest:

1. Legen Sie Ihren Start- und Zielort fest.

2. Falls Ihre Abreise in der Zukunft liegt, geben Sie die Zeit mithilfe des departure_time-Parameter. Wenn Sie keine Abfahrtszeit angeben, ist standardmäßig „jetzt“.

3. Wählen Sie das Traffic-Modell aus, das mit dem Parameter trafficModel verwendet werden soll, und einer der folgenden Typen:

   • BEST_GUESS (Standard), um anzufordern, dass die zurückgegebene duration_in_traffic ist die beste Schätzung der Reisezeit unter Berücksichtigung dessen, was über beides bekannt ist Informationen zur aktuellen Verkehrslage und zur aktuellen Verkehrslage. Die aktuelle Verkehrslage nimmt zu umso wichtiger ist der departure_time. Standardtyp verwenden der BEST_GUESS liefert die nützlichsten Vorhersagen für die überwiegende Mehrheit der Anwendungsfälle.

   • PESSIMISTIC, um anzufordern, dass die zurückgegebene duration_in_traffic das Modell des basierend auf den bisherigen Verkehrsbedingungen an Tagen mit schlechtem Verkehr. Bei diesem Typ wird eine geschätzte Dauer angegeben, die höchstwahrscheinlich länger ist als die tatsächliche Reisezeit an den meisten Tagen. Gelegentliche besonders schlechte Tage kann diese Schätzung dennoch übersteigen.

   • OPTIMISTIC, um anzufordern, dass die zurückgegebene duration_in_traffic das Modell des basierend auf den bisherigen Verkehrsbedingungen an Tagen mit guter Verkehrslage. Bei diesem Typ wird eine geschätzte Dauer angegeben, die höchstwahrscheinlich kürzer ist als die tatsächliche Reisezeit an den meisten Tagen. Gelegentliche Tage mit besonders unter guten Bedingungen möglicherweise trotzdem schneller als diese Schätzung.

   Beispiel:

   "trafficModel": "OPTIMISTIC"

4. Geben Sie in der Feldmaske das Feld routes.duration an.

   REST

   -H X-Goog-FieldMask: routes.duration

   RPC

   const (fieldMask = "routes.duration")

Wenn die Routes API die Zeit im Traffic schätzt, nutzt sie den Traffic den von Ihnen angeforderten Modelltyp.

Beispiel: Trafficmodell-Anfrage

Die Anfrage gibt beispielsweise an, dass die Dauer mithilfe der Methode OPTIMISTIC-Verkehrsmodelltyp bei einer bestimmten Abfahrtszeit:

curl -X POST -H 'content-type: application/json' -d ' {
"origin": {
  "address": "Kyoto, Japan"
  },
"destination": {
  "placeId": "ChIJrYtcv-urAWAR3XzWvXv8n_s"
  },
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE_OPTIMAL",
"trafficModel": "OPTIMISTIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Diese Anfrage gibt die geschätzte Dauer mithilfe des Trafficmodells „OPTIMISTIC“ zurück Art der Fahrt:

"duration": "1238s"

Wenn Sie den Typ des Trafficmodells in PESSIMISTIC ändern, ist die zurückgegebene Dauer länger:

"duration": "2436s"