Nominatim @ TerravoNominatim @ Terravo

Self-hosted geocoding API over OpenStreetMap data (Europe) — a public gateway into the server's spare capacity, with a fair rate limit. Self-hosted geokódovací API nad daty OpenStreetMap (Evropa) — veřejná brána do volné kapacity serveru, se slušným rate limitem.

API endpoint: https://api.nominatim.terravo.eu
This page (nominatim.terravo.eu) is documentation only — don't send queries here, use the endpoint above. API endpoint: https://api.nominatim.terravo.eu
Tahle stránka (nominatim.terravo.eu) je jen dokumentace — žádné dotazy sem neposílejte, ty jdou na endpoint výše. Try /status →Zkusit /status →

What this isCo to je

Nominatim is a geocoding and reverse geocoding engine built on OpenStreetMap data — it turns addresses/places into coordinates (/search) and coordinates back into an address (/reverse). This instance runs on Terravo's own hardware and covers European data. Nominatim je geokódovací a reverzní geokódovací engine nad daty OpenStreetMap — převádí adresy/místa na souřadnice (/search) a souřadnice zpátky na adresu (/reverse). Tahle instance běží na vlastním hardware Terravo a pokrývá evropská data.

How to use itJak se používá

Search a place by textVyhledání místa podle textu (/search):

curl "https://api.nominatim.terravo.eu/search?q=Prague&format=json&limit=1"

Address from coordinatesAdresa ze souřadnic (/reverse):

curl "https://api.nominatim.terravo.eu/reverse?lat=50.0755&lon=14.4378&format=json"

Supported parameters (format, limit, addressdetails, countrycodes, ...) match the standard Nominatim API — the full query structure is documented in the official project docs: Podporované parametry (format, limit, addressdetails, countrycodes, ...) odpovídají standardnímu Nominatim API — plná struktura dotazů je zdokumentovaná v oficiální dokumentaci projektu: Search API · Reverse API.

Rate limitRate limit

TrafficProvozLimitLimit
Normal useBěžné použití 1 req/s per IP addressna IP adresu
Long-running / regular (scripted) trafficDlouhodobĂ˝ / pravidelnĂ˝ (skriptovanĂ˝) provoz degraded to 4 req/mindegradace na 4 req/min per IP addressna IP adresu

The degraded limit applies to clients generating traffic for more than a day, or in tight regular intervals (typically automated scrapers) — the same principle used by the public nominatim.openstreetmap.org instance. Exceeding the limit returns HTTP 429. Need higher volume long-term? Get in touch, we can work something out. Degradace se týká klientů, kteří generují provoz déle než den nebo v pravidelných krátkých intervalech (typicky automatizované scrapery) — stejný princip jako u veřejné instance nominatim.openstreetmap.org. Překročení limitu vrací HTTP 429. Potřebuješ vyšší objem dlouhodobě? Ozvi se, domluvíme se.

Data attributionAtribuce dat

Data comes from OpenStreetMap and is licensed under the Open Database License (ODbL) 1.0. When using the results, you must credit: Data pochází z OpenStreetMap a podléhají licenci Open Database License (ODbL) 1.0. Při použití výsledků je nutné uvést: 

© OpenStreetMap contributors — https://www.openstreetmap.org/copyright

Every API response also includes a licence field with the same attribution directly in the data. Každá odpověď API navíc obsahuje pole licence se stejnou atribucí přímo v datech.