Zu verwendenden Traffic-Modelltyp angeben

Verkehrsmodelle 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 Arten von Verkehrsmodellen, um unterschiedliche Faktoren zu priorisieren, die bei der Berechnung der Reisezeit im Verkehr verwendet werden. Sie können den Typ des Verkehrsmodells angeben, das für die Berechnung der Dauer für Ihre 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 Methoden Compute Routes als auch Compute Route Matrix der Routes API unterstützen Typen von Verkehrsmodellen.

Standardmäßig verwenden beide Methoden den Typ des Verkehrsmodells BEST_GUESS.

Verkehrstyp 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 Verkehrsmodell 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 basierend auf den historischen Verkehrsbedingungen 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 basierend auf den historischen Verkehrsbedingungen 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 Reisezeit im Verkehr schätzt, wird der von Ihnen angeforderte Typ des Verkehrsmodells verwendet.

Beispiel: Anfrage für ein Verkehrsmodell

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

"duration": "1238s"

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

"duration": "2436s"