Festlegen, wie und ob Trafficdaten einbezogen werden sollen

Durch die von Ihnen ausgewählten Verkehrseinstellungen wird die Genauigkeit der Routendetails ausgeglichen mit der Anfrageleistung. Wenn Sie eine Anfrage stellen, möchten Sie abwägen, ist es besser, möglichst genaue Ergebnisse oder schnell wie möglich. Mit den Optionen der Routes API können Sie die Qualität der Antwortdaten und die Latenz der Antwort.

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 die Verkehrsbedingungen bei der Suche Routenberechnung zu erhalten. Jede Routingeinstellung führt zu Ergebnissen, die sich in Bezug auf die Routenqualität, die geschätzte ETA und die Antwortlatenz unterscheiden.

Die Verkehrslage charakterisiert die Geschwindigkeit des Verkehrs. 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 steigt die Verkehrsdichte, wodurch der Verkehr verlangsamen, sodass es wenig bis mäßigen Verkehr gibt.
  • Im Bumper-to-Bumper-Verkehr kommt der Verkehrsfluss zum Stillstand und es kommt zu einer starken Verkehrslage.

Traffic nicht erkannt

Wenn Sie die Routing-Einstellung TRAFFIC_UNAWARE festlegen, werden Routen berechnet, ohne die aktuellen Verkehrsbedingungen zu berücksichtigen. Diese Routingeinstellung bietet die niedrigste Antwortlatenz (Antworten werden am schnellsten zurückgegeben).

TRAFFIC_UNAWARE ist die Standardeinstellung.

In der Antwort:

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

  • Die Antwortattribute duration und staticDuration enthalten dasselbe Wert.

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

Mit Verkehrsinformationen

Wenn Sie die Routingeinstellung „TRAFFIC_AWARE“ festlegen, werden Routen berechnet unter Berücksichtigung der aktuellen Verkehrslage. So spiegeln die Route und die Routendetails die tatsächlichen Gegebenheiten besser 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 ohne Berücksichtigung der Verkehrslage.

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

Traffic-Erkennung optimal

Wenn Sie die Routingeinstellung „TRAFFIC_AWARE_OPTIMAL“ festlegen, werden Routen Bei der Berechnung werden die aktuellen Verkehrsbedingungen berücksichtigt, aber keine Leistung. angewendet werden. In diesem Modus führt der Server eine umfassendere 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 Google Maps App.

Bei Verwendung dieser Option mit Compute Route Matrix wird die Anzahl der -Elemente in einer Anfrage (Anzahl der Startorte × Anzahl der Zielorte) dürfen nicht überschreiten 100. 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 Reisedauer ohne die Verkehrslage zu berücksichtigen.

Diese Routingeinstellung bietet die höchste Antwortlatenz (d. h. mit der längsten Verzögerung zurückgegeben. Verwenden Sie diese Einstellung, wenn Sie die bestmöglichen Ergebnisse wünschen, unabhängig davon, wie lange die Antworten dauern.

Auswirkungen der Festlegung der Abreisezeit

Mit dem Attribut departureTime können Sie optional die Abfahrtszeit für eine Fahrt festlegen. Wenn du das Attribut departureTime nicht festlegst, wird standardmäßig zu der Uhrzeit, 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 einer Routingeinstellung

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"
}

Traffic für Polylinien konfigurieren

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