Zu verwendenden Traffic-Modelltyp angeben

Entwickler im Europäischen Wirtschaftsraum (EWR)

Verkehrsmodelle verwenden bestimmte Algorithmen und Faktoren, um vorherzusagen, wie sich die Verkehrsbedingungen auf die Gesamtzeit für eine bestimmte Route auswirken. Die Routes API bietet verschiedene Arten von Verkehrsmodellen, um unterschiedliche Faktoren zu priorisieren, die bei der Berechnung der Dauer im Verkehr verwendet werden. Sie können den Typ des Verkehrsmodells angeben, das für die Berechnung der Dauer Ihrer Routen oder Routenmatrix verwendet werden soll. Wenn Sie den Typ des Verkehrsmodells festlegen, variiert der im Feld duration zurückgegebene Wert je nach ausgewähltem Verkehrsmodell.

Sowohl die Routes API-Methode Compute Routes als auch die Methode Compute Route Matrix unterstützen Verkehrsmodelltypen.

Standardmäßig verwenden beide Methoden den Verkehrsmodelltyp BEST_GUESS.

Traffic-Typ angeben

  1. Legen Sie Start- und Zielort fest.

  2. Wenn Ihre Abfahrtszeit in der Zukunft liegt, geben Sie die Zeit mit dem Parameter departure_time an. Wenn Sie keine Abfahrtszeit angeben, wird standardmäßig die aktuelle Uhrzeit verwendet.

  3. Legen Sie für den Parameter routingPreference den Wert TRAFFIC_AWARE_OPTIMAL fest. Wenn Sie routingPreference auf TRAFFIC_UNAWARE oder TRAFFIC_AWARE festlegen, ist das nicht mit dem Parameter trafficModel kompatibel.

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

    • BEST_GUESS (Standardwert), um duration_in_traffic die beste Schätzung der Reisezeit zurückzugeben. Dazu werden Verlaufs- und Echtzeitdaten zur 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 die zurückgegebene duration_in_traffic die Zeit auf Grundlage der bisherigen Verkehrsbedingungen an Tagen mit schlechter Verkehrslage modelliert. Dieser Typ gibt eine geschätzte Dauer an, die an den meisten Tagen wahrscheinlich länger als die tatsächliche Reisezeit ist. An Tagen mit besonders schlechten Bedingungen kann diese Schätzung jedoch überschritten werden.

    • OPTIMISTIC, um anzufordern, dass die zurückgegebene duration_in_traffic die Zeit auf Grundlage der bisherigen Verkehrslage an Tagen mit guter Verkehrslage modelliert. Dieser Typ gibt eine geschätzte Dauer an, die an den meisten Tagen kürzer als die tatsächliche Reisezeit ist. An Tagen mit besonders guter Verkehrslage kann dieser Wert jedoch unterschritten werden.

    Beispiel: 

    "trafficModel": "OPTIMISTIC"

  5. 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 Fahrzeit schätzt, verwendet sie den von Ihnen angeforderten Verkehrsmodelltyp.

Beispiel: Anfrage für Verkehrsmodell

In dieser Anfrage wird beispielsweise angegeben, 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 für die Fahrt zurück, wobei der Verkehrstyp OPTIMISTIC verwendet wird:

"duration": "1238s"

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

"duration": "2436s"