Reverse geocoding API for country, state and district
Send lat and lon and get the country and first-level division anywhere in the world, plus the district in Turkey, as JSON.
What it does
Turns a latitude and longitude into a country and its first-level division (state, province, region) worldwide, and into the district (ilçe) in Turkey.
- GET /v1/reverse?lat={lat}&lon={lon}
Limits: No street, city, or postal code. Districts are Turkey only. Borders are generalized at 1:10m, so points within about 1 km of a border or coast can resolve to the neighbour; points at sea return 404.
Use cases
- Fill country and state from a phone's GPS fix.
- Group delivery or field data by province.
- Pick tax or shipping rules by region from coordinates.
Data sources and freshness
Natural Earth admin-1 states and provinces (public domain); geoBoundaries TUR ADM2 from OpenStreetMap (ODbL).
Boundaries are rebuilt when the sources publish a new release.
Pricing
Every new account gets 100 free calls. Packs of 10,000 ($5), 100,000 ($15) and 250,000 calls ($29) never expire, or choose Unlimited for $39 a month. Only successful responses use a call. See pricing.
FAQ
How precise is it?
Country and first-level division worldwide (Natural Earth 1:10m), and district level in Turkey (geoBoundaries / OpenStreetMap). Points within about 1 km of a border or coastline can resolve to the neighbour; points at sea return 404.
Does it return addresses or cities?
No. There is no street, city or postal code. For postal codes, use the postal codes API.
Are coordinates logged?
No. Request logs keep only the route pattern, not the query string.