Ebene für die Traffic-Daten festlegen

Mit den von Ihnen ausgewählten Verkehrseinstellungen wird die Genauigkeit der Routendetails auf eine von zwei Arten mit der Abfrageleistung abgewogen:

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

  • Ohne Berücksichtigung der Verkehrslage: Die Ergebnisse werden so schnell wie möglich zurückgegeben (niedrigste Latenz).

Wenn Sie eine Anfrage stellen, sollten Sie überlegen, ob es besser ist, möglichst genaue Ergebnisse zurückzugeben oder möglichst schnell Ergebnisse zurückzugeben. Mit der Routes API können Sie die Qualität der Antwortdaten im Verhältnis zur Latenz der Antwort steuern.

Zugriffsebene festlegen

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

Standardmäßig werden Ergebnisse ohne Berücksichtigung des Traffics angezeigt. Mit den Routingeinstellungen TRAFFIC_UNAWARE, TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL können Sie Verkehrsoptionen auswählen. Jede Routingeinstellung führt zu Ergebnissen, die sich in der Routenqualität, der geschätzten Ankunftszeit und der Antwortlatenz unterscheiden.

Verkehrslage

Die Verkehrslage gibt die Geschwindigkeit des Verkehrsflusses an:

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

  • Wenig bis mäßiger Verkehr: Zunehmende Staus, bei denen der Verkehr mit reduzierter Geschwindigkeit fließt.

  • Hohes Verkehrsaufkommen: Starke Staus mit stark reduzierter Verkehrsgeschwindigkeit.

Unbekannte Zugriffe

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

TRAFFIC_UNAWARE-Routen werden ohne Berücksichtigung der aktuellen Verkehrsbedingungen berechnet. Diese Routingeinstellung führt zur schnellsten Antwort auf Anfragen (geringste 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 geschätzte Ankunftszeit für die Route.

  • staticDuration: Die geschätzte Ankunftszeit für die Route, bei der nur bisherige Verkehrsinformationen berücksichtigt werden. Für TRAFFIC_UNAWARE ist dies derselbe Wert wie für duration.

Mit Verkehrsinformationen

Verwenden Sie diese Routingeinstellung, wenn Sie genauere Routingdetails als bei TRAFFIC_UNAWARE benötigen, aber nichts dagegen haben, wenn die Antworten mit einer mäßigen Erhöhung der Latenz zurückgegeben werden.

Wenn Sie die Routing-Einstellung TRAFFIC_AWARE festlegen, berechnet der Dienst die Route unter Berücksichtigung der aktuellen Verkehrsbedingungen. So spiegeln die Route und die Routendetails die tatsächlichen Gegebenheiten genauer wider. Da diese Verbesserung der Datenqualität zu einer höheren Reaktionslatenz führt, werden Leistungsoptimierungen angewendet, um die Latenz weitgehend zu reduzieren.

Folgende Antworten werden angezeigt:

  • duration: Die voraussichtliche Ankunftszeit unter Berücksichtigung von Echtzeitinformationen zur Verkehrslage.

  • staticDuration Die geschätzte Ankunftszeit für die Route, bei der nur bisherige Verkehrsinformationen berücksichtigt werden.

Optimal unter Berücksichtigung der aktuellen Verkehrslage

Verwenden Sie diese Einstellung, wenn Sie Ergebnisse von höchster Qualität wünschen, unabhängig davon, wie lange die Antworten dauern. Bei dieser Routingeinstellung ist die Verzögerung bei der Rückgabe von Antworten am längsten (höchste Latenz).

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

Die TRAFFIC_AWARE_OPTIMAL-Routeneinstellung 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)

  1. Weitere Informationen zu den Limits von 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 geschätzte Ankunftszeit für die Route, bei der nur bisherige Verkehrsinformationen berücksichtigt werden.

Abfahrtszeit festlegen (optional)

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

Verwenden Sie das Attribut departureTime zusammen mit den Optionen TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL, wenn Sie anpassen möchten, wie der Dienst den Verkehr 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 bei diesen Einstellungen die aktuellen Verkehrsbedingungen berücksichtigt werden. Die aktuelle Verkehrslage wird umso stärker gewichtet, je näher die departureTime rückt. Je weiter in der Zukunft Sie die Abfahrtszeit festlegen, desto stärker werden bei der Auswahl der Routen die bisherigen Verkehrsbedingungen berücksichtigt.

Beispiel: Berücksichtigung der aktuellen Verkehrslage beim Routing auswählen

Im folgenden JSON-Code wird gezeigt, wie die TRAFFIC_AWARE_OPTIMAL-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"
}

Verkehr auf Polylinien konfigurieren

Mit der Routes API können Sie Informationen zu den Verkehrsbedingungen entlang einer verkehrsabhängigen Polylinie anfordern. Weitere Informationen finden Sie unter Polylinien anfordern.