Einführung
„Compute Routes“ ist eine Methode im Routes API-Dienst, die eine HTTPS-Anfrage akzeptiert und die ideale Route zwischen zwei Orten zurückgibt. Stellen Sie Ihren Nutzern Wegbeschreibungen per öffentlichem Verkehrsmittel, Fahrrad, Auto, Motorrad oder zu Fuß bereit – inklusive Verkehrsinformationen in Echtzeit.
Benötigen Sie Routenmatrizen? Wenn Sie an einer Routenmatrix interessiert sind, finden Sie weitere Informationen unter Compute Route Matrix – Übersicht.
Migration? Wenn Sie von der Distance Matrix API (Legacy) migrieren, finden Sie die Migrationsanleitung unter Warum zur Routes API migrieren?.
Vorteile von Compute Routes
Mit „Compute Routes“ können Sie Ihre Fahrzeuge oder Pakete anhand einer Vielzahl von Routendetails nach Ihren Wünschen routen und gleichzeitig Kosten und Qualität optimieren.
Was können Sie mit Compute Routes tun?
Mit der Routes API-Methode Compute Routes können Sie Folgendes tun:
Routen für verschiedene Verkehrsmittel und für ein oder mehrere Ziele abrufen:
Mobilitätsformen: öffentliche Verkehrsmittel, Auto, Zweiräder, Lkw, zu Fuß oder Fahrrad.
Eine Reihe von Wegpunkten, die Sie für die effizienteste Reihenfolge optimieren können, in der sie besucht werden sollen.
Mehrere Möglichkeiten zum Angeben von Startpunkten, Zielen und Wegpunkten verwenden:
Text strings. Beispiele: „Chicago, IL“, „Darwin, NT, Australien“, „1800 Amphitheatre Parkway, Mountain View, CA 94043“ oder „CWF6+FWX Mountain View, Kalifornien“
Orts-IDs
Breiten- und Längengradkoordinaten, optional mit Fahrtrichtung des Fahrzeugs
Passen Sie die Routenoptionen an, um Ihre Anforderungen und Ziele zu erfüllen:
Sie können Routen für Lkw und andere große Fahrzeuge anpassen, indem Sie Fahrzeugattribute wie Abmessungen, Gewicht und Gefahrgut angeben. Weitere Informationen finden Sie unter Routenplanung für große Fahrzeuge – Übersicht.
Wählen Sie kraftstoff- oder energiesparende Routen für den Motortyp Ihres Fahrzeugs aus: Diesel, Elektro, Hybrid, Benzin. Weitere Informationen finden Sie unter Verbrauchsarme Routenplanung.
Legen Sie detaillierte Optionen für die Berechnung des Verkehrs fest, um Entscheidungen über die Abwägung zwischen Qualität und Latenz zu treffen. Weitere Informationen finden Sie unter Festlegen, ob und wie Verkehrsdaten einbezogen werden sollen.
Sie können die Fahrtrichtung des Fahrzeugs und die Straßenseite für Wegpunkte festlegen, um die Genauigkeit der voraussichtlichen Ankunftszeit zu erhöhen. Weitere Informationen finden Sie unter Fahrtrichtung und Straßenseite angeben.
Geben Sie Durchfahrts- und Endpunkte sowie sichere Zwischenstopps an. Weitere Informationen finden Sie unter Zwischenstopp auf einer Route festlegen und Punkt festlegen, den eine Route passieren soll.
Informationen zu Mautgebühren sowie zur Routenlänge und voraussichtlichen Ankunftszeit anfordern Weitere Informationen finden Sie unter Mautgebühren für eine Route berechnen.
Latenz und Qualität steuern, indem Sie mit einer Feldmaske nur die benötigten Daten anfordern. So vermeiden Sie unnötige Verarbeitungszeiten und höhere Abrechnungssätze für Anfragen. Weitere Informationen finden Sie unter Auswählen, welche Informationen zurückgegeben werden sollen.
Funktionsweise von Compute Routes
Die Routes API-Methode ComputeRoutes akzeptiert eine HTTP-POST-Anfrage mit einem JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind ein Startpunkt, ein Ziel, travelMode und eine Feldmaske, um anzugeben, welche Felder zurückgegeben werden sollen.
Beispiel
curl -X POST -d '{ "origin": { "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043" }, "destination": { "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Der Dienst berechnet dann die angeforderte Route und gibt die von Ihnen angeforderten Felder zurück.
Ressourcen
In der folgenden Tabelle sind die Ressourcen zusammengefasst, die über die Methode „Compute Routes“ der Routes API verfügbar sind, sowie die zurückgegebenen Daten.
| Datenressourcen | Zurückgegebene Daten | Rückgabeformat |
|---|---|---|
| ComputeRoutes | Gibt Routen, Abschnitte und Schritte für eine Route zurück, auf Wunsch auch alternative Routen. | JSON |
Compute Routes verwenden
| 1 | Einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Einrichtungsanleitung. |
| 2 | Abrechnung für die Routes API | Weitere Informationen finden Sie unter Nutzung und Abrechnung. |
| 3 | Route berechnen und Antwort prüfen | Weitere Informationen finden Sie unter Route abrufen und Routenantworten prüfen. |
Verfügbare Clientbibliotheken
Eine Liste der verfügbaren Clientbibliotheken für Compute Routes finden Sie unter Clientbibliotheken.
Nächste Schritte
- Route abrufen
- Verfügbare Routenoptionen
- Informationen auswählen, die zurückgegeben werden sollen
- Von der Directions API (Legacy) migrieren
- Von der Vorabversion der Routes API zur GA-Version migrieren
