Vorteile der Routes API
Mit der Routes API können Sie genaue Routen und Fahrtinformationen mithilfe von Mobilitätsdetails, aktuellen Verkehrs- und Straßenbedingungen sowie Routeneinstellungen abrufen:
Art und Ausstattung der verschiedenen Mobilitätsformen
Die Richtung, in die sich ein Fahrzeug bewegt
Die Straßenseite für Abhol- oder Bringvorgänge
Verkehrslage und Straßensperrungen
Sicherheitsbedenken, z. B. das Vermeiden gefährlicher Gebiete oder die Bereitstellung sicherer Abholbereiche
Mit optionalen Features wie Mautgebühren und Fahrtmetadaten wie Zeit und Entfernung sowie Kraftstoffeffizienz können Sie Latenz, Qualität und Kosten auf Ihre Routinganforderungen ausgleichen.
Außerdem können Sie die effizientesten Routen für die Dispositionsplanung ermitteln, z. B.:
Wie Sie einer Gruppe von Mitarbeitern die Aufgabe zuweisen, eine Reihe von Paketen abzuholen
Das beste Warenlager für den Versand der Pakete zum endgültigen Bestimmungsort bestimmen
Was kann ich mit der Routes API tun?
Mit der Routes API können Sie zwei Hauptkategorien von Routinginformationen abrufen:
Routen von einem Standort zu einem oder mehreren Zielen
Eine Matrix möglicher Routen zwischen vielen Start- und Endpunkten.
Routen für ein oder mehrere Ziele berechnen
Mit der Compute Routes
-Methode der Routes API können Sie Folgendes berechnen:
Sie können Wegbeschreibungen für verschiedene Verkehrsmittel und für ein oder mehrere Ziele abrufen:
Mobilitätsformen, einschließlich öffentlicher Verkehrsmittel, Autos, Motorräder, Fußgänger oder Fahrrad.
Eine Reihe von Wegpunkten, die Sie so optimieren können, dass sie möglichst effizient erreicht werden.
Mehrere Möglichkeiten, Start- und Zielorte sowie Wegpunkte anzugeben:
Textzeichenfolgen. 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 Ihre 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.
Legen Sie detaillierte Optionen für die Trafficberechnung fest, um Entscheidungen über Qualität und Latenz treffen zu können. Weitere Informationen finden Sie unter Festlegen, wie und ob Besucherdaten einbezogen werden.
Damit die voraussichtliche Ankunftszeit genauer wird, kannst du die Fahrtrichtung (Fahrtrichtung) und Straßenkreuzungen für Wegpunkte angeben. Weitere Informationen
Geben Sie den Passthrough- oder Terminalstandort sowie sichere Aufenthaltsorte an. Weitere Informationen finden Sie unter Haltestelle an einer Route festlegen und Punkt festlegen, durch den eine Route verlaufen soll.
Fordere Mautinformationen mit Entfernung und voraussichtliche Ankunftszeit an. Weitere Informationen finden Sie unter Mautgebühren für eine Route berechnen.
Kontrollieren Sie Ihre Latenz und Qualität, indem Sie mithilfe einer Feldmaske nur die benötigten Daten anfordern. So können Sie unnötige Verarbeitungszeiten und höhere Anfragegebühren vermeiden. Weitere Informationen finden Sie unter Zurückzugebende Informationen auswählen.
Matrix der möglichen Routen abrufen
Mit der Methode Compute Route Matrix
der Routes API wird eine Matrix mit Informationen für empfohlene Routen zwischen mehreren Start- und Endpunkten bereitgestellt, einschließlich Entfernung und geschätzter Ankunftszeit. Dies erleichtert Ihnen die Auswahl der besten Start- und Zielorte für Ihre geschäftlichen Anforderungen. Sie können folgende Arten von Entfernungsdaten anfordern:
Entfernung für eine ausgewählte Mobilitätsform
Entfernung in Kilometern oder Meilen
Geschätzte Fahrzeit bei Stau
Mithilfe der Entfernungsdaten können Sie die effizienteste Methode ermitteln, um Passagiere, Lieferungen oder Mitarbeiter zwischen mehreren möglichen Start- und Zielorten zu leiten.
Sie können Elemente der Antwort streamen, bevor die gesamte Matrix berechnet wurde, um die Antwortlatenz zu verringern.
Sie können pro serverseitige Anfrage mehrere Start- und Zielorte angeben, wobei sich die Anzahl der Startorte multipliziert mit der Anzahl der Zielorte auf 625 bezieht.
Funktionsweise der Routes API
Die Routes API bietet zwei Methoden: ComputeRoutes
und ComputeRouteMatrix
.
ComputeRoutes
Die ComputeRoutes
-Methode der Routes API akzeptiert eine HTTP-POST-Anfrage mit einem JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind „origin“, „destination“, „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.
ComputeRouteMatrix
Die Routes API ComputeRouteMatrix
akzeptiert eine HTTP-POST-Anfrage mit einem JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind mindestens ein Startort, zwei oder mehr Ziele, „travelMode“ und eine Feldmaske, mit der angegeben wird, welche Felder zurückgegeben werden sollen.
Beispiel
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
Die Antwort enthält die möglichen Routen für die Kombination aller Wegpunkte vom Ausgangs- und Zielort.
Ressourcen
In der folgenden Tabelle sind die über die Routes API verfügbaren Ressourcen zusammen mit den zurückgegebenen Daten zusammengefasst.
Datenressourcen | Zurückgegebene Daten | Rückgabeformat |
---|---|---|
ComputeRoutes | Gibt Routen, Streckenabschnitte und Schritte für eine Route zurück, gegebenenfalls mit alternativen Routen. | JSON |
ComputeRouteMatrix | Gibt ein Array mit Routen von einem Ausgangswegpunkt zu einem Zielwegpunkt zurück. |
Routes API verwenden
1 | Einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung. |
2 | Route berechnen und Antwort prüfen | Weitere Informationen finden Sie unter Route berechnen und Routenantworten ansehen. |
3 | Die Matrix der Routen berechnen und die Antwort prüfen | Weitere Informationen finden Sie unter Routenmatrix abrufen und Routenmatrixantwort prüfen. |
Verfügbare Clientbibliotheken
Eine Liste der verfügbaren Clientbibliotheken für die Routes API finden Sie unter Clientbibliotheken.