Routen berechnen

Das Tool compute_routes gibt eine Route zwischen einem Start- und einem Zielort für eine bestimmte Mobilitätsform zurück. Die Antwort enthält die Entfernung und die Dauer der Route. Standardmäßig werden Routen ohne Berücksichtigung der aktuellen Verkehrslage berechnet. Pro bietet Routenplanung, die Echtzeit-Verkehrsinformationen und Routen mit mehr Zwischenstopps berücksichtigt.

Auf dieser Seite werden die Anfrageoptionen, einschließlich der Pro-Optionen, der Inhalt der Antwort und die Abrechnung von Anfragen beschrieben. Das vollständige Toolschema finden Sie in der compute_routes-Referenz.

Anfrageoptionen

Option Beschreibung
origin, destination Erforderlich. Jedes Element ist ein Wegpunkt: eine address (eine menschenlesbare Adresse oder ein Plus Code), eine place_id oder eine lat_lng. Sie können Formate kombinieren, z. B. eine Adresse für den Startpunkt und eine Orts-ID für das Ziel.
travel_mode Das Transportmittel: DRIVE (Standard), WALK, BICYCLE oder TRANSIT. WALK-Routen befinden sich in der Betaphase. Manchmal fehlen klare Gehwege oder Fußgängerwege. Sie müssen diese Warnung für alle Fußgängerrouten anzeigen, die Sie in Ihrer App einblenden.
routing_preference Wie Verkehrsdaten zur Berechnung der Route verwendet werden: ROUTING_PREFERENCE_TRAFFIC_UNAWARE (Standard) oder ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, eine Pro-Option. ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL wird für WALK oder BICYCLE nicht unterstützt. Weitere Informationen finden Sie unter Verkehrsabhängiges Routing.
intermediate_waypoints Geordnete Zwischenstopps zwischen Start- und Zielort. Die Route führt in der angegebenen Reihenfolge durch sie. Eine Anfrage kann bis zu 10 Zwischenwegpunkte enthalten, oder 11 bis 25 als Pro-Option. Bei einer Anfrage mit mehr als 25 Elementen wird der Fehler INVALID_ARGUMENT zurückgegeben. Routen mit öffentlichen Verkehrsmitteln unterstützen keine Zwischenwegpunkte.
departure_time oder arrival_time Wann Sie vom Startpunkt abfahren oder am Ziel ankommen, als RFC 3339-Zeitstempel. Legen Sie höchstens einen Wert fest. Die Standardeinstellung ist die Abfahrt zur aktuellen Uhrzeit. Für TRANSIT kann die Zeit bis zu 7 Tage in der Vergangenheit oder 100 Tage in der Zukunft liegen. Bei anderen Mobilitätsformen darf die Zeit nicht in der Vergangenheit liegen und kann bis zu 365 Tage in der Zukunft liegen.
compute_alternative_routes Wenn true, enthält die Antwort neben der empfohlenen Route auch alternative Routen, sofern verfügbar. Die Standardeinstellung ist false.
include_polyline Wenn true, enthält jede Route in der Antwort encodedPolyline. Die Standardeinstellung ist false.
location_bias Ein Breiten- und Längengrad, der die Auflösung von Textwegpunkten beeinflusst, z. B. um eine Adresse eindeutig zu machen.

Pro-Optionen

Zwei Optionen wählen die Pro-SKU aus. Eine Anfrage, bei der eine oder beide Optionen verwendet werden, wird über die Pro-SKU abgerechnet:

Pro-Option Anwendungsbereich
Standort „routing_preference“ auf „ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL“ gesetzt Der Nutzer fragt nach dem Verkehr, Staus oder einer Fahrtzeit, die den aktuellen Verkehr berücksichtigt. Weitere Informationen finden Sie unter Verkehrsabhängiges Routing.
11 bis 25 intermediate_waypoints Die Route erfordert mehr als 10 Stopps zwischen Start- und Zielort.

Alle anderen Optionen werden über die Essentials-SKU abgerechnet, einschließlich Reisemodus, Zeitangaben, alternative Routen, Polylinien und Standortgewichtung.

Verkehrsabhängige Routenplanung

Standardmäßig werden Routen ohne Berücksichtigung der aktuellen Verkehrslage (ROUTING_PREFERENCE_TRAFFIC_UNAWARE) berechnet. Diese Einstellung hat die niedrigste Latenz. Sie eignet sich für Anfragen, bei denen der Verkehr keine Rolle spielt oder nicht relevant ist, z. B. für Fußgängerrouten oder grobe Planungen.

Setzen Sie routing_preference auf ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, um die Route und ihre Dauer anhand der aktuellen Verkehrslage zu berechnen, sofern Verkehrsdaten verfügbar sind. Verwenden Sie es, wenn der Nutzer fragt, wie lange eine Fahrt gerade dauert. Bei TRANSIT-Routen werden für diese Einstellung Echtzeitdaten zu öffentlichen Verkehrsmitteln verwendet, z. B. zu Verspätungen und Ausfällen, sofern verfügbar. Sie wird für WALK- oder BICYCLE-Routen nicht unterstützt. Bei solchen Anfragen wird der Fehler INVALID_ARGUMENT zurückgegeben. Dies ist eine Pro-Option, daher wird die Anfrage unter der Pro-SKU abgerechnet. Die Option erhöht auch die Latenz.

Wenn Ihr Projekt während der eingeschränkten GA nicht auf der Pro-Zulassungsliste steht, wird diese Option als ROUTING_PREFERENCE_TRAFFIC_UNAWARE behandelt. Weitere Informationen finden Sie unter Pro-Optionen während der eingeschränkten GA.

Beispiel

In der folgenden Anfrage wird eine verkehrsabhängige Route mit einem Zwischenstopp und einer codierten Polylinie angefordert. Die Abrechnung erfolgt unter der Pro-SKU:

{
  "method": "tools/call",
  "params": {
    "name": "compute_routes",
    "arguments": {
      "origin": {"address": "Ferry Building, San Francisco, CA"},
      "destination": {"address": "Golden Gate Park, San Francisco, CA"},
      "intermediate_waypoints": [
        {"address": "Palace of Fine Arts, San Francisco, CA"}
      ],
      "travel_mode": "DRIVE",
      "routing_preference": "ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL",
      "include_polyline": true
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

Antwort

Die Antwort enthält routes[], sortiert von der am meisten empfohlenen bis zur am wenigsten empfohlenen. Es wird nur eine Route zurückgegeben, es sei denn, compute_alternative_routes ist true. Jede Route enthält:

  • distanceMeters: Die Länge der Route in Metern.
  • duration: Die Zeit, die für die Route benötigt wird. Bei ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL wird die Verkehrslage bei der Dauer berücksichtigt.
  • encodedPolyline: Der Pfad der Route als codierte Polylinie, wenn include_polyline den Wert true hat. Sie können sie verwenden, um die Route mit anderen Google Maps Platform APIs auf einer Karte einzuzeichnen.
  • attribution: Die Quellenangabe, die Sie mit der Route anzeigen müssen. Weitere Informationen finden Sie unter Anforderungen an die Quellenangabe.

Pro-Optionen während der eingeschränkten GA

Während der eingeschränkten GA sind Pro-Optionen nur für Projekte auf der Pro-Zulassungsliste verfügbar. Wenn Ihr Projekt noch nicht auf der Zulassungsliste steht:

  • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL wird als ROUTING_PREFERENCE_TRAFFIC_UNAWARE behandelt und die Anfrage wird unter der Essentials-SKU abgerechnet.
  • Bei einer Anfrage mit mehr als 10 Zwischenwegpunkten wird der Fehler INVALID_ARGUMENT zurückgegeben („Es werden maximal 10 Zwischenwegpunkte unterstützt.“).

Informationen zum Anfordern des Zugriffs finden Sie unter Pro-Optionen während der eingeschränkten GA.

Abrechnung und Kontingente

Jede compute_routes-Anfrage ist ein abrechenbares Ereignis:

  • Eine Anfrage, für die keine Pro-Optionen verwendet werden, wird über die Essentials-SKU abgerechnet.
  • Eine Anfrage, für die eine Pro-Option verwendet wird, wird über die Pro-SKU abgerechnet. Wenn Sie beide Pro-Optionen in einer Anfrage verwenden, ändert sich der Preis nicht. Informationen zu den Preisen für die Pro-Version finden Sie unter Essentials, Pro und Fundierung mit Google Maps vergleichen.

Wenn Sie alternative Routen, eine Polylinie, eine Abfahrts- oder Ankunftszeit oder ein anderes Verkehrsmittel anfordern, ändert sich die SKU nicht.

Das compute_routes-Kontingent beträgt 300 Abfragen pro Minute und Projekt, die von beiden SKUs gemeinsam genutzt werden. Informationen zu den Preisen finden Sie in der Hauptpreistabelle und der Preistabelle für Indien.

Limits

  • Eine Anfrage kann maximal 25 Zwischenwegpunkte enthalten. 11 bis 25 Wegpunkte sind eine Pro-Option. Eine Anfrage mit mehr gibt den Fehler INVALID_ARGUMENT zurück.
  • Für Routen mit öffentlichen Verkehrsmitteln werden keine Zwischenwegpunkte unterstützt. Eine Anfrage für öffentliche Verkehrsmittel mit Zwischenwegpunkten gibt den Fehler INVALID_ARGUMENT zurück.
  • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL wird für Fußgänger- oder Fahrradrouten nicht unterstützt.
  • Bei Routen mit öffentlichen Verkehrsmitteln können Abfahrts- und Ankunftszeiten bis zu 7 Tage in der Vergangenheit oder 100 Tage in der Zukunft liegen. Bei anderen Mobilitätsformen darf die Zeit nicht in der Vergangenheit liegen und kann bis zu 365 Tage in der Zukunft liegen.
  • Die Wegpunktkoordinaten müssen innerhalb gültiger geografischer Grenzen liegen (Breitengrad von -90 bis 90, Längengrad von -180 bis 180).
  • Das Tool gibt keine detaillierten Routenführung, Abschnitte oder Details zu ÖPNV-Linien zurück.