GENEVO Geocode API

Reverzní geokódování (GPS → adresa) a vyhledávání (adresa → GPS) nad vlastním Nominatimem s daty OpenStreetMap pro Evropu. Bez limitů veřejného OSM. Autentizace hlavičkou X-API-Key.

GPS → adresa (bulk)

curl -s https://geo.genevotools.com/v1/reverse \
  -H "X-API-Key: VAS_KLIC" -H "Content-Type: application/json" \
  -d '{"points":[{"id":1,"lat":50.0874654,"lon":14.4212535},{"id":2,"lat":49.1951,"lon":16.6068}]}'

GPS → adresa (jeden bod)

curl -s "https://geo.genevotools.com/v1/reverse?lat=50.0874654&lon=14.4212535" -H "X-API-Key: VAS_KLIC"

Adresa → GPS

curl -s "https://geo.genevotools.com/v1/search?q=Sokolovsk%C3%A1%20100,%20Praha&limit=1" -H "X-API-Key: VAS_KLIC"

Odpověď (pole results)

polevýznam
statusok | empty (v Evropě, ale bez adresy) | outside_coverage (mimo Evropu) | invalid | error
formattedkrátká adresa: Ulice 12, 110 00 Praha
display_nameplná adresa od Nominatimu
address.*street, house_number, place, suburb, district, city, postcode, county, state, state_code, country, country_code
match.distance_mvzdálenost nalezené adresy od zadaného bodu (metry)
match.precisionhouse | street | place | city — jak přesný nález to je
idvaše ID z požadavku (vrací se zpět, pořadí odpovídá vstupu)
cachedtrue = odpověď z cache (stejné souřadnice už byly dotazované)

empty znamená, že na daném místě není žádný adresní bod (moře, les, pole). Pokud je znám alespoň stát/kraj, najdete ho v address a v note je důvod.

Parametry

langjazyk názvů, výchozí cs (např. de, en)
zoom0–18, výchozí 18 (číslo popisné); nižší = obec/kraj
raw1 = přiloží i originální odpověď Nominatimu

Limity: max 500 bodů na požadavek, stav služby na /health. Data © OpenStreetMap contributors (ODbL).