Höchstgeschwindigkeit

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- oder placeId-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 Parameter path angeben, richtet die API zuerst den Pfad an den die von einem Fahrzeug genutzt wird (wie bei der snapToRoads-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, einen placeId-Parameter übergeben. Im folgenden Beispiel zeigt den path-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 eine snapToRoads- oder nearestRoads-Anfrage senden um die relevanten Orts-IDs zu ermitteln und diese dann als Eingabe für die speedLimits-Anfrage. Das folgende Beispiel zeigt den placeId-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 auf KPH oder MPH festgelegt werden. Die Standardeinstellung ist KPH.

Antworten

Eine speedLimits-Antwort kann folgende Elemente enthalten:

  • speedLimits: Ein Array mit Straßenmetadaten. Jedes Element besteht aus den folgenden Feldern:
    • 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 entweder KPH oder MPH zurück.
  • snappedPoints: ein Array von ausgerichteten Punkten. Dieses Array ist vorhanden wenn die Anfrage einen path-Parameter enthielt. Jeder Punkt besteht aus folgenden Feldern hinzu:
    • location: enthält einen latitude- und einen longitude-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 ab 0 indexiert, sodass ein Punkt mit einem originalIndex von 4 ist der Zielwert des fünften Breiten- und Längengrad, der an den Parameter path übergeben wird.
    • placeId: Eine eindeutige Kennung für einen Ort. Alle Orts-IDs zurückgegeben durch die Roads API entsprechen Straßenabschnitten. Die placeId 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.