Festlegen, wie und ob Trafficdaten einbezogen werden sollen

Mit den von Ihnen ausgewählten Trafficeinstellungen können Sie die Genauigkeit der Routendetails auf die Anfrageleistung abstimmen. Wenn Sie eine Anfrage stellen, sollten Sie abwägen, ob es besser ist, möglichst genaue Ergebnisse oder so schnell wie möglich zurückzugeben. Die Routes API bietet Optionen, mit denen Sie die Qualität der Antwortdaten im Vergleich zur Latenz der Antwort steuern können.

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 bei der Routenberechnung die Verkehrslage berücksichtigt wird. Jede Routingeinstellung führt zu Ergebnissen, die sich in Bezug auf Routenqualität, geschätzte ETA und Antwortlatenz in einem gewissen Maße unterscheiden.

Die Verkehrslage charakterisiert die Geschwindigkeit des Verkehrs. Beispiel:

• Wenn es keine Stau gibt, gilt die Verkehrslage als normal und der Verkehr fließt mit der üblichen ungehinderten Geschwindigkeit.
• Kurz vor der Hauptverkehrszeit steigt die Verkehrsdichte, wodurch der Verkehr verlangsamt wird und es daher wenig bis mäßigen Verkehr gibt.
• Im Bumper-to-Bumper-Verkehr kommt der Verkehr zum Stillstand und dies führt zu starkem Verkehr.

Traffic nicht erkannt

Wenn Sie die Routingeinstellung TRAFFIC_UNAWARE festlegen, werden die 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.

.

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 Routingdetails ausreichend sind.

Verkehrsinfo

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

In der Antwort:

• Die ETA unter Berücksichtigung des Echtzeittraffics ist im Antwortattribut duration enthalten.

• Das Antwortattribut staticDuration enthält die Dauer der Route ohne Berücksichtigung der Verkehrslage.

Verwenden Sie diese Routingeinstellung, wenn Sie genauere Routingdetails als TRAFFIC_UNAWARE benötigen, es aber nichts ausmacht, wenn Antworten mit einer moderaten Latenzerhöhung zurückgegeben werden.

Traffic-Erkennung optimal

Wenn Sie die Routingeinstellung TRAFFIC_AWARE_OPTIMAL festlegen, werden Routen unter Berücksichtigung der aktuellen Verkehrslage berechnet, aber es werden keine Leistungsoptimierungen angewendet. In diesem Modus führt der Server eine ausführlichere 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 der mobilen Google Maps App verwendet wird.

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 Echtzeittraffics ist im Antwortattribut duration enthalten.

• Das Antwortattribut staticDuration enthält die Dauer der Route ohne Berücksichtigung der Verkehrslage.

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

Auswirkungen der Festlegung der Abreisezeit

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

• Für TRAFFIC_UNAWARE können Sie keine departureTime festlegen, da die Auswahl der Route und die Dauer auf dem Straßennetz und der durchschnittlichen zeitunabhängigen Verkehrslage basiert.

• Für TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL, bei denen die aktuellen Verkehrsverhältnisse berücksichtigt werden, wird der Live-Traffic umso wichtiger, je näher der departureTime ist. Je weiter die Abfahrtszeit in der Zukunft liegt, desto mehr werden die bisherigen Verkehrsverhältnisse berücksichtigt.

Beispiel für die Einstellung einer 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"
}

Traffic für Polylinien konfigurieren

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