Roads API – Übersicht

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ßensegmente in der Nähe ermittelt. Eine Orts-ID zusammen mit Metadaten wie dem nächstgelegenen Straßenabschnitt und Geschwindigkeitsbegrenzungen wird zurückgegeben.

Vorteile der Roads API

Mit der Roads API können Sie Geschwindigkeitsbegrenzungen, geschätzte Ankunftszeiten oder andere Straßenmetadaten abrufen. Mit den Straßenmetadaten kannst du deine Fahr-Apps um folgende Funktionen ergänzen:

  • Verbinden Sie Breiten- und Längengradkoordinaten mit einer Straße oder Straßen.
  • 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 dem Roads API können Sie GPS-Koordinaten an die Geometrie der Straße anpassen und die Geschwindigkeitsbegrenzung entlang von Straßensegmenten bestimmen.

  • Snap to Roads: Dieser Dienst gibt auf Grundlage der bereitgestellten GPS-Koordinaten die wahrscheinlichsten Straßen zurück. Sie können bis zu 100 GPS-Punkte angeben, die entlang einer Route erfasst werden. Optional können Sie auch anfordern, dass der Dienst zusätzliche Punkte interpoliert, sodass ein Pfad entsteht, der der Geometrie der Straße nahtlos folgt.
  • Nächste Straßen: 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 von Ihnen angegebenen Punkte müssen nicht Teil eines fortlaufenden Pfads sein.
  • Geschwindigkeitsbegrenzungen: Dieser Dienst gibt die zulässige Höchstgeschwindigkeit für einen Straßenabschnitt zurück. Die Geschwindigkeitsbegrenzung steht allen Kunden mit einer Asset-Tracking-Lizenz zur Verfügung. 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 Koordinaten für Breiten- und Längengrad oder Orts-IDs akzeptieren, um Daten zu Straßenwegen, Segmenten oder Geschwindigkeitsbegrenzungen bereitzustellen. Das folgende Beispiel zeigt eine Anfrage für die 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

Weitere Informationen

In der folgenden Tabelle sind die über die Roads API verfügbaren Ressourcen und die zurückgegebenen Daten aufgeführt.

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

Gibt ein Array von bis zu 100 GPS-Punkten einer Route zurück. Dazu gehören auch Koordinaten für bestimmte Längen- und Breitengrade sowie Orts-IDs. Weitere Informationen finden Sie unter Antworten in der Anleitung An Straßen ausrichten.
  • JavaScript Object Notation
Nächste Straßen

Ein Array mit bis zu 100 unabhängigen Breiten- und Längengradkoordinaten 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 Abschnitt 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 „Dem Straßenverlauf anpassen“ ausprobieren Klicken Sie auf die Demo, um einen Track zu erstellen und zu sehen, wie der Endpunkt „An Straßen ausrichten“ reibungslose Daten liefert. Weitere Informationen finden Sie in der Demo in der Anleitung An Straßen ausrichten. Sie benötigen keinen API-Schlüssel.
2 Jetzt einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung, um zu erfahren, wie Sie Ihren API-Schlüssel verwenden.
3 „Dem Straßenverlauf anpassen“-Anfrage ausprobieren Verwenden Sie eines der Beispiele zum Ausrichten an Straßen und eines der Beispiele, das für Ihren Anwendungsfall relevant ist.
4 Geschwindigkeitsbegrenzungen für Ihre Route abrufen Verwenden Sie dieselben Pfaddaten, die Sie in der Anfrage zum Andocken an Straßen angegeben haben, eine Abfrage zu Geschwindigkeitsbegrenzungen. Weitere Informationen finden Sie unter Beispielanfrage mit einem Pfad.
5 Weitere Informationen zur Verarbeitung langer Pfade Folgen Sie den Abschnitten Lange Pfade verarbeiten im Leitfaden zu erweiterten Konzepten.
6 Straßendaten in deine eigene App einbinden Sehen Sie sich das detaillierte Codebeispiel aus der Demo für Straßendaten an, um mit dem Erstellen 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:

Der Java-, Python-, Go- und Node.js-Client 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