Roads API gibt die zulässige Höchstgeschwindigkeit für eine bestimmte Straße zurück. Segment. Bei Straßenabschnitten mit variablen Geschwindigkeitsbegrenzungen für das Segment zurückgegeben.
Die Genauigkeit der von Roads API zurückgegebenen Daten zu Geschwindigkeitsbegrenzungen können nicht garantiert werden. Die Daten zur Geschwindigkeitsbegrenzung werden nicht in Echtzeit bereitgestellt. geschätzt, ungenau, unvollständig und/oder veraltet sind. Details zur Abdeckung um zu sehen, in welchen Regionen Daten zu Geschwindigkeitsbegrenzungen verfügbar sind.
Anfragen
Anfragen zu Geschwindigkeitsbegrenzungen müssen über HTTPS gesendet werden und haben folgendes Format:
https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY
Parameterverwendung
Erforderliche Parameter
- Entweder ein
path
- oderplaceId
-Parameter.path
: Eine Liste mit bis zu 100 Breiten- und Längengradpaaren, die für Pfad. Breiten- und Längengradwerte müssen durch Kommas getrennt werden. Die Breiten- und Längengradpaare müssen durch einen senkrechten Strich „|“ getrennt werden. Wenn Sie den Parameterpath
angeben, richtet die API zuerst den Pfad an den die von einem Fahrzeug genutzt wird (wie bei dersnapToRoads
-Anfrage) und bestimmt dann die Geschwindigkeitsbegrenzung für relevanten Straßenabschnitt. Wenn Sie nicht möchten, dass die API den Pfad anfängt, muss, wie unten erläutert, einenplaceId
-Parameter übergeben. Im folgenden Beispiel zeigt denpath
-Parameter mit drei Breiten- und Längengradpaaren an:path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796
.placeId
: Die Orts-ID(s) für ein oder mehrere Straßensegmente. Achten Sie darauf, dass sich jede Orts-ID auf einen Straßenabschnitt und nicht auf einen anderen Typ bezieht. des Orts. Sie können jeweils bis zu 100 Orts-IDs übergeben. Die API führt für die angegebenen Orts-IDs keine Straßenaufnahmen aus. Die Antwort enthält eine Höchstgeschwindigkeit für jede Orts-ID in der Anfrage. Sie können einesnapToRoads
- odernearestRoads
-Anfrage senden um die relevanten Orts-IDs zu ermitteln und diese dann als Eingabe für diespeedLimits
-Anfrage. Das folgende Beispiel zeigt denplaceId
-Parameter mit zwei Orts-IDs:placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU
key
: der API-Schlüssel Ihrer Anwendung. Ihr Anwendung bei jedem Senden einer Anfrage an den Roads API durch Einfügen eines API-Schlüssels mit jeder Anfrage. Weitere Informationen zum Abrufen eines Schlüssels
Optionale Parameter
units
: Gibt an, ob Geschwindigkeitsbegrenzungen in Kilometern oder Meilen pro zurückgegeben werden sollen Stunde. Dies kann entweder aufKPH
oderMPH
festgelegt werden. Die Standardeinstellung istKPH
.
Antworten
Eine speedLimits
-Antwort kann folgende Elemente enthalten:
speedLimits
: Ein Array mit Straßenmetadaten. Jedes Element besteht aus den folgenden Feldern: <ph type="x-smartling-placeholder">- </ph>
placeId
: Eine eindeutige Kennung für einen Ort. Alle Orts-IDs zurückgegeben durch die Roads API entsprechen Straßenabschnitten.speedLimit
: die Höchstgeschwindigkeit für diesen Straßenabschnitt.units
: gibt entwederKPH
oderMPH
zurück.
snappedPoints
: ein Array von ausgerichteten Punkten. Dieses Array ist vorhanden wenn die Anfrage einenpath
-Parameter enthielt. Jeder Punkt besteht aus folgenden Feldern hinzu: <ph type="x-smartling-placeholder">- </ph>
location
: enthält einenlatitude
- und einenlongitude
-Wert.originalIndex
: Eine Ganzzahl, die den entsprechenden Wert angibt. in der ursprünglichen Anfrage. Jeder Wert in der Anfrage sollte einem den angedockten Wert in der Antwort angeben. Diese Werte sind ab0
indexiert, sodass ein Punkt mit einemoriginalIndex
von4
ist der Zielwert des fünften Breiten- und Längengrad, der an den Parameterpath
übergeben wird.placeId
: Eine eindeutige Kennung für einen Ort. Alle Orts-IDs zurückgegeben durch die Roads API entsprechen Straßenabschnitten. DieplaceId
kann in einer Anfrage zur Geschwindigkeitsbegrenzung übergeben werden, um zu ermitteln, Geschwindigkeitsbegrenzung entlang des Straßenabschnitts.
warning_message
: Ein String mit einer für den Nutzer sichtbaren Warnung.
Beispielanfrage mit Pfad
Diese Anforderung ruft die Höchstgeschwindigkeit für jedes Straßensegment ab, das dem angegebene Längen- und Breitengradpaare in einem Pfad über den Vasco da Gama in Lissabon, Portugal.
Anfrage
https://roads.googleapis.com/v1/speedLimits?path=38.75807927603043,-9.03741754643809|38.6896537,-9.1770515|41.1399289,-8.6094075&key=YOUR_API_KEY
Antwort
{ speedLimits: [ { placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE", speedLimit: 105, units: "KPH" }, { placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU", speedLimit: 70, units: "KPH" }, { placeId: "ChIJJ4vQRudkJA0RpednU70A-5M", speedLimit: 55, units: "KPH" } ], snappedPoints: [ { location: { latitude: 38.75807927603043, longitude: -9.037417546438084 }, originalIndex: 0, placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE" }, { location: { latitude: 38.689653701836896, longitude: -9.177051486847693 }, originalIndex: 1, placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU" }, { location: { latitude: 41.13993011767777, longitude: -8.609400794783655 }, originalIndex: 2, placeId: "ChIJJ4vQRudkJA0RpednU70A-5M" } ], warningMessage: "Input path is too sparse. You should provide a path where consecutive points are closer to each other. Refer to the 'path' parameter in Google Roads API documentation." }
Beachten Sie die Warnmeldung für Punktdichte in der obigen Antwort. Wenn Sie
die Geschwindigkeitsbegrenzungen für die nächstgelegenen
Straßensegmente an beliebigen Punkten anfordern,
Sie müssen speedLimits
mit den Orts-IDs aufrufen, die aus dem
Endpunkt nearestRoads
.
Beispielanfrage mit Orts-IDs
Anstatt Breitengrad/Längengrad-Paare zu verwenden, können Sie die Orts-IDs der
Straßenabschnitte. Wir empfehlen Ihnen, Orts-IDs für Straßensegmente mit
snapToRoads
- oder nearestRoads
-Anfragen. Wenn Sie Orts-IDs übergeben,
gibt die Höchstgeschwindigkeit für den Straßenabschnitt zurück, der durch die jeweilige Orts-ID dargestellt wird. Die
Die API wendet keine Straßenausrichtungen auf die angegebenen Orts-IDs an.
Im folgenden Beispiel werden Geschwindigkeitsbegrenzungen für einige Straßenabschnitte angefordert über die Brücke Vasco da Gama in Lissabon, Portugal.
Anfrage
https://roads.googleapis.com/v1/speedLimits?placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU&placeId=ChIJJ4vQRudkJA0RpednU70A-5M&key=YOUR_API_KEY
Antwort
{ "speedLimits": [ { placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE", speedLimit: 105, units: "KPH" }, { placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU", speedLimit: 70, units: "KPH" }, { placeId: "ChIJJ4vQRudkJA0RpednU70A-5M", speedLimit: 55, units: "KPH" } ] }
Nutzungsempfehlungen
Wir empfehlen, die Anzahl der Aufrufe des Geschwindigkeitsbegrenzungsdienstes zu minimieren, die Standorte Ihrer Assets in Intervallen von 5 bis 15 Minuten (genau hängt von der Geschwindigkeit ab, mit der ein Asset bewegt wird. Wenn ein Asset ist ein einzelnes Standortbeispiel ausreichend (es ist nicht nötig, mehreren Aufrufen).
Zur Minimierung der Gesamtlatenz wird empfohlen, den Speed Limit-Dienst für die Geschwindigkeitsbegrenzung aufzurufen, sobald du einige Daten erfasst hast, und nicht jedes Mal, wenn der Standort eines mobilen Assets empfangen wird.
Warum fehlen einige/alle Geschwindigkeitsbegrenzungen?
Die häufigste Ursache für das Fehlen von speedLimits
ist das Anfordern der Geschwindigkeitsbegrenzung
die keinen Straßenabschnitt darstellen.
Im obigen Beispiel wird die Vasco da Gama-Brücke zur Veranschaulichung von Konzepten verwendet.
unterstützt sie die E 90 über den Rio Tejo. Die Brücke
die Orts-ID ChIJUzt97ZEwGQ0RM1JzQfqoDtU. Das erste Straßensegment
in der Antwort oben gehört zur E90 und hat die Orts-ID
ChIJX12duJAwGQ0Ra0d4Oi4jOGE. Wenn Sie in der Beispielanfrage
mit der Orts-ID der Bridge kombinieren, dann enthält die Antwort nur
zwei Höchstgeschwindigkeiten im Array speedLimits
, da die Orts-ID der Brücke
bezieht sich nicht auf einen einzelnen Straßenabschnitt. Wenn keine der
Orts-IDs für Straßensegmente, enthält die Antwort keine
Geschwindigkeitsbegrenzungen.
Bei Anfragen zu Geschwindigkeitsbegrenzungen mit Orts-IDs muss jede Orts-ID
bezieht sich auf einen Straßenabschnitt und nicht auf einen anderen Ortstyp. Orts-IDs für
Einzelne Straßensegmente lassen sich am besten mit snapToRoads
abrufen.
oder nearestRoads
-Anfragen, bei denen mehrere Orts-IDs aus
mit nur einem Anruf.