Zu verwendenden Traffic-Modelltyp angeben

Trafficmodelle nutzen bestimmte Algorithmen und Faktoren, um vorherzusagen, Bedingungen wirken sich auf die Gesamtreisezeit für eine bestimmte Route aus. Routes API verschiedene Arten von Traffic-Modellen zur Priorisierung verschiedener Faktoren die Berechnung der Dauer von Zugriffen. 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, hängt der im Feld duration zurückgegebene Wert vom ausgewählten Traffic-Modell ab.

Sowohl die Compute Routes als auch die Routes API Compute Route Matrix-Methoden 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 zu verwendende Traffic-Modell mit dem Parameter trafficModel und einen der folgenden Typen aus:

    • BEST_GUESS (Standard), um anzufordern, dass die zurückgegebene duration_in_traffic ist die beste Schätzung der Reisezeit unter Berücksichtigung dessen, was über beides bekannt ist Informationen zur aktuellen Verkehrslage und zur aktuellen Verkehrslage. 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 anzufordern, dass die zurückgegebene duration_in_traffic das Modell des basierend auf den bisherigen Verkehrsbedingungen an Tagen mit schlechtem Verkehr. 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 unter guten Bedingungen möglicherweise trotzdem schneller als diese Schätzung.

    Beispiel:

    "trafficModel": "OPTIMISTIC"

  4. Geben Sie in der Feldmaske das Feld routes.duration 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 mithilfe des Trafficmodells „OPTIMISTIC“ zurück Art der Fahrt:

"duration": "1238s"

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

"duration": "2436s"