Festlegen, wie und ob Trafficdaten einbezogen werden sollen

Die von Ihnen ausgewählten Verkehrseinstellungen sorgen für ein Gleichgewicht zwischen der Genauigkeit der Routendetails 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.

Achtung :Anfragen mit TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL werden in Rechnung gestellt. in einer höheren Rate. Weitere Informationen zur Abrechnung

Ebene der Verkehrsdaten festlegen

Die Routes API bietet RoutingPreference (REST) und RoutingPreference (gRPC), mit dem 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 von einer Routenqualität, geschätzte Ankunftszeit und Antwortlatenz.

Die Verkehrslage charakterisiert die Geschwindigkeit des Verkehrs. Beispiel:

• Ohne Stau gilt die Verkehrslage als normal und mit der üblichen ungehinderten Geschwindigkeit fließt.
• 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 Routingeinstellung „TRAFFIC_UNAWARE“ festlegen, werden Routen berechnet ohne die aktuelle Verkehrslage zu berücksichtigen. Diese Routingeinstellung bietet die niedrigste Antwortlatenz (Antworten werden am schnellsten zurückgegeben).

TRAFFIC_UNAWARE ist die Standardeinstellung.

Wenn Sie TRAFFIC_UNAWARE auswählen, Die gewählte Route und Dauer basieren auf dem Straßennetz und der durchschnittlichen zeitunabhängigen und nicht auf aktuelle Straßenverhältnisse. Daher können Routen Straßen umfassen, die vorübergehend gesperrt sind. Die Ergebnisse für eine bestimmte Anfrage können sich im Laufe der Zeit aufgrund von Änderungen im Straßennetz und Aktualisierungen der durchschnittlichen Verkehrslage sowie aufgrund der Dezentralisierung des Diensts ändern. Die Ergebnisse können auch zwischen folgenden nahezu gleichwertigen Routen gibt.

In der Antwort:

• Die ETA ist im Antwortattribut duration enthalten.

• Die Antwortattribute duration und staticDuration enthalten dasselbe Wert.

Verwenden Sie diese Routingeinstellung, wenn Antworten am schnellsten zurückgegeben werden sollen. ungefähre Routenangaben reichen aus.

Hinweis :Diese Einstellung entspricht der Einstellung, wenn der aktuelle Verkehr nicht im Directions API und Distance Matrix API

Verkehrsinfo

Wenn Sie die Routingeinstellung „TRAFFIC_AWARE“ festlegen, werden Routen berechnet unter Berücksichtigung der aktuellen Verkehrslage. Daher sind die Route und die Route Details die realen Bedingungen genauer widerspiegeln. Da diese Steigerung der die Datenqualität geht auf Kosten der Reaktionslatenz, Leistungsoptimierungen um die Latenz zu reduzieren.

In der Antwort:

• Die voraussichtliche Ankunftszeit unter Berücksichtigung des Echtzeit-Traffics ist im duration-Antwortattribut.

• Das Antwortattribut staticDuration enthält die Reisedauer ohne die Verkehrslage zu berücksichtigen.

Verwenden Sie diese Routingeinstellung, wenn Sie genauere Routendetails als TRAFFIC_UNAWARE. Trotzdem macht es es Ihnen nichts aus, wenn Antworten mit einem mäßiger Anstieg der Latenz.

Hinweis: Diese Einstellung ist neu für die Routes API und hat im Feld Directions API und Distance Matrix API

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 im Straßennetz suchen, um die optimale Route zu finden.

Die Routingeinstellung TRAFFIC_AWARE_OPTIMAL entspricht dem Modus, der von unter 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 Compute Route Matrix-Limits finden Sie unter Routenmatrix berechnen

In der Antwort:

• Die voraussichtliche Ankunftszeit unter Berücksichtigung des Echtzeit-Traffics ist im duration-Antwortattribut.

• 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 Routingeinstellung, wenn Sie Ergebnisse von höchster Qualität wünschen, unabhängig von der Dauer der Antworten.

Hinweis: Diese Option entspricht der Angabe von departure_time im Directions API und Distance Matrix API

Auswirkungen der Festlegung der Abreisezeit

Optional können Sie das Attribut departureTime verwenden, um die Abfahrtszeit für einen Fahrt. 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 Sie departureTime nicht festlegen, da die Wahl von Route und Dauer basieren auf dem Straßennetz und der durchschnittlichen zeitunabhängigen Verkehrslage.

• Für TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL, für die die aktuelle Verkehrslage gilt Live-Traffic immer wichtiger wird, näher am departureTime liegt. Je weiter Sie die Abfahrtszeit festlegen, desto mehr werden die bisherigen Zugriffe berücksichtigt. .

Beispiel für die Einstellung einer Routingeinstellung

Im folgenden JSON-Code sehen Sie, wie die Routingeinstellung in einem Nachrichtenentitätstext der Anfrage.

{
  "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 Weitere Informationen finden Sie unter Polylinien anfordern.