Roads API – Übersicht

Roads API ist ein Dienst, der HTTPS-Anfragen mit Längen- und Breitengradkoordinaten für einen oder mehrere Punkte auf einer Karte. Sie verwendet diese zeigt auf, um Straßensegmente in der Nähe zu finden, und gibt eine Orts-ID zusammen mit Metadaten zurück etwa den nächstgelegenen Straßenabschnitt und Geschwindigkeitsbegrenzungen.

Vorteile der Roads API

Mit der Roads API können Sie Ankunftszeiten oder anderen Straßenmetadaten. Mit dieser Straße Metadaten können Sie Ihre Fahr-Apps mit den folgenden Funktionen optimieren:

  • 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 Roads API können Sie GPS-Koordinaten auf der Geometrie der Straße und Bestimmen der Geschwindigkeitsbegrenzung auf der Straße Segmente.

  • Snap to Roads: Dieser Dienst gibt die wahrscheinlichste zurückgelegte Straßen, die auf den angegebenen GPS-Koordinaten basieren. Sie können bis zu 100 GPS-Punkte entlang einer Route Optional können Sie auch anfordern, dass der Dienst interpoliert zusätzliche Punkte und führt so zu einem Pfad, der nahtlos Geometrie der Straße.
  • Nächste Straße: Dieser Dienst gibt die nächstgelegene Straße zurück. Segment für einen GPS-Punkt. 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 Höchstgeschwindigkeit für einen Straßenabschnitt. Geschwindigkeitsbegrenzungen sind für alle Kunden mit einer Asset-Tracking-Lizenz. Für die Google Maps Platform-Premiumoption die auf „Pay as you go“-Preismodelle umgestellt haben, aktiv ist.

Funktionsweise der Roads API

Die Roads API verwendet drei Endpunkte, die Breiten- und Längengrade akzeptieren. Koordinaten oder Orts-IDs verwenden, 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 von Breiten- und Längengraden:

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 Ressourcen aufgeführt, die über die Roads API zusammen mit den zurückgegebenen Daten an.

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

Gibt ein Array von bis zu 100 GPS-Punkten einer Route zurück. Enthält Längen-/Breitengradkoordinaten entlang der Straße entlang mit Orts-IDs. Details ansehen in Antworten im Abschnitt An Straßen ausrichten .
  • JSON
Nächste Straßen

Ein Array mit bis zu 100 unabhängigen Breiten- und Längengradkoordinaten zusammen mit den Orts-IDs für die nächstgelegene Straße für jeden angegebenen Punkt. Die Punkte müssen nicht fortlaufend sein. Details ansehen in Antworten in den nächsten Straßen .
Geschwindigkeitsbegrenzungen

Ein Array mit bis zu 100 Straßenmetadatenelementen. Diese enthalten Geschwindigkeit und Orts-IDs mit Einheiten in km/h oder mph. Details ansehen in Antworten in den Geschwindigkeitsbegrenzungen .

Roads API verwenden

1 Demo „Dem Straßenverlauf anpassen“ ausprobieren Klicken Sie auf die Demo, um einen Track zu erstellen, und sehen Sie sich an, wie der Endpunkt reibungslose Daten liefert. Weitere Informationen finden Sie unter Demo in der Anleitung An Straßen ausrichten. Sie benötigen keinen API-Schlüssel.
2 Einrichten Beginnen Sie mit Das Google Cloud-Projekt aus und folgen Sie der Einrichtungsanleitung. und dann lernen, Weitere Informationen zur Verwendung des API-Schlüssels
3 „Dem Straßenverlauf anpassen“-Anfrage ausprobieren Eine der Snap- zu Straßen und probiere eins aus, das für deinen Anwendungsfall relevant ist.
4 Geschwindigkeitsbegrenzungen für Ihre Route abrufen Verwenden Sie dieselben Pfaddaten, die Sie für die Anfrage zur Ausrichtung von Straßen verwendet haben, Anfrage zu Geschwindigkeitsbegrenzungen stellen. Weitere Informationen finden Sie in der Beispielanfrage mit Pfad.
5 Weitere Informationen zur Verarbeitung langer Pfade Folgen Sie den Abschnitten auf Lange Pfade verarbeiten finden Sie im Leitfaden zu erweiterten Konzepten.
6 Straßendaten in deine eigene App einbinden Weitere Informationen finden Sie in der detailliertes Codebeispiel aus der Demo für die Straßenfotografie um Funktionen für Straßendaten in Ihre eigene App zu integrieren.

Verfügbare Clientbibliotheken

Rufen Sie diese API in der Sprache Ihrer Wahl über eine der folgenden Clientbibliotheken:

Java-, Python-, Go- und Node.js-Client für Google Maps Dienste sind von der Community unterstützte Clientbibliotheken, die im Rahmen der Apache 2.0-Lizenz. Sie können sie von GitHub herunterladen. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte