Vorteile der Routes API
Mit der Routes API können Sie anhand von Transportdetails, aktuellen Verkehrs- und Straßenverhältnissen sowie Routeneinstellungen genaue Routen- und Fahrtinformationen abrufen:
Arten und Funktionen der verschiedenen Mobilitätsformen
In welche Richtung ein Fahrzeug geht
Der Straßenrand zum Ein- und Aussteigen
Verkehrslage und Straßensperrungen
Sicherheitsbedenken, z. B. die Vermeidung gefährlicher Gebiete oder die Bereitstellung sicherer Abholbereiche
Mit optionalen Features wie Mautstraßen und Fahrtmetadaten wie Zeit, Entfernung und Kraftstoffeffizienz können Sie Latenz, Qualität und Kosten auf Ihre Routenanforderungen abstimmen.
Sie können auch die effizientesten Routen für die Dispositionsplanung bestimmen, z. B.:
Wie Sie am besten eine Gruppe von Mitarbeitern zur Abholung einer Reihe von Paketen zuweisen
Das beste Lager auswählen, von dem aus Pakete an ihr endgültiges Ziel verschickt werden sollen
Was kann ich mit der Routes API tun?
Mit der Routes API können Sie zwei primäre Kategorien von Routinginformationen abrufen:
Routen von einem Standort zu einem oder mehreren Zielen
Matrix möglicher Routen zwischen vielen Start- und Zielorten.
Routen für ein oder mehrere Ziele abrufen
Mit der Compute Routes
-Methode der Routes API können Sie zwischen Standorten berechnen:
Rufen Sie Wegbeschreibungen für verschiedene Verkehrsmittel und für ein oder mehrere Ziele ab:
Mobilitätsformen wie öffentliche Verkehrsmittel, Auto, Motorrad, zu Fuß oder mit dem Fahrrad.
Eine Reihe von Wegpunkten, die Sie für die effizienteste Reihenfolge optimieren können.
Es gibt mehrere Möglichkeiten, Startorte, Zielorte und 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 Richtung des Fahrzeugs
Optimieren Sie Ihre Routenoptionen anhand Ihrer Anforderungen und Ziele:
Wählen Sie kraftstoff- oder energieeffiziente Routen für den Motortyp Ihres Fahrzeugs aus: Diesel, Elektro, Hybrid, Benzin. Weitere Informationen finden Sie unter spritsparende Route berechnen.
Legen Sie detaillierte Optionen für die Traffic-Berechnung fest, damit Sie Entscheidungen hinsichtlich Qualität und Latenz treffen können. Weitere Informationen finden Sie unter Festlegen, wie und ob Verkehrsdaten einbezogen werden sollen.
Legen Sie die Fahrzeugausrichtung (Fahrtrichtung) und Informationen zur Straßenseite für Wegpunkte fest, um die Genauigkeit der voraussichtlichen Ankunftszeit zu erhöhen. Weitere Informationen finden Sie unter Ausrichtung und Straßenseite angeben.
Geben Sie Standorte für Durchfahrten und Terminals sowie sichere Zwischenstopps an. Weitere Informationen finden Sie unter Haltestelle entlang einer Route festlegen und Punkt für eine Durchquerung einer Route festlegen.
Fordern Sie Mautinformationen sowie die Entfernung der Route und die 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 Daten anfordern, die Sie wirklich benötigen. So vermeiden Sie unnötige Verarbeitungszeiten und höhere Kosten für Anfragen. Weitere Informationen finden Sie unter Auswählen, welche Informationen zurückgegeben werden sollen.
Matrix möglicher Routen abrufen
Die Compute Route Matrix
-Methode der Routes API bietet eine Matrix mit Informationen für empfohlene Routen zwischen mehreren Start- und Endpunkten, einschließlich Entfernung und geschätzter Ankunftszeit. So können Sie die besten Start- und Zielorte für Ihre geschäftlichen Anforderungen auswählen. Sie können folgende Arten von Entfernungsdaten anfordern:
Strecke für eine ausgewählte Mobilitätsform
Strecke in Kilometern oder Meilen
Geschätzte Reisezeit bei starker Verkehrslage
Mit den Entfernungsdaten können Sie die effizienteste Methode ermitteln, um Passagiere, Lieferungen oder Arbeitskräfte zwischen mehreren möglichen Start- und Zielorten weiterzuleiten.
Sie können Elemente der Antwort streamen, bevor die gesamte Matrix berechnet wurde, wodurch die Antwortlatenz verringert wird.
Sie können pro serverseitiger Anfrage mehrere Start- und Zielorte angeben. Dabei ergibt sich maximal 625 aus der Anzahl der Startorte multipliziert mit der Anzahl der Ziele.
Funktionsweise der Routes API
Die Routes API hat zwei Methoden: ComputeRoutes
und ComputeRouteMatrix
.
ComputeRoutes
Die Methode ComputeRoutes
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 festzulegen, 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 Abflugort, mindestens zwei Reiseziele, „travelMode“ und eine Feldmaske, um festzulegen, 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 Start- und Ziel-Wegpunkte.
Ressourcen
In der folgenden Tabelle sind die über die Routes API verfügbaren Ressourcen und die zurückgegebenen Daten zusammengefasst.
Datenressourcen | Zurückgegebene Daten | Rückgabeformat |
---|---|---|
ComputeRoutes | Gibt Routen, Streckenabschnitte und Schritte für eine Route mit alternativen Routen zurück, falls angefordert. | JSON |
ComputeRouteMatrix | Gibt ein Array mit Routen von einem Ursprungs-Wegpunkt zu einem Ziel-Wegpunkt zurück. |
Routes API verwenden
1 | Jetzt einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung zur Einrichtung. |
2 | Route berechnen und die Antwort prüfen | Weitere Informationen finden Sie unter Route berechnen und Routenantworten ansehen. |
3 | Matrix der Routen berechnen und die Antwort überprüfen | Weitere Informationen finden Sie unter Routenmatrix abrufen und Antwort der Routenmatrix prüfen. |
Verfügbare Clientbibliotheken
Eine Liste der verfügbaren Clientbibliotheken für die Routes API finden Sie unter Clientbibliotheken.