Festlegen, wie und ob Trafficdaten einbezogen werden sollen

Die von Ihnen ausgewählten Verkehrseinstellungen ermöglichen ein Gleichgewicht zwischen der Genauigkeit der Routendetails und der Anfrageleistung. Wenn Sie eine Anfrage stellen, möchten Sie abwägen, ob es besser ist, möglichst genaue oder möglichst schnelle Ergebnisse zurückzugeben. Die Routes API bietet Optionen, mit denen Sie die Qualität der Antwortdaten im Vergleich zur Latenz der Antwort steuern können.

Achtung: Anfragen mit TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL werden zu einem höheren Preis abgerechnet. Weitere Informationen zur Abrechnung

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 Präferenzen unterscheiden sich insofern, als dass bei der Routenberechnung die Verkehrslage berücksichtigt wird. Jede Routingeinstellung liefert Ergebnisse, die sich in Bezug auf Routenqualität, geschätzte voraussichtliche Ankunftszeit und Antwortlatenz in gewissem Umfang unterscheiden.

Die Verkehrslage beschreibt die Geschwindigkeit des Verkehrsflusses. Beispiel:

• Wenn es keine Staus gibt, gilt die Verkehrslage als normal und der Verkehr fließt mit normaler ungehinderter Geschwindigkeit.
• Kurz vor der Hauptverkehrszeit steigt die Verkehrsdichte, wodurch sich der Verkehr verlangsamt und die Verkehrslage gering bis mäßig ist.
• Im Bumper-zu-Bumper-Verkehr bricht die Geschwindigkeit zum Stillstand, was zu starken Verkehrsbedingungen führt.

Traffic nicht erkannt

Wenn Sie die Routingeinstellung TRAFFIC_UNAWARE festlegen, werden Routen ohne Berücksichtigung der aktuellen Verkehrslage berechnet. Diese Routingeinstellung bietet die niedrigste Antwortlatenz (Antworten werden am schnellsten zurückgegeben).

TRAFFIC_UNAWARE ist die Standardeinstellung.

Wenn Sie TRAFFIC_UNAWARE auswählen, beruhen die Auswahl der Route und die Reisezeit auf dem Straßennetz und der durchschnittlichen zeitunabhängigen Verkehrslage, nicht auf der aktuellen Verkehrslage. 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. Außerdem können die Ergebnisse zwischen praktisch gleichwertigen Routen jederzeit und beliebig oft variieren.

.

In der Antwort:

• Die ETA ist im Antwortattribut duration enthalten.

• Die Antwortattribute duration und staticDuration enthalten denselben Wert.

Verwenden Sie diese Routingeinstellung, wenn Antworten am schnellsten zurückgegeben werden sollen und ungefähre Routendetails ausreichend sind.

Hinweis :Diese Einstellung entspricht der Einstellung, wenn der aktuelle Traffic nicht in der Directions API und der Distance Matrix API verwendet wird.

Traffic-Erkennung

Wenn Sie die Routingeinstellung TRAFFIC_AWARE festlegen, werden Routen unter Berücksichtigung der aktuellen Verkehrslage berechnet. Dadurch spiegeln die Routen- und Routendetails reale Bedingungen genauer wider. Da diese Steigerung der Datenqualität auf Kosten der Antwortlatenz führt, werden Leistungsoptimierungen angewendet, um einen Großteil der Latenz zu reduzieren.

In der Antwort:

• Die ETA unter Berücksichtigung des Echtzeit-Traffics ist im Antwortattribut duration enthalten.

• Das Antwortattribut staticDuration enthält die Dauer der Fahrt, ohne die Verkehrslage zu berücksichtigen.

Verwenden Sie diese Routingeinstellung, wenn Sie genauere Routingdetails als TRAFFIC_UNAWARE benötigen und es Ihnen nichts ausmacht, wenn Antworten mit einer moderaten Erhöhung der Latenz zurückgegeben werden.

Hinweis :Diese Einstellung ist neu für die Routes API und hat in der Directions API und der Distance Matrix API keine Entsprechung.

Traffic-Erkennung optimal

Wenn Sie die Routingeinstellung TRAFFIC_AWARE_OPTIMAL festlegen, werden Routen unter Berücksichtigung der aktuellen Verkehrslage berechnet. Es werden jedoch keine Leistungsoptimierungen angewendet. In diesem Modus führt der Server eine umfassendere Suche im Straßennetz durch, um die optimale Route zu ermitteln.

Die Routingeinstellung TRAFFIC_AWARE_OPTIMAL entspricht dem von maps.google.com und der mobilen Google Maps App verwendeten Modus.

Wenn Sie diese Option mit Compute Route Matrix verwenden, darf die Anzahl der Elemente in einer Anfrage (Anzahl der Startorte × Anzahl der Ziele) 100 nicht überschreiten. Weitere Informationen zu Compute Route Matrix-Limits finden Sie unter Routenmatrix berechnen.

In der Antwort:

• Die ETA unter Berücksichtigung des Echtzeit-Traffics ist im Antwortattribut duration enthalten.

• Das Antwortattribut staticDuration enthält die Dauer der Fahrt, ohne die Verkehrslage zu berücksichtigen.

Diese Routingeinstellung bietet die höchste Antwortlatenz (d. h. Antworten mit der längsten Verzögerung). Verwenden Sie diese Routingeinstellung, wenn Sie Ergebnisse in höchster Qualität erhalten möchten, unabhängig von der Dauer der Antworten.

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

Auswirkungen der Festlegung der Abfahrtszeit

Optional können Sie die Eigenschaft departureTime verwenden, um die Abfahrtszeit für eine Fahrt festzulegen. Wenn Sie das Attribut departureTime nicht festlegen, wird standardmäßig der Zeitpunkt verwendet, zu dem Sie die Anfrage stellen.

• Für TRAFFIC_UNAWARE kann departureTime nicht festgelegt werden, da die Auswahl der Route und der Reisezeit auf dem Straßennetz und der durchschnittlichen zeitunabhängigen Verkehrslage basiert.

• Bei TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL, bei denen die Bedingungen für die Live-Verkehrslage berücksichtigt werden, wird der Live-Traffic umso wichtiger, je näher die departureTime rückt. Je weiter Sie die Abfahrtszeit in die Zukunft setzen, desto mehr wird die historische Verkehrslage berücksichtigt.

Beispiel für Einstellung der Routingeinstellung

Der folgende JSON-Code zeigt, wie die Routingeinstellung im Entitätstext 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"
}

Verkehr auf Polylinien konfigurieren

Mit der Routes API können Sie Informationen zur Verkehrslage entlang einer verkehrsbezogenen Polylinie anfordern. Weitere Informationen finden Sie unter Polylinien anfordern.