Zu verwendenden Traffic-Modelltyp angeben

Traffic-Modelle verwenden bestimmte Algorithmen und Faktoren, um vorherzusagen, wie sich die Verkehrslage auf die Gesamtreisezeit für eine bestimmte Route auswirkt. Die Routes API bietet verschiedene Traffic-Modelltypen, um unterschiedliche Faktoren zu priorisieren, die bei der Berechnung der Dauer im Traffic verwendet werden. Sie können den Traffic-Modelltyp angeben, der für die Berechnung der Dauer für Ihre Routen oder Routenmatrix verwendet werden soll. Wenn Sie den Traffic-Modelltyp festlegen, variiert der im Feld duration zurückgegebene Wert je nach ausgewähltem Traffic-Modell.

Sowohl die Methoden Compute Routes als auch Compute Route Matrix der Routes API unterstützen Traffic-Modelltypen.

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

Traffic-Typ angeben

1. Legen Sie Start und Ziel 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 Zeit verwendet.

3. Setzen Sie den Parameter routingPreference auf TRAFFIC_AWARE_OPTIMAL. Wenn Sie routingPreference auf TRAFFIC_UNAWARE oder TRAFFIC_AWARE setzen, ist dies nicht mit dem Parameter trafficModel kompatibel.

4. Wählen Sie mit dem Parameter trafficModel das zu verwendende Traffic-Modell und einen der folgenden Typen aus:

   • BEST_GUESS (Standardwert): Die zurückgegebene duration_in_traffic ist die beste Schätzung der Reisezeit. Dazu werden Verlaufs- und Echtzeitdaten 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 für die meisten Anwendungsfälle die nützlichsten Vorhersagen.

   • PESSIMISTIC : Die zurückgegebene duration_in_traffic modelliert die Zeit auf Grundlage der historischen Verkehrslage an Tagen mit schlechter Verkehrslage. Dieser Typ liefert eine geschätzte Dauer, die an den meisten Tagen länger als die tatsächliche Reisezeit ist. An Tagen mit besonders schlechten Bedingungen kann diese Schätzung jedoch überschritten werden.

   • OPTIMISTIC : Die zurückgegebene duration_in_traffic modelliert die Zeit auf Grundlage der historischen Verkehrslage an Tagen mit guter Verkehrslage. Dieser Typ liefert eine geschätzte Dauer, die an den meisten Tagen kürzer als die tatsächliche Reisezeit ist. An Tagen mit besonders guten Bedingungen kann diese Schätzung 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 Zeit im Traffic schätzt, wird der von Ihnen angeforderte Traffic-Modelltyp verwendet.

Beispiel: Anfrage für ein Traffic-Modell

In dieser Anfrage wird beispielsweise angegeben, dass die Dauer mit dem Traffic-Modelltyp 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 mit dem Traffic-Modelltyp OPTIMISTIC zurück:

"duration": "1238s"

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

"duration": "2436s"