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, 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, 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:
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 Trafficdaten einbeziehen.
Legen Sie die Fahrtrichtung und die Informationen zur Straßenseite für Wegpunkte 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: Wenn Sie nur die Daten anfordern, die Sie benötigen, können Sie mit einer Feldmaske unnötige Verarbeitungszeiten und höhere Abrechnungssätze für Anfragen vermeiden. 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 | Informationen zur 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
- Festlegen, welche Informationen zurückgegeben werden sollen
- Von der Directions API (Legacy) migrieren
- Von der Vorabversion der Routes API zur allgemeinen Verfügbarkeit migrieren