Offene Wortadressen

WortOrt

Koordinaten in sprechbare Wortadressen umwandeln und wieder zurueck.

Namespace eu1 API /v1

Encode

Koordinaten zu WortOrt

Decode

WortOrt zu Koordinaten

Weitere Formate Geohash, Plus Code, UTM, MGRS
HTTP API JSON-Endpunkte und Beispiele
Swagger UI oeffnen OpenAPI JSON OpenAPI YAML llms.txt humans.txt

Encode

curl -sS -H 'Content-Type: application/json' \
  -d '{"namespace":"eu1","lat":48.1372,"lon":11.5756}' \
  https://wortort.karte.bayern/v1/encode

Decode

curl -sS -H 'Content-Type: application/json' \
  -d '{"namespace":"eu1","code":"eu1:wort.wort.wort.wort"}' \
  https://wortort.karte.bayern/v1/decode

Check

curl -sS -H 'Content-Type: application/json' \
  -d '{"namespace":"eu1","code":"wort.wort.wort.wort"}' \
  https://wortort.karte.bayern/v1/check

Formate

curl -sS -H 'Content-Type: application/json' \
  -d '{"lat":48.1372,"lon":11.5756}' \
  https://wortort.karte.bayern/v1/formats/encode

Das aktuelle eu1-Bundle ist ein Demo-/Preview-Datenstand. Fuer dauerhafte WortOrt-Adressen sollte ein stabil freigegebenes Bundle bewusst ausgewaehlt werden.

Referenz Endpunkte, Felder, Rueckgaben
WortOrt API Endpunkte
Endpunkt Request Antwort Einsatz
POST /v1/encode namespace?, lat, lon code, formats, Metadaten WGS84-Koordinate in WortOrt und weitere Formate umwandeln.
POST /v1/decode namespace?, code lat, lon, formats WortOrt-Code in Zellmitte und aequivalente Formate rueckwandeln.
POST /v1/check namespace?, code valid, reason, suggestions? Validierung und Vorschlaege fuer UI-Autosuggest.
POST /v1/formats/encode lat, lon geohash, plus_code, utm, mgrs Koordinate ohne WortOrt-Bundle in Standardformate wandeln.
POST /v1/formats/decode format, value lat, lon, formats Geohash, Plus Code, UTM oder MGRS nach WGS84 dekodieren.

Request-Regeln

  • Alle v1-Endpunkte erwarten Content-Type: application/json.
  • lat liegt zwischen -90 und 90, lon zwischen -180 und 180.
  • namespace ist optional; ohne Wert wird der geladene Namespace genutzt, aktuell eu1.
  • Bare WortOrt-Codes wie wort.wort.wort.wort werden vor Decode/Check mit dem Namespace normalisiert.

Antwortfelder

  • valid beschreibt, ob die Eingabe gueltig dekodiert werden konnte.
  • precision_m beschreibt die Raster-/Bundle-Praezision in Metern.
  • coverage beschreibt die durch das Bundle abgedeckte Region.
  • formats enthaelt aequivalente Darstellungen: Geohash, Plus Code, UTM und MGRS.

Fehler und Korrektur

  • Ungueltiges JSON oder fehlende Pflichtfelder liefern HTTP 400 mit {"error":"..."}.
  • Wenn der WortOrt-Codec oder das Bundle nicht geladen ist, liefert die API HTTP 503.
  • /v1/check ist fuer interaktive Eingaben robuster als /v1/decode, weil es ungueltige Codes mit valid=false beschreiben kann.

Formatstatus

  • geohash, plus_code, utm und mgrs werden encodiert und dekodiert.
  • mapcode wird bewusst nicht angenaehert; dafuer sind offizielle Gebietstabellen erforderlich.
  • WortOrt-Adressen aus dem aktuellen eu1-Bundle sind Demo-/Preview-Datenstand.