Vorteile der Roads API
Mit der Roads API können Sie Geschwindigkeitsbegrenzungen, geschätzte Ankunftszeiten oder andere Straßenmetadaten abrufen. Mit diesen Straßenmetadaten kannst du deine Fahr-Apps um folgende Funktionen ergänzen:
- Koordinaten von Breiten- und Längengraden mit einer oder mehreren Straßen verbinden
- Die nächstgelegene Straße mit Koordinaten finden
- Geschwindigkeitsbegrenzungen für Straßenabschnitte abrufen
Möglichkeiten mit der Roads API
Mit Roads API können Sie GPS-Koordinaten der Geometrie der Straße zuordnen und die Geschwindigkeitsbegrenzung entlang von Straßenabschnitten festlegen.
- An Straßen ausrichten Dieser Dienst gibt die Straßen zurück, die basierend auf den angegebenen GPS-Koordinaten am wahrscheinlichsten zurückgelegt wurden. Sie können bis zu 100 GPS-Punkte angeben, die entlang einer Route erfasst werden. Optional können Sie auch anfordern, dass der Dienst zusätzliche Punkte interpoliert, sodass ein Pfad entsteht, der reibungslos der Geometrie der Straße folgt.
- Nächste Straßen: Dieser Dienst gibt den nächstgelegenen Straßenabschnitt für einen GPS-Punkt zurück. Sie können bis zu 100 GPS-Punkte angeben. Die angegebenen Punkte müssen nicht Teil eines zusammenhängenden Pfads sein.
- Geschwindigkeitsbegrenzungen: Dieser Dienst gibt die für einen Straßenabschnitt angegebene Geschwindigkeitsbegrenzung zurück. Die Geschwindigkeitsbegrenzung ist für alle Kunden mit einer Asset-Tracking-Lizenz verfügbar. Für Kunden mit der Google Maps Platform-Premiumoption, die auf „Pay as you go“-Preise umgestellt haben, bleibt die Funktion weiterhin aktiv.
So funktioniert die Roads API
Die Roads API verwendet drei Endpunkte, die Breiten- und Längengrade oder Orts-IDs akzeptieren, um Straßenpfade, Segmente oder Daten zu Geschwindigkeitsbegrenzungen bereitzustellen. Das folgende Beispiel zeigt eine Anfrage nach nächstgelegenen Straßen anhand eines Satzes von Breiten- und Längengradkoordinaten:
https://roads.googleapis.com/v1/nearestRoads ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796 &key=YOUR_API_KEY
Ressourcen
In der folgenden Tabelle sind die über die Roads API verfügbaren Ressourcen und die zurückgegebenen Daten zusammengefasst.
Datenressourcen | Zurückgegebene Daten | Rückgabeformat |
---|---|---|
An Straßen ausrichten |
Gibt ein Array von bis zu 100 GPS-Punkten einer Route zurück. Umfasst Längen- und Breitengradkoordinaten, bei denen eine Straße eingerastet ist, sowie Orts-IDs. Weitere Informationen finden Sie im Abschnitt Antworten im Leitfaden An Straßen ausrichten. |
|
Nächste Straßen |
Ein Array von bis zu 100 unabhängigen Breiten- und Längengradkoordinaten zusammen mit Orts-IDs für die nächstgelegene Straße für jeden angegebenen Punkt. Punkte müssen nicht kontinuierlich sein. Weitere Informationen finden Sie unter Antworten im Leitfaden Nächste Straßen. |
|
Geschwindigkeitsbegrenzungen |
Ein Array mit bis zu 100 Straßenmetadatenelementen. Diese enthalten Geschwindigkeitsbegrenzungen und Orts-IDs mit Einheiten in km/h oder mph. Weitere Informationen finden Sie im Abschnitt Antworten im Leitfaden zu Geschwindigkeitsbegrenzungen. |
Roads API verwenden
1 | Demo zum Ausrichten von Straßen | Klicken Sie auf die Demo, um einen Track zu erstellen und zu sehen, wie der Endpunkt zum Andocken an Straßen flüssige Daten liefert. Weitere Informationen finden Sie unter Demo im Leitfaden An Straßen ausrichten. Sie benötigen keinen API-Schlüssel. |
2 | Jetzt einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung. Anschließend erfahren Sie, wie Sie Ihren API-Schlüssel verwenden. |
3 | Anfrage zur Funktion „Dem Straßenverlauf anpassen“ ausprobieren | Verwenden Sie eines der Beispiele zum Ausrichten an Straßen und versuchen Sie es mit einem für Ihren Anwendungsfall relevanten. |
4 | Geschwindigkeitsbegrenzungen für den Straßenweg festlegen | Senden Sie eine Abfrage für die Geschwindigkeitsbegrenzung und verwenden Sie dieselben Pfaddaten, die Sie für die Anfrage zur Straßenanpassung angegeben haben. Weitere Informationen finden Sie unter Beispielanfrage mit einem Pfad. |
5 | Weitere Informationen zum Verarbeiten langer Pfade | Folgen Sie den Abschnitten Lange Pfade verarbeiten im Leitfaden Erweiterte Konzepte. |
6 | Straßendaten in Ihre App einbinden | Im detaillierten Codebeispiel aus der Demo für die Straßenaufnahme erfahren Sie, wie Sie Straßendatenfunktionen in Ihre eigene App einbinden. |
Verfügbare Clientbibliotheken
Rufen Sie diese API in der Sprache Ihrer Wahl über eine der folgenden Clientbibliotheken auf:
- Java-Client für Google Maps-Dienste
- Python-Client für Google Maps-Dienste
- Go-Client für Google Maps-Dienste
- Node.js-Client für Google Maps-Dienste
Die Java-, Python-, Go- und Node.js-Clients für Google Maps-Dienste sind von der Community unterstützte Clientbibliotheken, die unter der Apache 2.0-Lizenz als Open Source zur Verfügung gestellt werden. Laden Sie sie von GitHub herunter. Dort finden Sie auch eine Installationsanleitung und Beispielcode.
Nächste Schritte
- Roads API testen: Weitere Informationen finden Sie unter Roads Inspector.
- Informationen zum Senden von Roads API-Anfragen: Rufen Sie den entsprechenden Dienst auf:
- Erweiterte Konzepte verstehen: Erweiterte Konzepte aufrufen
- Best Practices anwenden: Rufen Sie Best Practices für Webdienste auf.