Roads API – Übersicht

Der Roads API ist ein Dienst, der HTTPS-Anfragen mit Breiten-/Längengradkoordinaten für einen oder mehrere Punkte auf einer Karte akzeptiert. Anhand dieser Punkte werden Straßenabschnitte in der Nähe gesucht und zusammen mit Metadaten wie dem nächstgelegenen Straßenabschnitt und Geschwindigkeitsbegrenzungen eine Orts-ID zurückgegeben.

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.

  • JSON
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:

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