Höchstgeschwindigkeit

Die Roads API gibt die zulässige Höchstgeschwindigkeit für bestimmte Straßenabschnitte zurück. Bei Straßenabschnitten mit variablen Geschwindigkeitsbegrenzungen wird die maximale Geschwindigkeitsbegrenzung für Pkw auf diesem Abschnitt zurückgegeben.

Die Genauigkeit der von der Roads API zurückgegebenen Daten zur Geschwindigkeitsbegrenzung kann nicht garantiert werden. Die bereitgestellten Daten zur Geschwindigkeitsbegrenzung sind nicht in Echtzeit und können geschätzt, ungenau, unvollständig oder veraltet sein. Unter Details zur Abdeckung finden Sie die Regionen, in denen Daten zur Geschwindigkeitsbegrenzung verfügbar sind.

Anfragen

Senden Sie Anfragen zu Geschwindigkeitsbegrenzungen über HTTPS im folgenden Format: 

https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY

Parameterverwendung

Erforderliche Parameter

  • Entweder ein path- oder ein placeId-Parameter.

    • path : Eine Liste mit bis zu 100 Breiten-/Längengrad-Paaren, die einen Pfad darstellen. Breiten- und Längengradwerte müssen durch Kommas getrennt sein. Breiten-/Längengrad-Paare müssen durch das Pipe-Zeichen „|“ getrennt sein. Wenn Sie den path Parameter angeben, richtet die API den Pfad zuerst an der wahrscheinlichsten Straße aus, die von einem Fahrzeug befahren wurde (wie bei der snapToRoads Anfrage), und bestimmt dann die Geschwindigkeitsbegrenzung für den entsprechenden Straßenabschnitt. Wenn Sie nicht möchten, dass die API den Pfad ausrichtet, müssen Sie einen placeId-Parameter übergeben, wie unten beschrieben. Im folgenden Beispiel wird der Parameter path mit drei Breiten-/Längengrad-Paaren gezeigt: path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.

    • placeId : Die Orts-ID(s), die einen oder mehrere Straßenabschnitte darstellen. Achten Sie darauf, dass sich jede Orts-ID auf einen Straßenabschnitt und nicht auf einen anderen Ortstyp bezieht. Sie können mit jeder Anfrage bis zu 100 Orts-IDs übergeben. Die Antwort enthält eine Geschwindigkeitsbegrenzung für jede Orts-ID in der Anfrage.

      Die API führt für die angegebenen Orts-IDs keine Ausrichtung an Straßen durch. Sie können eine snapToRoads oder nearestRoads Anfrage senden, um die relevanten Orts-IDs zu finden, und sie dann als Eingabe für die speedLimits Anfrage verwenden. Im folgenden Beispiel wird der placeId Parameter mit zwei Orts-IDs gezeigt: placeId=ChIJs5ydyTiuEmsR0fRSlU0C7k0&placeId=ChIJW__r4ERXzpQRgkeRL6P0m3Y

  • key : Der API-Schlüssel Ihrer Anwendung. Ihre Anwendung muss sich jedes Mal identifizieren, wenn sie eine Anfrage an die Roads API sendet. Dazu muss sie jeder Anfrage einen API-Schlüssel beifügen. Informationen zum Abrufen eines Schlüssels

Optionale Parameter

  • units : Gibt an, ob die Geschwindigkeitsbegrenzungen in Kilometern oder Meilen pro Stunde zurückgegeben werden sollen. Dieser Parameter kann entweder auf KPH oder MPH festgelegt werden. Die Standardeinstellung ist KPH.

Antworten

Die folgenden Elemente können in einer speedLimits-Antwort vorhanden sein:

  • speedLimits : Ein Array mit Straßenmetadaten. Jedes Element besteht aus den folgenden Feldern:
    • placeId : Eine eindeutige Kennung für einen Ort. Alle von der Roads API zurückgegebenen Orts-IDs entsprechen Straßenabschnitten.Roads API
    • speedLimit : Die Geschwindigkeitsbegrenzung für diesen Straßenabschnitt.
    • units : Gibt entweder KPH oder MPH zurück.
  • snappedPoints : Ein Array mit ausgerichteten Punkten. Dieses Array ist nur vorhanden, wenn die Anfrage einen path-Parameter enthält. Jeder Punkt besteht aus den folgenden Feldern:
    • location : Enthält einen latitude- und einen longitude-Wert.
    • originalIndex : Eine Ganzzahl, die den entsprechenden Wert in der ursprünglichen Anfrage angibt. Jeder Wert in der Anfrage sollte einem ausgerichteten Wert in der Antwort zugeordnet sein. Diese Werte sind ab 0 indexiert. Ein Punkt mit einem originalIndex von 4 ist also der ausgerichtete Wert des fünften Breiten-/Längengrads, der an den Parameter path übergeben wurde.
    • placeId : Eine eindeutige Kennung für einen Ort. Alle von der Roads API zurückgegebenen Orts-IDs entsprechen Straßenabschnitten.Roads API Die placeId kann in einer Anfrage zu Geschwindigkeitsbegrenzungen übergeben werden, um die Geschwindigkeitsbegrenzung für diesen Straßenabschnitt zu ermitteln.
  • warning_message : Ein String mit einer für Nutzer sichtbaren Warnung.

Beispielanfrage mit einem Pfad

Diese Anfrage ruft die Geschwindigkeitsbegrenzung für jeden Straßenabschnitt ab, der den angegebenen Breiten-/Längengrad-Paaren in einem Pfad am nächsten liegt, der die Vasco da Gama-Brücke in Lissabon, Portugal, überquert.

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 zur geringen Punktdichte in der obigen Antwort. Wenn Sie Geschwindigkeitsbegrenzungen für die nächstgelegenen Straßenabschnitte an beliebigen Punkten anfordern, müssen Sie stattdessen speedLimits mit Orts-IDs aufrufen, die vom nearestRoads Endpunkt abgerufen wurden.

Beispielanfrage mit Orts-IDs

Anstelle von Breiten-/Längengrad-Paaren können Sie die Orts-IDs der Straßenabschnitte übergeben. Wir empfehlen, Orts-IDs für Straßenabschnitte mit snapToRoads- oder nearestRoads-Anfragen abzurufen. Wenn Sie Orts-IDs übergeben, gibt die API die Geschwindigkeitsbegrenzung für den Straßenabschnitt zurück, der durch jede Orts-ID dargestellt wird. Die API wendet keine Ausrichtung an Straßen auf die angegebenen Orts-IDs an.

Im folgenden Beispiel werden die Geschwindigkeitsbegrenzungen für einige der Straßenabschnitte angefordert, die die Vasco da Gama-Brücke in Lissabon, Portugal, überqueren.

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

Wenn Sie die Anzahl der Aufrufe an den Speed Limit-Dienst reduzieren möchten, sollten Sie die Standorte Ihrer Assets im Intervall von 5 bis 15 Minuten abfragen. Der genaue Wert hängt von der Geschwindigkeit ab, mit der sich ein Asset bewegt. Wenn ein Asset nicht in Bewegung ist, reicht ein einzelnes Standortbeispiel aus. Es sind keine mehreren Aufrufe erforderlich.

Zur Minimierung der Gesamtlatenz wird empfohlen, den Speed Limit-Dienst aufzurufen, sobald Sie einige Daten erfasst haben, und nicht jedes Mal, wenn der Standort eines mobilen Assets empfangen wird.

Warum fehlen einige oder alle Geschwindigkeitsbegrenzungen?

Die häufigste Ursache für fehlende speedLimits ist, dass die Geschwindigkeitsbegrenzung eines Orts angefordert wird, der kein Straßenabschnitt ist.

Im obigen Beispiel wird die Vasco da Gama-Brücke verwendet, um Konzepte zu veranschaulichen. Die Brücke trägt die Straße E90, die über den Rio Tejo führt. Die Brücke selbst hat die Orts-ID ChIJUzt97ZEwGQ0RM1JzQfqoDtU. Der erste Straßenabschnitt in der obigen Antwort ist Teil der Straße E90 und hat die Orts-ID ChIJX12duJAwGQ0Ra0d4Oi4jOGE. Wenn Sie in der Beispielanfrage die Orts-ID der Straße durch die Orts-ID der Brücke ersetzen, enthält die Antwort nur zwei Geschwindigkeitsbegrenzungen im speedLimits-Array, da sich die Orts-ID der Brücke nicht auf einen einzelnen Straßenabschnitt bezieht. Wenn keine der Orts-IDs für Straßenabschnitte gilt, enthält die Antwort keine Geschwindigkeitsbegrenzungen.

Wenn Sie Geschwindigkeitsbegrenzungen mit Orts-IDs anfordern, achten Sie darauf, dass sich jede Orts-ID auf einen Straßenabschnitt und nicht auf einen anderen Ortstyp bezieht. Orts-IDs für einzelne Straßenabschnitte lassen sich am besten mit snapToRoads- oder nearestRoads-Anfragen abrufen. Mit beiden können mehrere Orts-IDs mit einem einzigen Aufruf zurückgegeben werden.

Was passiert, wenn für einen Straßenabschnitt separate Geschwindigkeitsbegrenzungen für Pkw und Lkw gelten?

Die Roads API gibt nur die maximale zulässige Höchstgeschwindigkeit für Pkw zurück.