Es kann losgehen!

Bevor Sie mit der Entwicklung beginnen, lesen Sie bitte unsere Entwicklerdokumentation.

Die Google Maps Roads API aktivieren

Zum Einstieg führen wir Sie durch die Google Developers Console, wo Sie vorab Folgendes tun müssen:

  1. Ein Projekt erstellen oder auswählen
  2. Die Google Maps Roads API aktivieren
  3. Zugehörige Schlüssel erstellen
Weiter

Geschwindigkeitsbegrenzungen

Hinweis: Der Dienst für Geschwindigkeitsbegrenzungen ist nur für Kunden von Google Maps APIs Premium Plan mit einer Lizenz zur Gerätenachverfolgung verfügbar.

Die Google Maps Roads API gibt die zulässige Höchstgeschwindigkeit für einen bestimmten Straßenabschnitt zurück. Gelten für einen Straßenabschnitt mehrere Geschwindigkeitsbegrenzungen, so wird die Standard-Geschwindigkeitsbegrenzung für das Segment zurückgegeben.

Für die Genauigkeit der von der Google Maps Roads API zurückgegebenen Daten kann keine Gewähr übernommen werden. Die Daten zur Geschwindigkeitsbegrenzung sind keine Echtzeitdaten und können geschätzt, ungenau, unvollständig und/oder nicht aktuell sein. Sie können eventuelle Ungenauigkeiten über den Dienst Google Map Maker melden.

Anforderungen

Eine Anforderung für Geschwindigkeitsbegrenzungen muss über HTTPS gesendet werden und weist das folgende Format auf:

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

Parameterverwendung

Erforderliche Parameter

  • Entweder ein path oder mindestens eine placeId.
    • path: der zu erstellende Pfad. Für den Parameter path ist eine Liste aus Breite-/Länge-Paaren zulässig. Breiten- und Längenwerte sollten durch Komma getrennt werden. Die Koordinaten sollten durch einen senkrechten Strich (|) getrennt werden. Beispiel: path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
    • placeId: die Orts-ID des Straßenabschnitts. Orts-IDs werden als Antwort auf die Anforderungen snapToRoads und nearestRoads zurückgegeben. Mit jeder Anforderung können Sie bis zu 100 placeIds übergeben.
  • key: Der API-Schlüssel Ihrer Anwendung. Ihre Anwendung muss sich jedes Mal, wenn eine Anforderung an die Google Maps Roads API gesendet wird, mithilfe eines API-Schlüssels in der Anforderung identifizieren. So können Sie einen Schlüssel anfordern.

Optionale Parameter

  • units: gibt an, ob Geschwindigkeitsbegrenzungen in Kilometern oder Meilen pro Stunde zurückgegeben werden sollen. Dieser Parameter kann als KPH oder MPH festgelegt sein. Der Standardwert ist KPH.

Sie können die Daten zur Geschwindigkeitsbegrenzung entweder mithilfe eines path oder einer Reihe von placeIds anfordern, jedoch erhalten Sie für jede eindeutige placeId in der Anforderung nur eine Antwort. Doppelte placeIds können vorhanden sein, wenn sich mehrere Punkte entlang einer kurzen Entfernung befinden.

Antworten

Eine speedLimits-Antwort kann folgende Elemente aufweisen:

  • speedLimits: Ein Array mit Metadaten. Jedes Element besteht aus folgenden Feldern:
    • placeId: eine eindeutige Kennung für einen Ort. Alle placeIds, die von der Google Maps Roads API zurückgegeben wurden, entsprechen Straßenabschnitten.
    • speedLimit: die Geschwindigkeitsbegrenzung für diesen Straßenabschnitt.
    • units: gibt entweder KPH oder MPH zurück.
  • snappedPoints: ein Array mit Snap-Punkten. Dieses Array ist nur dann vorhanden, wenn die Anforderung den Parameter path enthielt. Jeder Punkt besteht aus folgenden Feldern:
    • location: enthält einen Wert mit latitude und longitude.
    • originalIndex: eine Ganzzahl, die den entsprechenden Wert in der ursprünglichen Anforderung angibt. Jeder Wert in der Anforderung sollte einem Snap-to-Roads-Wert in der Antwort zugeordnet sein. Diese Werte werden von 0 an indiziert, ein Punkt mit dem originalIndex 4 ist also der Snap-to-Roads-Wert des 5. Breiten-/Längengradangaben, das an den Parameterpath übergeben wurde.
    • placeId: eine eindeutige Kennung für einen Ort. Alle placeIds, die von der Google Maps Roads API zurückgegeben wurden, entsprechen Straßenabschnitten. Die placeId kann in einer Anforderung für Geschwindigkeitsbegrenzungen übergeben werden, um die Geschwindigkeitsbegrenzung entlang des jeweiligen Straßenabschnitts zu ermitteln.

Beispielanforderung

Mit der folgenden Anforderung werden die Geschwindigkeitsbegrenzungen auf einem kurzen Straßenstück in Canberra, Australien, bestimmt.

Anforderung

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJ1Wi6I2pNFmsRQL9GbW7qABM
        &placeId=ChIJ58xCoGlNFmsRUEZUbW7qABM
        &placeId=ChIJ9RhaiGlNFmsR0IxAbW7qABM
        &placeId=ChIJabjuhGlNFmsREIxAbW7qABM
        &placeId=ChIJcSAlFWpNFmsRMHlUbW7qABM
        &placeId=ChIJI2FUTGhNFmsRcHpAbW7qABM
        &placeId=ChIJiy6YT2hNFmsRkHZAbW7qABM
        &placeId=ChIJoR7CemhNFmsRQB9QbW7qABM
        &placeId=ChIJP2m_FWpNFmsRIHlUbW7qABM
        &placeId=ChIJtV7La2pNFmsRAGpHbW7qABM
        &placeId=ChIJW5JAZmpNFmsRegG0-Jc80sM
        &placeId=ChIJW9R7smlNFmsRMH1AbW7qABM
        &placeId=ChIJy8c0r2lNFmsRQEZUbW7qABM
        &key=YOUR_API_KEY

Antwort

{
  "speedLimits": [
    {
      "placeId": "ChIJ1Wi6I2pNFmsRQL9GbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ58xCoGlNFmsRUEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ9RhaiGlNFmsR0IxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJabjuhGlNFmsREIxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJcSAlFWpNFmsRMHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJI2FUTGhNFmsRcHpAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJiy6YT2hNFmsRkHZAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJoR7CemhNFmsRQB9QbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJP2m_FWpNFmsRIHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJtV7La2pNFmsRAGpHbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW5JAZmpNFmsRegG0-Jc80sM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW9R7smlNFmsRMH1AbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJy8c0r2lNFmsRQEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    }
  ]
}

Feedback geben zu...

Google Maps Roads API
Google Maps Roads API