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 . |
|
Nächste Straßen |
Ein Array mit bis zu 100 unabhängigen Breiten- und Längengradkoordinaten zusammen mit den Orts-IDs der nächstgelegenen Straße für jeden angegebenen Punkt an. 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 Ihre 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 Client für Google Maps-Dienste
- Python Client für Google Maps-Dienste
- Go-Client für Google Maps-Dienste
- Node.js Client für Google Maps-Dienste
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
- Roads API testen: Rufen Sie Roads Inspector auf.
- Roads API-Anfragen senden: Rufen Sie den gewünschten Dienst auf. in: <ph type="x-smartling-placeholder">
- Informationen zu erweiterten Konzepten: Gehen Sie zu Erweiterte Konzepte.
- Best Practices befolgen: Siehe Best Practices für Webdienste