Roads API

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 wird anhand der Punkte in der Nähe Straßenabschnitte ermittelt und eine Orts-ID zusammen mit Metadaten wie dem nächstgelegenen Straßensegment und Höchstgeschwindigkeiten zurückgegeben.

Vorteile der Roads API

Mit der Roads API können Sie Geschwindigkeitsbegrenzungen, voraussichtliche Ankunftszeiten und andere Metadaten abrufen. Mit diesen Metadaten können Sie Ihre Fahr-Apps mit den folgenden Funktionen optimieren:

  • Verknüpfen Sie Breiten- und Längengrade mit einer oder mehreren Straßen.
  • Finde die nächstgelegene Straße für Koordinaten
  • Geschwindigkeitsbegrenzungen für Straßenabschnitte abrufen

Einsatzmöglichkeiten der Roads API

Mit Roads API können Sie der Geometrie der Straße GPS-Koordinaten zuordnen und die Geschwindigkeitsbegrenzung entlang von Straßensegmenten bestimmen.

  • Snap to Roads: Dieser Dienst gibt basierend auf den bereitgestellten GPS-Koordinaten die wahrscheinlichsten Straßen zurück. Sie können bis zu 100 GPS-Punkte auf einer Route angeben. Sie können auch anfordern, dass der Dienst zusätzliche Punkte interpoliert. Das führt zu einem Weg, der der Geometrie der Straße reibungslos 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 von Ihnen angegebenen Punkte müssen nicht Teil eines kontinuierlichen Pfads sein.
  • Geschwindigkeitsbegrenzungen: Mit diesem Dienst wird die zulässige Höchstgeschwindigkeit für einen Straßenabschnitt zurückgegeben. Der Speed Limit-Dienst steht allen Kunden mit einer Asset-Tracking-Lizenz zur Verfügung. Bei Kunden mit 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ängengradkoordinaten oder Orts-IDs akzeptieren, um Straßenpfade, Segmente oder Geschwindigkeitsbegrenzungen bereitzustellen. Das folgende Beispiel zeigt eine Anfrage für nächstgelegene Straßen, basierend auf einer Reihe von Breiten-/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 werden die über die Roads API verfügbaren Ressourcen sowie die zurückgegebenen Daten zusammengefasst.

Datenressourcen Zurückgegebene Daten Rückgabeformat
An Straßen ausrichten

Gibt ein Array von bis zu 100 GPS-Punkten aus einer Route zurück. Umfasst Koordinaten für Breiten- und Längengrad sowie Straßen-IDs. Weitere Informationen finden Sie unter Antworten im Leitfaden An Straßen ausrichten.
  • JSON
Nächste Straßen

Ein Array mit bis zu 100 unabhängigen Breiten- und Längengraden sowie Orts-IDs für die nächstgelegene Straße für jeden angegebenen Punkt. Die Punkte müssen nicht fortlaufend sein. Weitere Informationen finden Sie in der Anleitung zu Nächstgelegenen Straßen unter Antworten.
Geschwindigkeitsbegrenzungen

Ein Array mit bis zu 100 Straßenmetadatenelementen. Sie enthalten Geschwindigkeitsbegrenzungen und Orts-IDs mit Einheiten in KPH oder MPH. Weitere Informationen finden Sie unter Antworten im Leitfaden für Geschwindigkeitsbeschränkungen.

Roads API verwenden

1 Demo „An der Straße ausrichten“ ausprobieren Klicken Sie auf die Demo, um einen Track zu erstellen und zu sehen, wie der Snapchat an Straßen-Endpunkt reibungslose 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 dem Einrichten Ihres Google Cloud-Projekts und folgen Sie der Anleitung zur Einrichtung, um anschließend Informationen zum Verwenden Ihres API-Schlüssels zu erhalten.
3 Anfrage an Snapchat senden Verwende eines der Snap to to Straßen-Beispiele und versuche es mit einem, der für deinen Anwendungsfall relevant ist.
4 Geschwindigkeitsbegrenzungen für den Weg bestimmen Verwenden Sie dieselben Pfaddaten, die Sie für Ihre Anfrage zur Straßen-zu-Straße-Verknüpfung angegeben haben. Weitere Informationen finden Sie unter Beispielanfrage mit einem Pfad.
5 Weitere Informationen zur Verarbeitung langer Pfade Folgen Sie den Abschnitten unter Lange Pfade verarbeiten im Leitfaden für erweiterte Konzepte.
6 Straßendaten in die eigene App einbinden! In dem detaillierten Codebeispiel aus der Demo zu einer Fahrt mit Snapchat können Sie Straßendaten in eine eigene App einbinden.

Verfügbare Clientbibliotheken

Rufen Sie diese API in einer Sprache Ihrer Wahl über eine der folgenden Clientbibliotheken auf:

Der Java-, Python-, Go- und Node.js-Client für Google Maps-Dienste sind von der Community unterstützte Clientbibliotheken, die mit der Apache 2.0-Lizenz als Open Source zur Verfügung gestellt werden. Laden Sie diese aus GitHub herunter. Dort finden Sie auch eine Installationsanleitung und einen Beispielcode.

Nächste Schritte