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
Legen Sie Ihren Start- und Zielort fest.
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.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ückgegebeneduration_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 diedeparture_time
rückt. Mit dem StandardtypBEST_GUESS
erhalten Sie für die meisten Anwendungsfälle die nützlichsten Vorhersagen.PESSIMISTIC
, um anzufordern, dass die zurückgegebeneduration_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ückgegebeneduration_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"
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"