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 nahegelegene Straßenabschnitte ermittelt und eine Orts-ID sowie Metadaten wie der nächste Straßenabschnitt und Tempolimits zurückgegeben.

Vorteile der Roads API

Mit der Roads API können Sie Tempolimits, voraussichtliche Ankunftszeiten oder andere Straßenmetadaten abrufen. Mit diesen Straßenmetadaten können Sie Ihre Navigations-Apps mit den folgenden Funktionen erweitern:

  • Breiten- und Längengradkoordinaten mit einer oder mehreren Straßen verbinden
  • Die 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 Straßen-Geometrie zuordnen und das Tempolimit für Straßenabschnitte ermitteln.

  • Snap to Roads: Dieser Dienst gibt die wahrscheinlichsten Straßen zurück, die auf Grundlage der 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 angegebene Geschwindigkeitsbegrenzung für einen Straßenabschnitt zurück. Der Dienst „Tempolimit“ ist für alle Kunden mit einer Asset Tracking-Lizenz verfügbar. Für Kunden mit der Google Maps Platform-Premiumoption, die auf die nutzungsbasierte Abrechnung 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
An Straßen ausrichten

Gibt ein Array mit bis zu 100 GPS-Punkten einer Route zurück. Enthält an Straßen angepasste Breiten-/Längengradkoordinaten sowie Orts-IDs. Weitere Informationen finden Sie im Leitfaden An Straßen ausrichten im Abschnitt Antworten.
  • JSON
Nächstgelegene 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 im Leitfaden Nächstgelegene Straßen unter Antworten.
Geschwindigkeitsbegrenzungen

Ein Array mit bis zu 100 Metadatenelementen für Straßen. Sie enthalten Geschwindigkeitsbegrenzungen und Orts-IDs, wobei die Einheiten entweder in km/h oder mph angegeben sind. Weitere Informationen finden Sie im Leitfaden zu Geschwindigkeitsbegrenzungen im Abschnitt Antworten.

Verwendung von Roads API

1 Demo für das Ausrichten an Straßen ausprobieren Klicken Sie auf die Demo, um einen Track zu erstellen und zu sehen, wie der Endpunkt „Snap to Roads“ für reibungslose Daten sorgt. Demo im Leitfaden An Straßen ausrichten Sie benötigen keinen API-Schlüssel.
2 Einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Einrichtungsanleitung. Hier erfahren Sie, wie Sie Ihren API-Schlüssel verwenden.
3 Snap-to-Roads-Anfrage ausprobieren Verwenden Sie eines der Beispiele für das Anpassen an Straßen, das für Ihren Anwendungsfall relevant ist.
4 Geschwindigkeitsbegrenzungen für Ihre Route abrufen Verwenden Sie dieselben Pfaddaten, die Sie für Ihre Anfrage zum Anpassen an Straßen angegeben haben, um eine Anfrage zum Tempolimit zu stellen. Beispielanfrage mit einem Pfad
5 Informationen zum Verarbeiten langer Pfade Folgen Sie der Anleitung im Abschnitt Lange Pfade verarbeiten im Leitfaden Erweiterte Konzepte.
6 Straßendaten in Ihre eigene App einbinden Ausführliches Codebeispiel aus der Demo mit auf Straßen ausgerichteten Daten ansehen, um mit der Entwicklung von Funktionen für Straßendaten in Ihrer eigenen 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. Sie können sie von GitHub herunterladen. Dort finden Sie auch eine Installationsanleitung und Beispielcode.

Nächste Schritte