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 ermittelt und eine Orts-ID zusammen mit Metadaten wie dem nächstgelegenen Straßenabschnitt und den Geschwindigkeitsbegrenzungen zurückgegeben.

Vorteile der Verwendung von Roads API

Mit der Roads API können Sie Tempolimits, geschätzte 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
  • Nächstgelegene Straße für eine Reihe von Koordinaten ermitteln
  • Geschwindigkeitsbegrenzungen für Straßenabschnitte abrufen

Funktionen von Roads API

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

  • Auf Straßen ausrichten: Dieser Dienst gibt die wahrscheinlichsten Straßen zurück, die anhand der bereitgestellten GPS-Koordinaten zurückgelegt 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. Das Ergebnis ist ein Pfad, der der Geometrie der Straße folgt.
  • Nearest Roads: 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 angegebenen Punkte müssen nicht Teil eines durchgehenden Pfads sein.
  • Tempolimits: Dieser Dienst gibt die zulässige Höchstgeschwindigkeit für einen Straßenabschnitt zurück. Der Dienst „Speed Limit“ ist für alle Kunden mit einer Asset-Tracking-Lizenz verfügbar. Für Kunden mit Google Maps Platform-Premiumoption, die zum nutzungsbasierten Preismodell gewechselt sind, bleibt die Funktion aktiv.

So funktioniert Roads API

Für Roads API werden drei Endpunkte verwendet, die Breiten-/Längenkoordinaten oder Orts-IDs akzeptieren, um Straßenpfade, Segmente oder Tempolimitdaten bereitzustellen. Das folgende Beispiel zeigt eine Anfrage für die nächstgelegenen Straßen basierend auf einer Reihe 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 zusammen mit den 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 auf Straßen ausgerichtete Längen-/Breitengradkoordinaten 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-/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 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 Geschwindigkeitsbegrenzungen unter 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 in der Anleitung An Straßen ausrichten Sie benötigen keinen API-Schlüssel.
2 Einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung. 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 zu Geschwindigkeitsbegrenzungen zu stellen. Beispielanfrage mit einem Pfad
5 Informationen zum Verarbeiten langer Pfade Folgen Sie der Anleitung in den Abschnitten zum Verarbeiten langer Pfade im Leitfaden Erweiterte Konzepte.
6 Straßendaten in Ihre eigene App einbinden Ausführliches Codebeispiel aus der Demo „Road Snapped“ 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 Installationsanleitungen und Beispielcode.

Nächste Schritte