Beta

Geocoding

Today: live since 11 November 2026: reverse geocoding Beta, forward geocoding Alpha. The answers on this page show example values.

Reverse geocoding (Beta)

• Street: our contributors' verified street names first, then OpenStreetMap road names, within 40 m. street_source says which (rana or openstreetmap).
• Area, ward, LGA and state: OpenStreetMap boundaries, suburbs and neighbourhoods.
• City: the nearest city within 20 km, else the nearest town within 10 km.

GET https://maps-api.ranamaps.com/v1/geocode/reverse?lat=6.5244&lng=3.3792

curl "https://maps-api.ranamaps.com/v1/geocode/reverse?lat=6.5244&lng=3.3792" -H "X-Rana-Key: $RANA_SECRET_KEY"

{
  "street": "Herbert Macaulay Way",
  "street_source": "rana",
  "area": "Yaba",
  "ward": null,
  "city": "Lagos",
  "lga": "Lagos Mainland",
  "state": "Lagos",
  "country": "NG",
  "formatted": "Herbert Macaulay Way, Yaba, Lagos",
  "attribution": "© Rana Maps © OpenStreetMap"
}

A field we do not know is null. Outside Lagos, street is often null. Outside Nigeria everything is null.

Forward geocoding (Alpha)

Forward geocoding depends on our places data, so it is Alpha: it can change with 7 days' notice and finds little outside Lagos. Nigerian addresses often name a landmark ("opposite the filling station"); we match names of places and streets, not free sentences.

GET https://maps-api.ranamaps.com/v1/geocode?q=Yaba+Market&lat=6.51&lng=3.37&limit=5

{
  "results": [{ "label": "Yaba Market", "point": { "lat": 6.5095, "lng": 3.3711 }, "kind": "place", "place_id": "6f1c…" }],
  "attribution": "© Rana Maps © OpenStreetMap"
}

• kind is place, street, stop, city, town or state.
• lat and lng are optional and bias results towards that point. limit is 1 to 10 (default 5).
• place_id works with directions and places.

Coverage

States, LGAs and cities: all of Nigeria. Street names and places: most in Lagos, few elsewhere yet.

Limits

Trial: 60 requests a minute together with places, 2,000 a day.