Ebene für die Traffic-Daten festlegen

Die von Ihnen ausgewählten Verkehrseinstellungen sorgen auf zwei Arten für ein ausgewogenes Verhältnis zwischen der Genauigkeit der Routendetails und der Anfrageleistung:

• Berücksichtigung der aktuellen Verkehrslage: Es werden möglichst genaue Ergebnisse zurückgegeben (höhere Latenz).

• Verkehrslage nicht berücksichtigen: Die Ergebnisse werden so schnell wie möglich zurückgegeben (niedrigste Latenz).

Wenn Sie eine Anfrage stellen, sollten Sie abwägen, ob es besser ist, möglichst genaue Ergebnisse oder möglichst schnell Ergebnisse zu erhalten. Die Routes API bietet Optionen, mit denen Sie die Qualität der Antwortdaten im Vergleich zur Latenz der Antwort steuern können.

Traffic-Level festlegen

Die Routes API bietet RoutingPreference (REST) und RoutingPreference (gRPC), mit denen Sie Routingeinstellungen für die Berechnung von Routen festlegen können.

Standardmäßig werden Ergebnisse ohne Berücksichtigung der Verkehrslage zurückgegeben. Sie wählen Verkehrsoptionen mit den Routing-Einstellungen TRAFFIC_UNAWARE, TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL aus. Die einzelnen Routingeinstellungen liefern Ergebnisse, die sich in Bezug auf Routenqualität, voraussichtliche Ankunftszeit und Antwortlatenz unterscheiden.

Verkehrslage

Die Verkehrslage beschreibt den Verkehrsfluss:

• Normaler Verkehr: Keine Staus, der Verkehr fließt mit normaler Geschwindigkeit.

• Leichtes bis mäßiges Verkehrsaufkommen: Zunehmende Überlastung, der Verkehr fließt mit reduzierter Geschwindigkeit.

• Starker Verkehr: Hohes Verkehrsaufkommen mit stark reduzierter Geschwindigkeit.

Verkehrslage wird nicht berücksichtigt

TRAFFIC_UNAWARE ist die Standardeinstellung. Verwenden Sie diese Routenpräferenz, wenn Sie die schnellsten Antworten erhalten möchten und ungefähre Routendetails ausreichen.

TRAFFIC_UNAWARE-Routen werden ohne Berücksichtigung der aktuellen Verkehrslage berechnet. Diese Routing-Einstellung führt zur schnellsten Antwort auf die Anfrage (niedrigste Latenz).

Wenn Sie TRAFFIC_UNAWARE auswählen, beruhen die Auswahl der Route und die Reisezeit auf dem Straßennetz sowie der durchschnittlichen zeitunabhängigen Verkehrslage und 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.

Folgende Antworten werden angezeigt:

• duration: Enthält die voraussichtliche Ankunftszeit für die Route.

• staticDuration: Die voraussichtliche Ankunftszeit für die Route, wobei nur Verlaufsdaten zum Verkehrsaufkommen berücksichtigt werden. Für TRAFFIC_UNAWARE enthält dies denselben Wert wie duration.

Verkehrsabhängig

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

Wenn Sie die Routingeinstellung TRAFFIC_AWARE festlegen, berechnet der Dienst die Route unter Berücksichtigung der aktuellen Verkehrslage. So spiegeln die Route und die Routendetails die realen Bedingungen genauer wider. Da diese Verbesserung der Datenqualität auf Kosten der Antwortlatenz geht, werden Leistungsoptimierungen angewendet, um die Latenz zu reduzieren.

Folgende Antworten werden angezeigt:

• duration: Die voraussichtliche Ankunftszeit unter Berücksichtigung von Echtzeit-Verkehrsinformationen.

• staticDuration Die voraussichtliche Ankunftszeit für die Route, wobei nur bisherige Verkehrsinformationen berücksichtigt werden.

Optimale Route anhand der aktuellen Verkehrslage

Verwenden Sie diese Routing-Einstellung, wenn Sie Ergebnisse von höchster Qualität erhalten möchten, unabhängig davon, wie lange die Antworten dauern. Diese Routing-Einstellung hat die längste Verzögerung bei der Rückgabe von Antworten (höchste Latenz).

Wenn Sie die Routingeinstellung TRAFFIC_AWARE_OPTIMAL festlegen, berechnet der Dienst die Route unter Berücksichtigung der aktuellen Verkehrslage, wendet aber keine Leistungsoptimierungen an. In diesem Modus führt der Server eine umfassendere Suche im Straßennetz durch, um die optimale Route zu finden.

Die Routenpräferenz TRAFFIC_AWARE_OPTIMAL entspricht dem Modus, der von maps.google.com und der Google Maps App verwendet wird.

Wenn Sie diese Option mit „Compute Route Matrix“ verwenden, ist die Anzahl der Elemente in einer Anfrage (Anzahl der Startorte × Anzahl der Ziele) begrenzt. Weitere Informationen zu den Limits für Compute Route Matrix finden Sie unter Routenmatrix berechnen.

Folgende Antworten werden angezeigt:

• duration: Die voraussichtliche Ankunftszeit für die Route unter Berücksichtigung von Echtzeit-Verkehrsinformationen.

• staticDuration: Die voraussichtliche Ankunftszeit für die Route, wobei nur Verlaufsdaten zum Verkehrsaufkommen berücksichtigt werden.

Abfahrtszeit festlegen (optional)

Verwenden Sie diese Property nur für Anfragen mit Berücksichtigung der Verkehrslage, bei denen die Abfahrtszeit in der Zukunft liegen muss. Wenn Sie das Attribut departureTime nicht festlegen, wird standardmäßig die Zeit verwendet, zu der Sie die Anfrage stellen.

Verwenden Sie die Property departureTime zusammen mit den Optionen TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL, wenn Sie die Art und Weise anpassen möchten, wie der Dienst die Verkehrslage bei der Auswahl einer Route vorhersagt.

• TRAFFIC_UNAWARE: Nicht empfohlen, da die Auswahl der Route und die Reisezeit auf dem Straßennetz und der durchschnittlichen zeitunabhängigen Verkehrslage beruhen.

• TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL: Empfohlen für Abfahrten in naher Zukunft, da diese Einstellungen die aktuelle Verkehrslage berücksichtigen. Die aktuelle Verkehrslage wird umso stärker gewichtet, je näher die departureTime rückt. Je weiter die Abfahrtszeit in der Zukunft liegt, desto stärker werden bei der Routenauswahl historische Verkehrsdaten berücksichtigt.

Beispiel: Routenplanung anhand der aktuellen Verkehrslage auswählen

Der folgende JSON-Code zeigt, wie Sie die Routingeinstellung TRAFFIC_AWARE_OPTIMAL im Entitätstext einer Anfragenachricht festlegen.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}