Zu verwendenden Traffic-Modelltyp angeben

Mithilfe bestimmter Algorithmen und Faktoren wird in Verkehrsmodellen vorhergesagt, wie sich die Verkehrsbedingungen auf die Gesamtreisezeit einer bestimmten Route auswirken. Die Routes API bietet verschiedene Arten von Trafficmodellen, um verschiedene Faktoren zu priorisieren, die bei der Berechnung der Trafficdauer 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 Traffic-Modelltyp festlegen, variiert der im Feld duration zurückgegebene Wert je nach ausgewähltem Traffic-Modell.

Die Methoden Compute Routes und Compute Route Matrix der Routes API unterstützen Trafficmodelltypen.

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

Zugriffstyp angeben

  1. Legen Sie Ihren Start- und Zielort fest.

  2. Wenn die Abfahrtszeit in der Zukunft liegt, geben Sie die Uhrzeit mit dem Parameter departure_time an. Wenn Sie keine Abreisezeit 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 (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. Mit dem Standardtyp BEST_GUESS 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 Dauer angegeben, die an den meisten Tagen kürzer als die tatsächliche Reisezeit ist. Gelegentliche Tage mit besonders guten Bedingungen können trotzdem länger dauern als diese Schätzung.

    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 Stau schätzt, wird der von Ihnen angeforderte Verkehrsmodelltyp verwendet.

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'

Diese Anfrage gibt die geschätzte Dauer unter Verwendung des OPTIMISTIC-Typs für das Verkehrsmodell für die Fahrt zurück:

"duration": "1238s"

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

"duration": "2436s"