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 Straßenabschnitte in der Nähe ermittelt und eine Orts-ID zusammen mit Metadaten wie dem nächsten Straßenabschnitt und den zulässigen Höchstgeschwindigkeiten zurückgegeben.

Vorteile 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- und Längengrade mit einer Straße oder mehreren Straßen verbinden
  • Nächste Straße für eine Reihe von Koordinaten finden
  • Geschwindigkeitsbeschränkungen für Straßenabschnitte abrufen

Einsatzmöglichkeiten der Roads API

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

  • An Straßen anpinnen: Dieser Dienst gibt anhand der angegebenen GPS-Koordinaten die wahrscheinlichsten zurückgelegten Straßen zurück. 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, was zu einem Pfad führt, der der Geometrie der Straße reibungslos 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 von Ihnen angegebenen Punkte müssen nicht Teil eines durchgehenden Pfads sein.
  • Geschwindigkeitsbegrenzungen: 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 der Google Maps Platform-Premiumoption, die zum nutzungsbasierten Preismodell gewechselt sind, bleibt die Funktion aktiv.

Funktionsweise der Roads API

Die Roads API verwendet drei Endpunkte, die Breiten-/Längengradkoordinaten oder Orts-IDs akzeptieren, um Straßenpfade, ‑segmente oder Daten zu Geschwindigkeitsbeschränkungen bereitzustellen. Das folgende Beispiel zeigt eine Anfrage nach den 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 an Straßen ausgerichtete Längen-/Breitengradkoordinaten sowie Orts-IDs. Weitere Informationen finden Sie im Leitfaden An Straßen anpinnen unter Antworten.

  • JSON
Nearest roads

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 kontinuierlich sein. Weitere Informationen finden Sie unter Antworten im Leitfaden zu Nächste Straßen.

Geschwindigkeitsbegrenzungen

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

Verwendung der Roads API

1 Demo zum Anpassen an Straßen ausprobieren Klicken Sie auf die Demo, um einen Track zu erstellen und zu sehen, wie der Endpunkt „An Straßen anpinnen“ für glatte Daten sorgt. Sehen Sie sich die Demo im Leitfaden An Straßen andocken an. 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 zum Anpassen an Straßen ausprobieren Verwenden Sie eines der Beispiele für das Anpassen an Straßen und wählen Sie ein Beispiel aus, das für Ihren Anwendungsfall relevant ist.
4 Geschwindigkeitsbegrenzungen für Ihren Straßenweg abrufen Stellen Sie mit denselben Pfaddaten, die Sie für Ihre Anfrage zum Anpassen an Straßen angegeben haben, eine Abfrage zu Geschwindigkeitsbeschränkungen. Beispielanfrage mit einem Pfad
5 Weitere Informationen zum Verarbeiten langer Pfade Folgen Sie den Abschnitten zur Verarbeitung langer Pfade im Leitfaden Erweiterte Konzepte.
6 Nutzen Sie Straßendaten in Ihrer eigenen App. Sehen Sie sich das detaillierte Codebeispiel aus der Demo zu Straßensegmenten an, um die Funktionen für Straßendaten in Ihre eigene App einzubinden.

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 auf GitHub herunterladen. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte