Open-Elevation dient seit Langem als einfache, schnörkellose Möglichkeit, einer Reihe von Koordinaten die Geländehöhe zuzuordnen. Unser Kompatibilitäts-Host übernimmt genau diese Anfrage- und Antwortstruktur und stellt einen voll funktionsfähigen Höhendienst dahinter, zusammen mit einer Kontingentstruktur, die Ihnen genau sagt, was Sie verbraucht haben.
Der Host bildet die Anfrageparameter und den Antwortinhalt von Open-Elevation exakt nach, abgesehen von den Texten zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die von uns stammen statt vom ursprünglichen Anbieter. Senden Sie eine Reihe von Koordinaten so, wie Sie sie bereits an Open-Elevation senden, und die Höhenwerte kommen in derselben JSON-Struktur zurück, die Ihr bestehender Code heute auswertet.
Da unser Höhen-Endpunkt voll funktionsfähig ist, handelt es sich nicht nur um eine übereinstimmende Struktur. Fragen Sie die Koordinaten eines Ortes ab, liefert die Antwort einen echten Höhenwert in Metern, genauso wie /v1/elevation direkt. Batch-Anfragen funktionieren ebenso, wobei jedes Koordinatenpaar als eine Anfrage zählt und nicht der Aufruf als Ganzes.
Die Authentifizierung akzeptiert unsere üblichen vier Methoden: einen X-API-Key-Header, einen Authorization: Bearer-Header, HTTP Basic Auth mit dem Schlüssel als Benutzernamen oder einen Query-Parameter. Da Open-Elevation oft ganz ohne Authentifizierung genutzt wird, bedeutet ein Schlüssel hier zugleich ein eigenes, nachvollziehbares Kontingent, statt sich auf eine gemeinsam genutzte, unverwaltete Ressource zu verlassen.
Die Preise entsprechen denen jedes anderen Hosts auf der Plattform. Jede Adresse erhält 2.500 kostenlose Anfragen pro Tag ohne Schlüssel, gezählt pro Netz. Ein Schlüssel fügt eigene 2.500 kostenlose Anfragen pro Tag hinzu. Jenseits beider Kontingente kostet Prepaid-Guthaben 0,0001 € pro Anfrage, oder ein Unlimited-Paket deckt die Nutzung für 50 € im Monat ab.
Kontingent-Header begleiten jede Antwort: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used und X-Credits-Remaining sind alle vorhanden und geben einen verlässlichen Einblick in das Volumen der Höhenabfragen, den eine gemeinsam genutzte öffentliche Instanz normalerweise nicht bietet.
Für alles, was über die Standard-Höhenantwort hinausgeht, fügt mg_extras=1 in der Anfrage oder ein X-MG-Extras-Header optionale Extras zur kompatiblen Struktur hinzu, ganz nach Ihrer Wahl.
Der Host ist unter /compatibility/open-elevation/ dokumentiert, und der zugrunde liegende Höhen-Endpunkt wird ausführlich unter /docs/elevation-lookup/ beschrieben. Wenn Höhenabfragen heute Teil einer Karten- oder Routing-Funktion sind, ist dies ein einfacher Weg, hinter derselben Anfragestruktur ein eigenes Kontingent einzurichten.