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 Verkehrsmodellen, um verschiedene Faktoren bei der Berechnung der Dauer des Verkehrs zu priorisieren. 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.

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

Standardmäßig wird bei beiden Methoden der Traffic-Modelltyp BEST_GUESS verwendet.

So legen Sie einen Traffic-Typ fest:

  1. Legen Sie den Start- und Zielort fest.

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

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

    • BEST_GUESS (Standardwert): Die zurückgegebene duration_in_traffic soll die beste Schätzung der Reisezeit sein. 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 anzugeben, dass die zurückgegebene duration_in_traffic die Zeit basierend auf den historischen Verkehrsbedingungen an Tagen mit schlechtem Verkehr modellieren soll. Bei diesem Typ wird eine geschätzte Dauer angegeben, 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, um anzugeben, dass die zurückgegebene duration_in_traffic die Zeit basierend auf den historischen Verkehrsbedingungen an Tagen mit guter Verkehrslage modellieren soll. Bei diesem Typ wird eine geschätzte Reisezeit angegeben, die höchstwahrscheinlich kürzer ist als die tatsächliche Reisezeit an den meisten Tagen. An Tagen mit besonders guten Bedingungen kann die Fahrt aber auch kürzer dauern.

    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 Zeit im Traffic schätzt, verwendet sie den von Ihnen angeforderten Traffic-Modelltyp.

Beispiel: Anfrage für ein Traffic-Modell

In dieser Anfrage wird beispielsweise angegeben, dass die Dauer anhand des Verkehrsmodelltyps 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'

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 Besuchermodells in PESSIMISTIC ändern, ist die zurückgegebene Dauer länger:

"duration": "2436s"