Durch die von Ihnen ausgewählten Verkehrseinstellungen wird die Genauigkeit der Routendetails ausgeglichen mit der Anfrageleistung. Wenn Sie eine Anfrage stellen, möchten Sie abwägen, ist es besser, möglichst genaue Ergebnisse oder schnell wie möglich. Mit den Optionen der Routes API können Sie die Qualität der Antwortdaten und die Latenz der Antwort.
Ebene der Verkehrsdaten festlegen
Die Routes API bietet RoutingPreference (REST) und RoutingPreference (gRPC), mit denen Sie Routingeinstellungen für die Berechnung von Routen angeben können. Diese die Verkehrsbedingungen bei der Suche Routenberechnung zu erhalten. Jede Routingeinstellung führt zu Ergebnissen, die sich in Bezug auf die Routenqualität, die geschätzte ETA und die Antwortlatenz unterscheiden.
Die Verkehrslage charakterisiert die Geschwindigkeit des Verkehrs. Beispiel:
- Wenn es keine Staus gibt, gelten die Verkehrsbedingungen als normal und der Verkehr fließt mit der normalen, ungehinderten Geschwindigkeit.
- Kurz vor der Hauptverkehrszeit steigt die Verkehrsdichte, wodurch der Verkehr verlangsamen, sodass es wenig bis mäßigen Verkehr gibt.
- Im Bumper-to-Bumper-Verkehr kommt der Verkehrsfluss zum Stillstand und es kommt zu einer starken Verkehrslage.
Traffic nicht erkannt
Wenn Sie die Routing-Einstellung TRAFFIC_UNAWARE
festlegen, werden Routen berechnet, ohne die aktuellen Verkehrsbedingungen zu berücksichtigen. Diese Routingeinstellung
bietet die niedrigste Antwortlatenz (Antworten werden am schnellsten zurückgegeben).
TRAFFIC_UNAWARE
ist die Standardeinstellung.
In der Antwort:
Die geschätzte Zeit bis zur Lieferung ist in der Antworteigenschaft
duration
enthalten.Die Antwortattribute
duration
undstaticDuration
enthalten dasselbe Wert.
Verwenden Sie diese Routingeinstellung, wenn Sie die schnellsten Antworten benötigen und ungefähre Routingdetails ausreichen.
Mit Verkehrsinformationen
Wenn Sie die Routingeinstellung „TRAFFIC_AWARE
“ festlegen, werden Routen berechnet
unter Berücksichtigung der aktuellen Verkehrslage. So spiegeln die Route und die Routendetails die tatsächlichen Gegebenheiten besser wider. Da diese Verbesserung der Datenqualität jedoch zu einer höheren Antwortlatenz führt, werden Leistungsoptimierungen angewendet, um die Latenz weitgehend zu reduzieren.
In der Antwort:
Die geschätzte Ankunftszeit, die die Verkehrslage in Echtzeit berücksichtigt, ist in der Antworteigenschaft
duration
enthalten.Das Antwortattribut
staticDuration
enthält die Fahrtdauer ohne Berücksichtigung der Verkehrslage.
Verwenden Sie diese Routingeinstellung, wenn Sie genauere Routingdetails als bei TRAFFIC_UNAWARE
benötigen, aber es Ihnen nichts ausmacht, wenn die Antworten mit einer mäßigen Erhöhung der Latenz zurückgegeben werden.
Traffic-Erkennung optimal
Wenn Sie die Routingeinstellung „TRAFFIC_AWARE_OPTIMAL
“ festlegen, werden Routen
Bei der Berechnung werden die aktuellen Verkehrsbedingungen berücksichtigt, aber keine Leistung.
angewendet werden. In diesem Modus führt der Server eine umfassendere Suche im Straßennetz durch, um die optimale Route zu finden.
Die Routingeinstellung TRAFFIC_AWARE_OPTIMAL
entspricht dem Modus, der von
maps.google.com und
Google Maps App.
Bei Verwendung dieser Option mit Compute Route Matrix wird die Anzahl der -Elemente in einer Anfrage (Anzahl der Startorte × Anzahl der Zielorte) dürfen nicht überschreiten 100. Weitere Informationen zu den Limits von Compute Route Matrix finden Sie unter Routenmatrix berechnen.
In der Antwort:
Die geschätzte Ankunftszeit, die die Verkehrslage in Echtzeit berücksichtigt, ist in der Antworteigenschaft
duration
enthalten.Das Antwortattribut
staticDuration
enthält die Reisedauer ohne die Verkehrslage zu berücksichtigen.
Diese Routingeinstellung bietet die höchste Antwortlatenz (d. h. mit der längsten Verzögerung zurückgegeben. Verwenden Sie diese Einstellung, wenn Sie die bestmöglichen Ergebnisse wünschen, unabhängig davon, wie lange die Antworten dauern.
Auswirkungen der Festlegung der Abreisezeit
Mit dem Attribut departureTime
können Sie optional die Abfahrtszeit für eine Fahrt festlegen. Wenn du das Attribut departureTime
nicht festlegst, wird standardmäßig
zu der Uhrzeit, zu der Sie die Anfrage stellen.
Für
TRAFFIC_UNAWARE
können SiedepartureTime
nicht festlegen, da die Auswahl der Route und die Reisezeit auf dem Straßennetz und der durchschnittlichen zeitunabhängigen Verkehrslage basieren.Bei
TRAFFIC_AWARE
undTRAFFIC_AWARE_OPTIMAL
, bei denen die aktuelle Verkehrslage berücksichtigt wird, wird die aktuelle Verkehrslage umso wichtiger, je näher diedepartureTime
rückt. Je weiter in die Zukunft Sie die Abfahrtszeit festlegen, desto stärker werden bisherige Verkehrsbedingungen berücksichtigt.
Beispiel für die Einstellung einer Routingeinstellung
Im folgenden JSON-Code wird gezeigt, wie die Routing-Bevorzugung im Textkörper einer Anfragenachricht festgelegt wird.
{ "origin":{ "location":{ "latLng":{ "latitude":37.419734, "longitude":-122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude":37.417670, "longitude":-122.079595 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE_OPTIMAL" }
Traffic für Polylinien konfigurieren
Mit der Routes API können Sie Informationen zur Verkehrslage anfordern entlang einer Traffic-spezifischen Polylinie. Weitere Informationen finden Sie unter Polylinien anfordern.