Kompromiss zwischen Qualität und Latenz konfigurieren

Die Routes Preferred API bietet drei Routeneinstellungen für die Berechnung von Routen. Sie unterscheiden sich darin, inwieweit die Verkehrslage in die Routenberechnung einfließt. Jede Routeneinstellung liefert Ergebnisse, die sich in Bezug auf Routenqualität, geschätzte Ankunftszeit und Antwortlatenz unterscheiden.

Verkehrslage

Die Verkehrslage beschreibt die Geschwindigkeit des Verkehrsflusses. Beispiel:

  • Wenn es keine Staus gibt, ist die Verkehrslage normal und der Verkehr fließt mit der üblichen Geschwindigkeit.

  • Wenn sich die Rushhour nähert, nimmt die Verkehrsdichte zu, wodurch sich der Verkehr verlangsamt und die Verkehrslage leicht bis mäßig ist.

  • Bei Stau kommt der Verkehrsfluss zum Erliegen und die Verkehrslage ist stark.

Verkehrslage nicht berücksichtigt

Wenn Sie die TRAFFIC_UNAWARE Routeneinstellung festlegen, werden Routen ohne Berücksichtigung der Verkehrslage berechnet. Diese Routeneinstellung bietet die niedrigste Antwortlatenz (Antworten werden am schnellsten zurückgegeben).

Verwenden Sie diese Routeneinstellung, wenn Sie möchten, dass Antworten so schnell wie möglich zurückgegeben werden und ungefähre Routendetails ausreichen.

Verkehrslage berücksichtigt

Wenn Sie die TRAFFIC_AWARE Routeneinstellung festlegen, werden Routen unter Berücksichtigung der Verkehrslage berechnet. Dadurch 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 verringern.

Verwenden Sie diese Routeneinstellung, wenn Sie genauere Routendetails wünschen und es Ihnen nichts ausmacht, wenn Antworten mit einer mäßigen Erhöhung der Latenz zurückgegeben werden.

Optimale Route unter Berücksichtigung der Verkehrslage

Wenn Sie die TRAFFIC_AWARE_OPTIMAL Routeneinstellung festlegen, werden Routen unter Berücksichtigung der Verkehrslage berechnet, aber es werden keine Leistungsoptimierungen angewendet. In diesem Modus führt der Server eine umfassendere Suche im Straßennetz durch, um die optimale Route zu finden.

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

Beispiel

Der folgende JSON-Code zeigt, wie Sie die Routeneinstellung im Textkörper 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"
}