„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 Routenmatrixen? Weitere Informationen zu Routenmatrix finden Sie unter Compute Route Matrix – Übersicht.
Migriert? Wenn Sie von der Distance Matrix API (alte Version) migrieren, lesen Sie die Migrationsanleitung ab Warum zur Routes API migrieren?.
Vorteile von Compute Routes
Mit Compute Routes können Sie Ihre Fahrzeuge oder Pakete mithilfe einer Vielzahl von Routendetails nach Ihren Wünschen planen und gleichzeitig Kosten und Qualität optimieren.
Was kann ich mit Compute Routes tun?
Mit der Compute Routes
-Methode der Routes API können Sie Folgendes tun:
Sie können Wegbeschreibungen für verschiedene Verkehrsmittel und für ein oder mehrere Ziele abrufen:
Mobilitätsformen: öffentliche Verkehrsmittel, Auto, Zweiräder, zu Fuß oder Fahrrad
Eine Reihe von Wegpunkten, die Sie für die effizienteste Reihenfolge der Fahrt zu ihnen optimieren können.
Es gibt mehrere Möglichkeiten, Start- und Zielorte sowie Wegpunkte anzugeben:
Textstrings 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 Fahrzeugkurs
Passen Sie die Routenoptionen an Ihre Anforderungen und Ziele an:
Wählen Sie kraftstoff- oder energieeffiziente Routen für den Motortyp Ihres Fahrzeugs aus: Diesel, Elektro, Hybrid, Benzin. Weitere Informationen finden Sie unter Umweltfreundliche Routen abrufen.
Sie können detaillierte Optionen für die Traffic-Berechnung festlegen, um einen Kompromiss zwischen Qualität und Latenz zu finden. Weitere Informationen finden Sie unter Festlegen, wie und ob Besucherdaten einbezogen werden sollen.
Legen Sie die Fahrzeugrichtung und die Informationen zur Straßenseite für Wegpunkte fest, um die Genauigkeit der voraussichtlichen Ankunftszeit zu erhöhen. Weitere Informationen finden Sie unter Fahrzeuglenker und Straßenseite angeben.
Geben Sie Durchfahrts- und Terminalstandorte sowie sichere Zwischenstoppstandorte an. Weitere Informationen finden Sie unter Haltestelle an einer Route festlegen und Punkt festlegen, durch den eine Route verlaufen soll.
Sie können Informationen zu Mautgebühren sowie zur Routenlänge und zur voraussichtlichen Ankunftszeit anfordern. Weitere Informationen finden Sie unter Mautgebühren für eine Route berechnen.
Verwalten Sie Latenz und Qualität, indem Sie mithilfe einer Feldmaske nur die Daten anfordern, die Sie benötigen. So vermeiden Sie unnötige Verarbeitungszeiten und höhere Abrechnungsraten für Anfragen. Weitere Informationen finden Sie unter Zurückzugebende Informationen auswählen.
So funktioniert „Compute Routes“
Die ComputeRoutes
-Methode der Routes API akzeptiert eine HTTP-POST-Anfrage mit einem JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind ein Ursprung, ein Ziel, travelMode
und eine Feldmaske, mit der angegeben wird, 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 über die Methode „Compute Routes“ der Routes API verfügbaren Ressourcen sowie die zurückgegebenen Daten zusammengefasst.
Datenressourcen | Zurückgegebene Daten | Rückgabeformat |
---|---|---|
ComputeRoutes | Gibt Routen, Strecken und Schritte für eine Route zurück, gegebenenfalls mit alternativen Routen. | JSON |
Compute Routes verwenden
1 | Einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung. |
2 | Abrechnung der 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 überprüfen. |
Verfügbare Clientbibliotheken
Eine Liste der verfügbaren Clientbibliotheken für Compute Routes finden Sie unter Clientbibliotheken.
Nächste Schritte
- Route planen
- Verfügbare Routenoptionen
- Auswählen, welche Informationen zurückgegeben werden sollen
- Von der Directions API (alte Version) migrieren
- Von der Routes API-Vorabversion zu GA migrieren