Sign in

v1

latestOpenAPI 3.0.32026-07-1761214.3 KB
Geocoding

Reverse geocoding (point → labeled feature + admin chain)

Sequential pipeline:

  1. Photon reverse → nearest labeled feature + its own admin tags.
  2. Placeholder fills in missing admin chain when Photon's tags are thin.
get/api/v1/reverse

Query parameters

latnumber double required
lonnumber double required
langstring

Response

feature returned (may be null if no nearby OSM feature)

Example response

{
  "data": {
    "here": {
      "id": "node:240109189",
      "name": "Berlin",
      "label": "Berlin, Germany",
      "type": "city",
      "coords": {
        "lat": 52.52,
        "lon": 13.405
      },
      "admin": {
        "country": "Germany",
        "state": "Berlin",
        "city": "Berlin"
      }
    },
    "admin": {
      "country": "Germany",
      "state": "Berlin",
      "city": "Berlin"
    }
  },
  "meta": {
    "upstream": "ok",
    "count": 5
  }
}