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 die aktuelle Verkehrslage und Routen mit mehr Zwischenstopps berücksichtigt.

Sie können compute_routes über den MCP-Server oder als REST-Methode computeRoutes aufrufen. Auf dieser Seite werden die Anfrageoptionen, einschließlich der Pro-Optionen, der Inhalt der Antwort und die Abrechnung von Anfragen beschrieben. Die vollständigen Schemas finden Sie in der compute_routes-MCP-Referenz und der computeRoutes-REST-Referenz.

Anfrageoptionen

In der folgenden Tabelle werden die Anfrageoptionen für compute_routes beschrieben:

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 darstellen.
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 diese Wegpunkte. 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 der Startort verlassen oder das Ziel erreicht werden soll, als RFC 3339-Zeitstempel. Legen Sie höchstens einen 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 zusätzlich zur empfohlenen Route 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 Breiten-/Längengradkoordinaten, die die Auflösung von Textwegpunkten beeinflussen, z. B. um eine Adresse eindeutig zu machen.

Pro-Optionen

Zwei Optionen wählen die Maps Grounding 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 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 die Verkehrslage keine Rolle spielt oder nicht relevant ist, z. B. für Fußgängerrouten oder eine grobe Planung.

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 sie, 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. Verspätungen und Ausfälle, sofern verfügbar. Er wird für WALK- oder BICYCLE-Routen nicht unterstützt. Solche Anfragen geben einen INVALID_ARGUMENT-Fehler zurück. Dies ist eine Pro-Option, daher wird die Anfrage unter der Pro-SKU abgerechnet. Die Option erhöht auch die Latenz.

Beispiel

In der folgenden MCP-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
}

Im folgenden Beispiel wird dieselbe Anfrage an die REST-Methode computeRoutes gesendet:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-d '{
  "origin": {"address": "Ferry Building, San Francisco, CA"},
  "destination": {"address": "Golden Gate Park, San Francisco, CA"},
  "intermediateWaypoints": [
    {"address": "Palace of Fine Arts, San Francisco, CA"}
  ],
  "travelMode": "DRIVE",
  "routingPreference": "ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL",
  "includePolyline": true
}' \
"https://mapstools.googleapis.com/v1:computeRoutes"

Ersetzen Sie dabei API_KEY durch Ihren eigenen API-Schlüssel.

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 darzustellen.
  • retrievalToken: Ein opakes Token, das für DRIVE-Routen zurückgegeben wird (10 Minuten gültig) und das Sie an search_along_route übergeben können, um Orte entlang dieser Route zu finden, ohne Wegpunkte noch einmal senden zu müssen.
  • attribution: Die Quellenangabe, die Sie mit der Route anzeigen müssen. Weitere Informationen finden Sie unter Anforderungen an die Quellenangabe.

Abrechnung und Kontingente

Jede compute_routes-Anfrage ist ein abrechenbares Ereignis:

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 für jedes Projekt und wird von beiden SKUs gemeinsam genutzt. Informationen zu den Preisen finden Sie in der Hauptpreistabelle und in 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.
  • Routen mit öffentlichen Verkehrsmitteln unterstützen keine Zwischenwegpunkte. 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 die 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 detaillierte Routenführung, Abschnitte oder Details zu ÖPNV-Linien zurück.