Roads API – Übersicht

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

Gründe für die Verwendung der Roads API

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

  • Breiten-/Längengradkoordinaten mit einer oder mehreren Straßen verknüpfen
  • Die nächstgelegene Straße für eine Reihe von Koordinaten finden
  • Geschwindigkeitsbegrenzungen für Straßenabschnitte abrufen

Möglichkeiten mit der Roads API

Mit der Roads API können Sie GPS-Koordinaten der Straßengeometrie zuordnen und die Geschwindigkeitsbegrenzung entlang von Straßen abschnitten ermitteln.

Funktionsweise von Roads API

Die Roads API verwendet drei Endpunkte, die Breiten-/Längengrad koordinaten oder Orts-IDs akzeptieren, um Daten zu Straßenpfaden, ‑abschnitten oder Geschwindigkeitsbegrenzungen bereitzustellen. Das folgende Beispiel zeigt eine Anfrage für die nächstgelegenen 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 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 von einer Route zurück. Enthält an Straßen ausgerichtete Längen-/Breitengradkoordinaten sowie Orts-IDs. Weitere Informationen finden Sie unter Antworten in der Anleitung Snap to Roads.
  • JSON
Nearest Roads

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 unter Antworten in der Anleitung Nearest Roads.
Geschwindigkeitsbegrenzungen

Ein Array mit bis zu 100 Straßenmetadatenelementen. Diese enthalten Geschwindigkeits begrenzungen und Orts-IDs in km/h oder mph. Weitere Informationen finden Sie unter Antworten in der Anleitung Geschwindigkeitsbegrenzungen.

Verwendung der Roads API

1 Demo „Snap to Roads“ ausprobieren Klicken Sie auf die Demo, um eine Strecke zu erstellen und zu sehen, wie der Endpunkt „Snap to Roads“ reibungslose Daten liefert. Weitere Informationen finden Sie unter Demo in der Anleitung Snap to Roads. Sie benötigen keinen API-Schlüssel.
2 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 „Snap to Roads“ 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 Ihren Straßenpfad abrufen Senden Sie mit denselben Pfaddaten, die Sie für Ihre Anfrage „Snap to Roads“ angegeben haben, eine Anfrage zur Geschwindigkeitsbegrenzung. Weitere Informationen finden Sie unter Beispielanfrage mit einem Pfad.
5 Informationen zum Verarbeiten langer Pfade Folgen Sie den Abschnitten zu Verarbeitung langer Pfade in der Anleitung Erweiterte Konzepte.
6 Straßendaten in Ihre eigene App einbinden Im detaillierten Codebeispiel aus der Demo „Snap to Roads“ erfahren Sie, wie Sie die Funktion für Straßendaten in Ihre eigene App einbinden.

Verfügbare Clientbibliotheken

Sie können diese API in der Sprache Ihrer Wahl über eine der folgenden Clientbibliotheken aufrufen:

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. Sie können sie von GitHub herunterladen. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte