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 die Übersicht zu „Compute Route Matrix“.
Migration? Wenn Sie von der Distance Matrix API (Legacy) migrieren, finden Sie eine Migrationsanleitung ab Gründe für die Migration zur Routes API.
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 kann ich mit Compute Routes tun?
Mit der Compute Routes-Methode der Routes API haben Sie folgende Möglichkeiten:
Wegbeschreibungen für verschiedene Transportmittel und für ein oder mehrere Ziele abrufen:
Verkehrsmittel: öffentliche Verkehrsmittel, Auto, Zweiräder, Lkw, Fußgänger oder Fahrrad.
Eine Reihe von Wegpunkten, die Sie für die effizienteste Reihenfolge optimieren können, in der Sie sie anfahren.
Mehrere Möglichkeiten zum Angeben von Startpunkten, Zielen und Wegpunkten:
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
Routenoptionen anpassen:
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
Sie können detaillierte Optionen für die Traffic-Berechnung festlegen und so Entscheidungen zwischen Qualität und Latenz treffen. Weitere Informationen finden Sie unter Verkehrsdaten einbeziehen.
Legen Sie für Wegpunkte die Fahrtrichtung des Fahrzeugs und die Straßenseite fest, um die Genauigkeit der voraussichtlichen Ankunftszeit zu erhöhen. Weitere Informationen finden Sie unter Fahrzeugkurs 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, durch den eine Route verlaufen soll.
Mautinformationen sowie die Routenentfernung und die voraussichtliche Ankunftszeit anfordern Weitere Informationen finden Sie unter Mautgebühren für eine Route berechnen.
Latenz und Qualität steuern: Fordern Sie nur die Daten an, die Sie benötigen, indem Sie eine Feldmaske verwenden. So vermeiden Sie unnötige Verarbeitungszeiten und höhere Abrechnungssätze 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 Ursprungsort, ein Zielort, 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 Daten, die zurückgegeben werden.
| Datenressourcen | Zurückgegebene Daten | Rückgabeformat |
|---|---|---|
| ComputeRoutes | Gibt Routen, Abschnitte und Schritte für eine Route zurück, bei Bedarf auch alternative Routen. | JSON |
Compute Routes verwenden
| 1 | Einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Einrichtungsanleitung. |
| 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 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
- Auswählen, welche Informationen zurückgegeben werden sollen
- Von der Directions API (Legacy) migrieren
- Von der Vorabversion der Routes API zur allgemeinen Verfügbarkeit migrieren
