Elevation Service

Der Elevation Service stellt eine REST-API zur Abfrage von Höhendaten für geografische Koordinaten bereit. Die API unterstützt das JSON-Format. Die Anfrage ist auf 500 Punkte begrenzt.

Reihenfolge der Koordinaten

Diese REST-API verwendet die GeoJSON-Koordinatenreihenfolge: [longitude, latitude]. Die Kartenmethoden von SmartMaps GL JS erwarten dagegen { lat, lng }-Objekte (Breitengrad zuerst).

Endpunkte

Höhe für einen Punkt abrufen

Ruft die Höhe für einen bestimmten geografischen Punkt ab.

POST https://elevation.smartmaps.cloud/api/v2/Elevation/point

GET https://elevation.smartmaps.cloud/api/v2/Elevation/point

Parameter:

Parameter	Erforderlich	Typ	Beschreibung
`apiKey`	Yes	string	API-Key für die Authentifizierung
`channel`	No	string	Channel für die Anfrage
`latitude`	Yes	number	Breitengrad des Punkts
`longitude`	Yes	number	Längengrad des Punkts

Der Anfragetext für POST muss ein JSON-Objekt mit einem Array points sein, das die abzufragenden Punkte enthält.Beispiel für den Anfragetext von POST

{
  "points": [
    {
      "latitude": 48.123,
      "longitude": 11.567
    }
  ]
}

Antwort:Die Antwort ist ein JSON-Objekt, das die Höhenwerte für die angegebenen Punkte enthält.

Datenmodell

ElevationPointRequest

Property	Typ	Beschreibung
`points`	Array[GeoPoint]	Array geografischer Punkte

GeoPoint

Property	Typ	Beschreibung
`latitude`	number	Breitengrad
`longitude`	number	Längengrad

Die Antwort enthält die Höhenwerte in Metern über dem Meeresspiegel für die angegebenen Koordinaten.

Swagger

Weitere Informationen zu den Antwortstrukturen finden Sie in der vollständigen Swagger-Dokumentation.

Sie können die OpenAPI-Definition (https://elevation.smartmaps.cloud/swagger/v2/swagger.json) auch direkt in Postman, Insomnia oder ähnliche API-Clients importieren.