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 Traffic-Modells angeben, die bei der Berechnung der Dauer Ihrer Routen oder Ihrer Route verwendet werden, Matrixstruktur. Wenn Sie den Typ des Traffic-Modells festlegen, wird der im Das Feld duration variiert je nach ausgewähltem Traffic-Modell.

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.

So legen Sie einen Traffic-Typ fest:

  1. Legen Sie Ihren Start- und Zielort fest.

  2. Falls Ihre Abreise in der Zukunft liegt, geben Sie die Zeit mithilfe des departure_time-Parameter. Wenn Sie keine Abfahrtszeit angeben, ist standardmäßig „jetzt“.

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

    • 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 nimmt zu umso wichtiger ist der departure_time. 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 höchstwahrscheinlich länger ist als die tatsächliche Reisezeit an den meisten Tagen. Gelegentliche besonders schlechte Tage Bedingungen dennoch über dieser Schätzung liegen.

    • 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 höchstwahrscheinlich kürzer ist als die tatsächliche Reisezeit an den meisten Tagen. 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: Trafficmodell-Anfrage

Die Anfrage gibt beispielsweise an, dass die Dauer mithilfe der Methode OPTIMISTIC-Verkehrsmodelltyp bei einer bestimmten Abfahrtszeit:

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"