Vorteile der Routes API
Mit der Routes API erhalten Sie genaue Routen und Fahrtinformationen mit Transportdetails, aktuellen Verkehrs- und Straßenbedingungen sowie Routeneinstellungen:
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 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 Methode Compute Routes
der Routes API können Sie unterschiedliche Standorte berechnen:
Rufen Sie Wegbeschreibungen für verschiedene Fortbewegungsarten und für ein einzelnes oder mehrere Ziele ab:
Mobilitätsformen, einschließlich öffentlicher Verkehrsmittel, Auto, Zweiradfahrzeuge, Fußgänger oder Radfahrer.
Eine Reihe von Wegpunkten, die Sie so optimieren können, dass sie möglichst effizient erreicht werden.
Mehrere Möglichkeiten zur Angabe von Startorten, Zielorten und Wegpunkten:
Textzeichenfolgen. Beispiele: „Chicago, IL“, „Darwin, NT, Australia“, „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, Gas. Weitere Informationen finden Sie unter Elektronische Route berechnen.
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 Traffic-Daten einbezogen werden.
Damit die voraussichtliche Ankunftszeit genauer wird, kannst du die Fahrtrichtung (Fahrtrichtung) und Straßenseiteninformationen für Wegpunkte angeben. Weitere Informationen finden Sie unter Richtung eines Fahrzeugs und Seitwärtsrichtung angeben.
Geben Sie den Passthrough- und Terminalstandort sowie sichere Aufenthaltsorte an. Weitere Informationen finden Sie unter Stopp entlang einer Route festlegen und Punkt für eine Route festlegen.
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 Auswählen, welche Informationen zurückgegeben werden sollen.
Matrix der möglichen Routen abrufen
Mit der Compute Route Matrix
-Methode 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. 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:
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 Methode zur Routenführung von Passagieren, Lieferungen oder Arbeitern zwischen mehreren möglichen Start- und Zielorten ermitteln.
Sie können Elemente der Antwort streamen, bevor die gesamte Matrix berechnet wurde. Dadurch verringert sich die Antwortlatenz.
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 Methode ComputeRoutes
der Routes API akzeptiert eine HTTP-POST-Anfrage mit einem JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind die Felder „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 von Ihnen angeforderten Felder zurück.
ComputeRouteMatrix
Die ComputeRouteMatrix
der Routes API 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.
Weitere Informationen
In der folgenden Tabelle sind die über die Routes API verfügbaren Ressourcen und die zurückgegebenen Daten aufgeführt.
Datenressourcen | Zurückgegebene Daten | Rückgabeformat |
---|---|---|
ComputeRoutes | Gibt Routen, Streckenabschnitte und Schritte für eine Route zurück, gegebenenfalls mit alternativen Routen. | JavaScript Object Notation |
ComputeRouteMatrix | Gibt ein Array mit Routen von einem Ausgangswegpunkt zu einem Zielwegpunkt zurück. |
Routes API verwenden
1 | Jetzt einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung unten. |
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 Routenmatrix-Antwort prüfen. |
Verfügbare Clientbibliotheken
Eine Liste der verfügbaren Clientbibliotheken für die Routes API finden Sie unter Clientbibliotheken.