Zu verwendenden Traffic-Modelltyp angeben

Verkehrsmodelle verwenden bestimmte Algorithmen und Faktoren, um vorherzusagen, wie sich die Verkehrslage auf die Gesamtfahrzeit einer bestimmten Route auswirkt. Die Routes API bietet verschiedene Trafficmodelltypen, um verschiedene Faktoren zu priorisieren, die bei der Berechnung der Dauer des Traffics verwendet werden. Sie können den Typ des Verkehrsmodells angeben, den Ihre Routen bei der Berechnung 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 wird für beide Methoden das Verkehrsmodell BEST_GUESS verwendet.

So legen Sie einen Traffic-Typ fest

  1. Legen Sie Start- und Zielort fest.

  2. Wenn Ihre Abfahrtszeit in der Zukunft liegt, geben Sie sie mithilfe des Parameters departure_time an. Wenn Sie keine Abfahrtszeit angeben, wird standardmäßig die aktuelle Uhrzeit verwendet.

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

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

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

    • OPTIMISTIC, um anzufordern, dass das zurückgegebene duration_in_traffic-Objekt die Zeit anhand der bisherigen Verkehrsbedingungen an Tagen mit guten Verkehrsdaten modelliert. Dieser Typ gibt eine geschätzte Reisedauer an, die höchstwahrscheinlich kürzer ist als die tatsächliche Reisezeit an den meisten Tagen. Gelegentliche Tage mit besonders guten Bedingungen können dennoch schneller als diese Schätzung sein.

    Beispiel: 

    "trafficModel": "OPTIMISTIC"

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

    REST

    -H X-Goog-FieldMask: routes.duration

    RPC

    const (fieldMask = "routes.duration")

Wenn die Routes API die Reisezeit schätzt, verwendet sie den von Ihnen angeforderten Trafficmodelltyp.

Beispiel: Anfrage für ein Verkehrsmodell

Diese Anfrage gibt beispielsweise an, dass die Dauer mit dem Verkehrsmodelltyp OPTIMISTIC zu einer bestimmten Abfahrtszeit geschätzt werden soll:

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 mit dem Verkehrsmodelltyp OPTIMISTIC für die Fahrt zurück:

"duration": "1238s"

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

"duration": "2436s"