Vorteile der Routes API
Mit der Routes API erhalten Sie genaue Routen und Fahrtinformationen mit Verkehrsinformationen, aktuellen Verkehrs- und Straßenbedingungen sowie Einstellungen:
Art und Funktionen der verschiedenen Mobilitätsformen
In welche Richtung ein Fahrzeug fährt
Die Seite der Straße für Abhol- und Ausstiege
Verkehrslage und Straßensperrungen
Sicherheitsbedenken, z. B. das Vermeiden gefährlicher Gebiete oder die sichere Abholung Regionen
Ausgleichen Sie Latenz, Qualität und Kosten auf Ihre Routinganforderungen mit optionalen Funktionen wie Mautgebühren und Fahrtmetadaten wie Zeit und Entfernung sowie Benzin Effizienz
Außerdem lassen sich die effizientesten Routen für die Dispositionsplanung ermitteln, z. B. als:
Wie Sie einer Gruppe von Mitarbeitern die Aufgabe zuweisen, eine Reihe von Paketen abzuholen
Das beste Warenlager für den Versand der Pakete bestimmen Ziel
Was kann ich mit der Routes API tun?
Mit der Routes API erhalten Sie zwei Hauptkategorien für Routen Informationen:
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 Methode Compute Routes
der Routes API
können Sie zwischen Standorten berechnen:
Routen für verschiedene Fortbewegungsarten und für eine oder mehrere Routen berechnen lassen Ziele:
Mobilitätsformen, einschließlich Transit, Auto, Motorrad, zu Fuß oder mit dem Fahrrad.
Eine Reihe von Wegpunkten, die Sie für die effizienteste Reihenfolge optimieren können, reisen.
Mehrere Möglichkeiten zur Angabe von Startorten, Zielorten und Wegpunkten:
Textzeichenfolgen. Beispiel: „Chicago, IL“, „Darwin, NT, Australia“, „1800 Amphitheatre Parkway, Mountain View, CA 94043, USA“ 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ähle kraftstoff- oder energieeffiziente Routen für den Motortyp deines Fahrzeugs aus: Diesel, Elektro, Hybrid, Gas Weitere Informationen finden Sie unter Hier finden Sie eine spritsparende Route.
Legen Sie detaillierte Optionen für die Traffic-Berechnung fest, um die Qualität im Vergleich zur Latenz. Weitere Informationen finden Sie unter Angeben, wie und ob Zugriffsdaten einbezogen werden
Fahrtrichtung (Fahrtrichtung) und Straßenkreuzung für um die Genauigkeit der voraussichtlichen Ankunftszeit zu erhöhen. Weitere Informationen finden Sie unter Geben Sie die Richtung und den Straßenrand des Fahrzeugs an.
Geben Sie den Passthrough- oder Terminalstandort sowie sichere Aufenthaltsorte an. Für finden Sie unter Einen Zwischenstopp entlang einer Route festlegen und Legen Sie einen Punkt für eine Route fest.
Fordere Mautinformationen mit Entfernung und voraussichtliche Ankunftszeit an. Weitere Informationen Weitere Informationen finden Sie unter Mautgebühren für eine Route berechnen.
Kontrollieren Sie Ihre Latenz und Qualität, indem Sie mithilfe von eine Feldmaske, mit der Sie unnötige Verarbeitungszeiten und Abrechnungstarife anfordern. Weitere Informationen finden Sie unter Wählen Sie aus, welche Informationen zurückgegeben werden sollen.
Matrix der möglichen Routen abrufen
Die Methode Compute Route Matrix
der Routes API bietet ein
Informationsmatrix für empfohlene Routen zwischen mehreren Start- und Endpunkten
Punkte, wie Entfernung und geschätzte Ankunftszeit, an, um Ihnen die Auswahl
besten Start- und Zielorten basierend auf Ihren
Geschäftsanforderungen. Sie können folgende Arten von Entfernungsdaten anfordern:
Entfernung für eine ausgewählte Mobilitätsform
Entfernung in Kilometern oder Meilen
Geschätzte Fahrtzeit bei starkem Verkehr
Mithilfe der Entfernungsdaten können Sie die effizienteste Route ermitteln. Passagiere, Lieferungen oder Arbeitnehmer zwischen mehreren möglichen Herkunftsorten und Ziele.
Sie können Elemente der Antwort streamen, bevor die gesamte Matrix erstellt wurde. wodurch die Antwortlatenz verringert wird.
Sie können mehrere Start- und Zielorte pro serverseitiger Anfrage angeben: die Anzahl der Startorte multipliziert mit der Anzahl der Ziele bis 625.
Funktionsweise der Routes API
Die Routes API bietet zwei Methoden: ComputeRoutes
und
ComputeRouteMatrix
.
ComputeRoutes
Die Methode ComputeRoutes
der Routes API akzeptiert eine HTTP-POST-Anfrage mit
Einen JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind ein Ursprung,
"destination", "travelMode" und eine Feldmaske zur Angabe der zurückzugebenden Felder.
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 angefordert.
ComputeRouteMatrix
Die Routes API ComputeRouteMatrix
akzeptiert eine HTTP-POST-Anfrage mit
Einen JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind mindestens eins
„origin“, zwei oder mehr Ziele, „travelMode“ und eine Feldmaske zur Angabe des
Felder, die 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 Startorte und Ziel-Wegpunkte.
Ressourcen
In der folgenden Tabelle sind die Ressourcen aufgeführt, die über die Routes API zusammen mit den zurückgegebenen Daten an.
Datenressourcen | Zurückgegebene Daten | Rückgabeformat |
---|---|---|
ComputeRoutes | Gibt Routen, Streckenabschnitte und Schritte für eine Route zurück, einschließlich alternativer Routen. wenn Sie dazu aufgefordert werden. | JSON |
ComputeRouteMatrix | Gibt ein Array von Routen von einem Ausgangswegpunkt zu einem Ziel zurück Wegpunkt. |
Routes API verwenden
1 | Einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung zur Einrichtung. |
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 Prüfen Sie die Route Matrix-Antwort. |
Verfügbare Clientbibliotheken
Eine Liste der verfügbaren Clientbibliotheken für die Routes API finden Sie unter Clientbibliotheken.