Einführung
„Compute Routes“ ist eine Methode im Routes API-Dienst, die eine HTTPS-Anfrage akzeptiert und die ideale Route zwischen zwei Standorten 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, lesen Sie den Hilfeartikel Compute Route Matrix – Übersicht.
Migrieren? Wenn Sie von der Distance Matrix API (Legacy) migrieren, finden Sie eine Anleitung 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 Vorlieben routen und gleichzeitig Kosten und Qualität optimieren.
Möglichkeiten mit „Compute Routes“
Mit der Methode Compute Routes der Routes API haben Sie folgende Möglichkeiten:
Wegbeschreibungen für verschiedene Reisemöglichkeiten und für ein oder mehrere Ziele abrufen:
Verkehrsmittel: öffentliche Verkehrsmittel, Auto, Motorrad, zu Fuß oder Fahrrad.
Eine Reihe von Wegpunkten, die Sie so optimieren können, dass Sie sie in der effizientesten Reihenfolge erreichen.
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 der Fahrtrichtung des Fahrzeugs
Routenoptionen an Ihre Bedürfnisse und Ziele anpassen:
Kraftstoff- oder energieeffiziente Routen für den Motortyp Ihres Fahrzeugs auswählen: Diesel, Elektro, Hybrid, Benzin. Weitere Informationen finden Sie unter Umweltfreundliche Routen abrufen.
Feingliedrige Optionen für die Verkehrsberechnung festlegen, mit denen Sie Entscheidungen zwischen Qualität und Latenz treffen können. Weitere Informationen finden Sie unter Festlegen, wie und ob Verkehrsdaten einbezogen werden sollen.
Fahrtrichtung des Fahrzeugs und Informationen zur Straßenseite für Wegpunkte festlegen, um die Genauigkeit der voraussichtlichen Ankunftszeit zu erhöhen. Weitere Informationen finden Sie unter Fahrtrichtung des Fahrzeugs und Straßenseite angeben.
Durchfahrts- und Zielorte sowie sichere Zwischenstopps angeben. Weitere Informationen finden Sie unter Zwischenstopp auf einer Route festlegen und Punkt festlegen, durch den eine Route verlaufen soll.
Mautinformationen zusammen mit der Routenentfernung und der voraussichtlichen Ankunftszeit anfordern. Weitere Informationen finden Sie unter Mautgebühren für eine Route berechnen.
Latenz und Qualität steuern, indem Sie nur die benötigten Daten mit einer Feldmaske anfordern. So vermeiden Sie unnötige Verarbeitungszeiten und höhere Abrechnungspreise für Anfragen. Weitere Informationen finden Sie unter Festlegen, welche Informationen zurückgegeben werden sollen.
Funktionsweise von „Compute Routes“
Die Methode ComputeRoutes der Routes API 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 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 Anfrage auch alternative Routen, | JSON |
„Compute Routes“ verwenden
| 1 | Einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung. |
| 2 | Abrechnung der Routes API verstehen | Weitere Informationen finden Sie unter Nutzung und Abrechnung. |
| 3 | Route berechnen und Antwort prüfen | Weitere Informationen finden Sie unter Route abrufen und Antworten auf Routenanfragen 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
- Festlegen, welche Informationen zurückgegeben werden sollen
- Von der Directions API (Legacy) migrieren
- Von der Vorabversion der Routes API zur allgemein verfügbaren Version migrieren
