Zu verwendenden Traffic-Modelltyp angeben

Trafficmodelle nutzen bestimmte Algorithmen und Faktoren, um vorherzusagen, wie sich die Verkehrslage auf die Gesamtfahrzeit einer bestimmten Route auswirkt. Die Routes API bietet verschiedene Arten von Trafficmodellen, um verschiedene Faktoren zu priorisieren, die bei der Berechnung der Trafficdauer verwendet werden. Sie können den Typ des Verkehrsmodells angeben, den Ihre Routen beim Berechnen der Dauer Ihrer Routen oder der Routenmatrix verwenden sollen. Wenn Sie den Typ des Trafficmodells festlegen, variiert der im Feld duration zurückgegebene Wert je nach ausgewähltem Trafficmodell.

Die Methoden Compute Routes und Compute Route Matrix der Routes API 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. Wenn Ihre Abfahrtszeit in der Zukunft liegt, geben Sie sie mit dem Parameter departure_time an. Wenn Sie keine Abreisezeit angeben, wird standardmäßig der aktuelle Wert verwendet.

  3. Wählen Sie das Trafficmodell aus, das mit dem Parameter trafficModel und einem der folgenden Typen verwendet werden soll:

    • BEST_GUESS (Standard), um anzufordern, dass die zurückgegebene duration_in_traffic die beste Schätzung der Reisezeit ist. Dazu werden Informationen zur bisherigen Verkehrslage und zur aktuellen Verkehrslage herangezogen. Die aktuelle Verkehrslage wird umso stärker gewichtet, je näher die departure_time rückt. Wenn Sie den Standardtyp BEST_GUESS verwenden, erhalten Sie für die meisten Anwendungsfälle die nützlichsten Vorhersagen.

    • PESSIMISTIC, um anzufordern, dass der zurückgegebene duration_in_traffic die Zeit anhand der bisherigen Verkehrsbedingungen an Tagen mit schlechtem Verkehr modelliert. Bei diesem Typ wird eine geschätzte Reisezeit angegeben, die höchstwahrscheinlich länger ist als die tatsächliche Reisezeit an den meisten Tagen. Gelegentliche Tage mit besonders schlechten Bedingungen können diese Schätzung dennoch überschreiten.

    • OPTIMISTIC, um anzufordern, dass der zurückgegebene duration_in_traffic die Zeit anhand der bisherigen Verkehrslage an Tagen mit guter Verkehrslage modelliert. Bei diesem Typ wird eine geschätzte Reisezeit angegeben, die höchstwahrscheinlich kürzer ist als die tatsächliche Reisezeit an den meisten Tagen. Gelegentliche Tage mit besonders guten Bedingungen können trotzdem länger dauern 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, verwendet sie den von Ihnen angeforderten Traffic-Modelltyp.

Beispiel: Trafficmodell-Anfrage

Die folgende Anfrage gibt beispielsweise an, dass die Dauer mithilfe des Verkehrsmodelltyps OPTIMISTIC zu einer bestimmten Abfahrtszeit geschätzt wird:

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'

Bei dieser Anfrage wird die geschätzte Dauer mithilfe des Verkehrsmodelltyps OPTIMISTIC für die Fahrt zurückgegeben:

"duration": "1238s"

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

"duration": "2436s"