Festlegen, wie und ob Trafficdaten einbezogen werden sollen

Mit den von Ihnen ausgewählten Verkehrseinstellungen wird die Genauigkeit der Routendetails mit der Anfrageleistung abgewogen. Wenn Sie eine Anfrage stellen, sollten Sie abwägen, 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 Vergleich zur Latenz der Antwort steuern.

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

Ebene der Besucherdaten festlegen

Die Routes API bietet RoutingPreference (REST) und RoutingPreference (gRPC), mit denen Sie Routingeinstellungen für die Berechnung von Routen angeben können. Diese Einstellungen unterscheiden sich darin, inwieweit die Verkehrsbedingungen bei der Routenberechnung berücksichtigt werden. Jede Routingeinstellung führt zu Ergebnissen, die sich in Bezug auf die Routenqualität, die geschätzte ETA und die Antwortlatenz unterscheiden.

Die Verkehrslage gibt Aufschluss über die Geschwindigkeit des Verkehrsflusses. Beispiel:

• Wenn es keine Staus gibt, gelten die Verkehrsbedingungen als normal und der Verkehr fließt mit der normalen, ungehinderten Geschwindigkeit.
• Kurz vor der Hauptverkehrszeit nimmt die Verkehrsdichte zu, was zu einer Verlangsamung des Verkehrs führt und zu leichten bis mäßigen Verkehrsbedingungen führt.
• Bei dichtem Verkehr kommt der Verkehrsfluss zum Erliegen, was zu einem Stau führt.

Unbekannte Zugriffe

Wenn Sie die Routing-Einstellung TRAFFIC_UNAWARE festlegen, werden Routen berechnet, ohne die aktuellen Verkehrsbedingungen zu berücksichtigen. Diese Routing-Einstellung 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 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.

In der Antwort:

• Die geschätzte Zeit bis zur Lieferung ist in der Antworteigenschaft duration enthalten.

• Die Antworteigenschaften duration und staticDuration enthalten denselben Wert.

Verwenden Sie diese Routingeinstellung, wenn Sie die schnellsten Antworten benötigen und ungefähre Routingdetails ausreichen.

Hinweis: Diese Einstellung entspricht der Situation, in der aktueller Verkehr nicht in der Directions API und der Distance Matrix API verwendet wird.

Mit Verkehrsinformationen

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

In der Antwort:

• Die geschätzte Ankunftszeit, die die Verkehrslage in Echtzeit berücksichtigt, ist in der Antworteigenschaft duration enthalten.

• Das Antwortattribut staticDuration enthält die Fahrtdauer für die Route, ohne die Verkehrslage zu berücksichtigen.

Verwenden Sie diese Routingeinstellung, wenn Sie genauere Routingdetails als bei TRAFFIC_UNAWARE benötigen, aber keine erhöhte Latenz bei den Antworten in Kauf nehmen möchten.

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

Optimal unter Berücksichtigung der aktuellen Verkehrslage

Wenn Sie die TRAFFIC_AWARE_OPTIMAL-Routing-Einstellung festlegen, werden Routen unter Berücksichtigung der aktuellen Verkehrsbedingungen 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 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) 100 nicht überschreiten. Weitere Informationen zu den Limits von Compute Route Matrix finden Sie unter Routenmatrix berechnen.

In der Antwort:

• Die geschätzte Ankunftszeit, die die Verkehrslage in Echtzeit berücksichtigt, ist in der Antworteigenschaft duration enthalten.

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

Diese Routingeinstellung hat die höchste Antwortlatenz, d. h., Antworten werden mit der längsten Verzögerung zurückgegeben. Verwenden Sie diese Einstellung, wenn Sie Ergebnisse von höchster Qualität wünschen, unabhängig davon, wie lange die Antworten dauern.

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

Auswirkungen der Festlegung der Abfahrtszeit

Mit dem Attribut departureTime können Sie optional die Abfahrtszeit für eine Fahrt festlegen. Wenn Sie die Property departureTime nicht festlegen, wird standardmäßig die Uhrzeit verwendet, zu der Sie die Anfrage stellen.

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

• Bei TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL, bei denen die aktuelle Verkehrslage berücksichtigt wird, wird die aktuelle Verkehrslage umso wichtiger, je näher die departureTime rückt. Je weiter in die Zukunft Sie die Abfahrtszeit festlegen, desto stärker werden bisherige Verkehrsbedingungen berücksichtigt.

Beispiel für die Einstellung der Routing-Einstellung

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