Roads API – Übersicht

Der Roads API ist ein Dienst, der HTTPS-Anfragen mit Breiten- und Längengradkoordinaten für einen oder mehrere Punkte auf einer Karte akzeptiert. Anhand dieser Punkte werden nahegelegene Straßenabschnitte gesucht und eine Orts-ID zusammen mit Metadaten wie dem nächsten Straßenabschnitt und Geschwindigkeitsbegrenzungen 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
  • nächstgelegene Straße für Koordinaten finden
  • Geschwindigkeitsbegrenzungen für Straßenabschnitte abrufen

Möglichkeiten mit der Roads API

Mit dem Roads API-Objekt lassen sich der Geometrie der Straße GPS-Koordinaten zuordnen und die Höchstgeschwindigkeit entlang von Straßenabschnitten festlegen.

  • An Straßen ausrichten: Dieser Dienst gibt die Straßen zurück, die am häufigsten basierend auf den angegebenen GPS-Koordinaten befahren wurden. Du kannst 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 das nächstgelegene Straßensegment 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 angegebene Höchstgeschwindigkeit für einen Straßenabschnitt zurück. Die Geschwindigkeitsbegrenzung ist für alle Kunden mit einer Lizenz für das Asset-Tracking verfügbar. Für Kunden mit der Google Maps Platform-Premiumoption, die auf „Pay as you go“-Preise umgestellt haben, bleibt die Funktion aktiv.

Funktionsweise der Roads API

Die Roads API verwendet drei Endpunkte, die Breiten- und Längengrade oder Orts-IDs akzeptieren, um Daten zu Straßenpfaden, Segmenten oder 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 bei Straßen eingegrenzte Längengrad- und Breitengradkoordinaten sowie Orts-IDs. Weitere Informationen finden Sie im Leitfaden An Straßen ausrichten unter Antworten.
  • JSON
Nächste Straßen

Ein Array von bis zu 100 unabhängigen Breiten- und Längengradkoordinaten sowie 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 von bis zu 100 Straßenmetadatenelementen Sie enthalten Geschwindigkeitsbegrenzungen und Orts-IDs mit Einheiten in km/h oder mph. Weitere Informationen finden Sie unter Antworten im Leitfaden zur Geschwindigkeitsbegrenzung.

Roads API verwenden

1 Demo zum Ausrichten an Straßen ausprobieren Klicken Sie auf die Demo, um eine Strecke zu erstellen und zu sehen, wie der Endpunkt „Dem Straßenverlauf“ 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 führen Sie die folgenden Einrichtungsanleitungen aus. Hier erfahren Sie, wie Sie Ihren API-Schlüssel verwenden.
3 Anfrage „Dem Straßenverlauf anpassen“ ausprobieren Verwenden Sie eines der Beispiele für „Dem Straßenverlauf anpassen“ und versuchen Sie es mit einem für Ihren Anwendungsfall relevanten.
4 Geschwindigkeitsbegrenzungen auf der Straße festlegen Führen Sie unter Verwendung derselben Pfaddaten, die Sie für Ihre Anfrage zum Abheben von Straßen angegeben haben, eine Abfrage der Geschwindigkeitsbegrenzung aus. Weitere Informationen finden Sie unter Beispielanfrage mit einem Pfad.
5 Weitere Informationen zum Verarbeiten langer Pfade Folgen Sie den Abschnitten zur Verarbeitung langer Pfade im Leitfaden Erweiterte Konzepte.
6 Straßendaten in Ihre eigene App einbinden Informationen zum Erstellen von Straßendatenfunktionen in Ihrer eigenen App finden Sie im detaillierten Codebeispiel aus der Demo zur Straßenaufnahme.

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 Installationsanleitungen und Beispielcode.

Nächste Schritte