Roads API – Übersicht

Die 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 Straßenabschnitte in der Nähe ermittelt und eine Orts-ID sowie Metadaten wie der nächstgelegene Straßenabschnitt und Geschwindigkeitsbegrenzungen zurückgegeben.

Vorteile des Roads API

Mit der Roads API können Sie Geschwindigkeitsbegrenzungen, voraussichtliche Ankunftszeiten oder andere Straßenmetadaten abrufen. Mit diesen Straßenmetadaten können Sie Ihre Fahr-Apps um die folgenden Funktionen erweitern:

  • Breiten- und Längengrade mit einer oder mehreren Straßen verbinden.
  • Nächstgelegene Straße für eine Reihe von Koordinaten finden
  • Geschwindigkeitsbegrenzungen für Straßenabschnitte abrufen

Was du mit dem Roads API tun kannst

Mit der Roads API können Sie GPS-Koordinaten der Geometrie der Straße zuordnen und die Geschwindigkeitsbegrenzung für Straßenabschnitte ermitteln.

  • Snap to Roads: Dieser Dienst gibt die wahrscheinlichsten Straßen zurück, die basierend auf den bereitgestellten GPS-Koordinaten befahren wurden. Sie können bis zu 100 GPS-Punkte angeben, die entlang einer Route erfasst wurden. Optional können Sie auch anfordern, dass der Dienst zusätzliche Punkte interpoliert, sodass ein Pfad entsteht, der der Geometrie der Straße folgt.
  • Nearest Roads: 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 für einen Straßenabschnitt geltende Geschwindigkeitsbegrenzung zurück. Der Speed Limit-Dienst ist für alle Kunden mit einer Asset-Tracking-Lizenz verfügbar. Für Kunden mit der Google Maps Platform-Premiumoption, die auf das „Pay as you go“-Preismodell umgestellt haben, bleibt die Funktion aktiv.

So funktioniert Roads API

Die Roads API verwendet drei Endpunkte, die Breiten-/Längengradkoordinaten oder Orts-IDs akzeptieren, um Straßenverläufe, Segmente oder Daten zu Geschwindigkeitsbegrenzungen bereitzustellen. Im folgenden Beispiel wird eine Anfrage für die nächstgelegenen Straßen basierend auf einer Reihe von Breiten- und Längengradkoordinaten gezeigt:

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 sowie die zurückgegebenen Daten zusammengefasst.

Datenressourcen Zurückgegebene Daten Rückgabeformat
Snap to Roads

Gibt ein Array mit bis zu 100 GPS-Punkten einer Route zurück. Enthält an Straßen ausgerichtete Längen- und Breitengrade sowie Orts-IDs. Weitere Informationen finden Sie im Leitfaden Snap to Roads unter Antworten.
  • JSON
Nächstgelegene Straßen

Ein Array mit bis zu 100 unabhängigen Breiten-/Längengradkoordinaten sowie Orts-IDs für die nächstgelegene Straße für jeden angegebenen Punkt. Die Punkte müssen nicht zusammenhängend sein. Weitere Informationen finden Sie im Leitfaden Nearest Roads unter Antworten.
Geschwindigkeitsbegrenzungen

Ein Array mit bis zu 100 Straßenmetadatenelementen. Diese enthalten Geschwindigkeitsbegrenzungen und Orts-IDs, wobei die Einheiten entweder in km/h oder mph angegeben sind. Weitere Informationen finden Sie im Leitfaden zu Geschwindigkeitsbegrenzungen unter Antworten.

So verwendest du die Roads API

1 Demo zu „Snap to Roads“ ausprobieren Klicken Sie auf die Demo, um einen Track zu erstellen und zu sehen, wie der Snap to Roads-Endpunkt reibungslos Daten liefert. Weitere Informationen finden Sie im Leitfaden zu Snap to Roads unter Demo. Sie benötigen keinen API-Schlüssel.
2 Einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Einrichtungsanleitung. Anschließend erfahren Sie, wie Sie Ihren API-Schlüssel verwenden.
3 Snap to Roads-Anfrage ausprobieren Verwenden Sie eines der Beispiele für „Snap to Roads“ und probieren Sie eines aus, das für Ihren Anwendungsfall relevant ist.
4 Geschwindigkeitsbegrenzungen für Ihre Route abrufen Senden Sie eine Anfrage zu Geschwindigkeitsbegrenzungen mit denselben Pfaddaten, die Sie für Ihre „Snap to Roads“-Anfrage angegeben haben. Siehe Beispielanfrage mit einem Pfad.
5 Informationen zum Verarbeiten langer Pfade Folgen Sie den Abschnitten unter Lange Pfade verarbeiten im Leitfaden Erweiterte Konzepte.
6 Straßendaten in Ihre eigene App einbinden Sehen Sie sich das ausführliche Codebeispiel aus der Demo „An Straße ausrichten“ an, um mit der Einbindung von Straßendatenfunktionen in Ihre eigene App zu beginnen.

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