Roads API

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 gesucht und eine Orts-ID zusammen mit Metadaten wie dem nächstgelegenen Straßenabschnitt und Geschwindigkeitsbegrenzungen 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 Fahr-Apps um folgende Funktionen ergänzen:

  • Breiten- und Längengrad mit einer oder mehreren Straßen verbinden
  • nächstgelegene Straße für Koordinaten finden
  • Geschwindigkeitsbegrenzungen für Straßenabschnitte abrufen

Was Sie mit der Roads API tun können

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

  • An Straßen ausrichten Dieser Dienst gibt die Straßen zurück, die am wahrscheinlichsten zurückgelegt werden, und zwar basierend auf den angegebenen GPS-Koordinaten. Sie können bis zu 100 GPS-Punkte angeben, die entlang einer Route erfasst werden. Sie können auch anfordern, dass der Dienst zusätzliche Punkte interpoliert, um einen Pfad zu erzeugen, der der Geometrie der Straße reibungslos folgt.
  • Nächste Straßen: 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 durchgehenden Pfads sein.
  • Geschwindigkeitsbeschränkungen: Dieser Dienst gibt die angegebene Höchstgeschwindigkeit für einen Straßenabschnitt zurück. Die Geschwindigkeitsbegrenzung ist für alle Kunden mit einer Asset-Tracking-Lizenz verfügbar. Für Kunden mit der 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ängengrade oder Orts-IDs akzeptieren, um Daten zu Straßenpfaden, Segmenten oder Geschwindigkeitsbegrenzungen bereitzustellen. Das folgende Beispiel zeigt eine Anfrage nach nächstgelegenen Straßen basierend auf einem Satz 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 werden die über die Roads API verfügbaren Ressourcen und die zurückgegebenen Daten zusammengefasst.

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

Gibt ein Array von bis zu 100 GPS-Punkten einer Route zurück. Umfasst Längen- und Breitengradkoordinaten, die an der Straße ausgerichtet sind, sowie Orts-IDs. Weitere Informationen finden Sie im Abschnitt Antworten im Leitfaden An Straßen ausrichten.
  • JSON
Nächste Straßen

Ein Array von bis zu 100 unabhängigen Breiten- und Längengradkoordinaten sowie Orts-IDs für die nächstgelegene Straße für jeden angegebenen Punkt. Punkte müssen nicht fortlaufend sein. Weitere Informationen finden Sie unter Antworten im Leitfaden Nächste Straßen.
Geschwindigkeitsbegrenzungen

Ein Array mit bis zu 100 Straßenmetadatenelementen. Sie enthalten Geschwindigkeitsbegrenzungen und Orts-IDs mit Einheiten in km/h oder mph. Weitere Informationen finden Sie im Abschnitt Antworten im Leitfaden zu Geschwindigkeitsbegrenzungen.

Roads API verwenden

1 Demo zum Ausrichten auf Straßen ausprobieren Klicken Sie auf die Demo, um einen Track zu erstellen und zu sehen, wie der Endpunkt für das Andocken an Straßen flüssige 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 Google Cloud-Projekt einrichten und führen Sie die Einrichtungsanleitung aus. Lesen Sie dann, wie Sie Ihren API-Schlüssel verwenden.
3 Anfrage für „Dem Straßenverlauf anpassen“ verwenden Verwenden Sie eines der Beispiele zum Ausrichten an Straßen und wählen Sie eines aus, das für Ihren Anwendungsfall relevant ist.
4 Geschwindigkeitsbegrenzungen auf Straßenebene festlegen Führen Sie eine Abfrage für eine Geschwindigkeitsbegrenzung aus. Verwenden Sie dabei dieselben Pfaddaten, die Sie für die Anfrage zur Straßenausrichtung angegeben haben. Weitere Informationen finden Sie unter Beispielanfrage mit einem Pfad.
5 Weitere Informationen zum Verarbeiten langer Pfade Folgen Sie den Abschnitten zum Verarbeiten langer Pfade im Leitfaden Erweiterte Konzepte.
6 Straßendaten in Ihre eigene App einbinden Sehen Sie sich das detaillierte Codebeispiel aus der Demo zur Straßenaufnahme an, um mit der Integration von Straßendatenfunktionen 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. Laden Sie sie von GitHub herunter. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte