Skip to content
POST AI agent ready /v1/geo/reverse

Reverse Geocoding API - Convert Lat/Lng to Address

Send a latitude and longitude pair and receive the corresponding street address, city, country, and display name. Powered by the OpenStreetMap Nominatim service. Useful for converting GPS coordinates from devices, photo EXIF data, or map clicks into readable locations.

Parameters

numberrequired

Latitude in decimal degrees (-90 to 90).

numberrequired

Longitude in decimal degrees (-180 to 180).

Code examples

curl -X POST https://api.botoi.com/v1/geo/reverse \
  -H "Content-Type: application/json" \
  -d '{"lat":37.4224,"lng":-122.0842}'

When to use this API

Display a readable address when users drop a pin on a map

When a user taps a location on your map, send the coordinates to this endpoint and show the street address in a tooltip or sidebar. Saves users from having to type the address manually.

Tag photos with location names from EXIF GPS data

Extract lat/lng from photo EXIF metadata and reverse-geocode them. Display "Taken in Mountain View, California" instead of raw coordinates in your photo gallery.

Enrich fleet tracking data with street addresses

Convert GPS coordinates from vehicle trackers into street addresses for dispatch logs, delivery confirmations, and route reports.

Frequently asked questions

What data does the response include?
The response includes the full display_name (street address), a shorter address field, city, country, and the original lat/lng. The level of detail depends on OpenStreetMap coverage for the location.
What happens if the coordinates are in the ocean or an unmapped area?
The API returns a 404 NOT_FOUND error if Nominatim cannot find an address for the given coordinates. Open ocean, remote wilderness, and Antarctica may not have address data.
How precise are the results?
Precision depends on OpenStreetMap data density for the area. In cities, you typically get building-level accuracy. In rural areas, results may resolve to the nearest road or village.
Can I reverse-geocode multiple coordinates in one request?
No. Each request handles a single coordinate pair. For batch processing, make parallel requests. Respect the Nominatim rate limit of 1 request/second for anonymous access.
Is this endpoint free?
Yes. Anonymous access allows 5 requests per minute. An API key raises the rate limit based on your plan tier. There are no per-request charges.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs