Early accessWe are building Rana Maps in the open: all of Nigeria on the map, Lagos in the most detail.See what is live

Geocoding and places

Geocoding for Nigerian addresses.

Turn a point into a readable address with street, area, LGA and state. Street names are recorded by contributors, not guessed.

  • Reverse geocoding: Beta
  • Address search: Alpha
  • Priced in naira
maps-api.ranamaps.com/v1/geocode/reverse
A Rana Maps render of Lagos: a gold route runs from Victoria Island across Ikoyi and the Lekki–Ikoyi bridge to Lekki Phase I, with a blue start pin and a green end pin.

A real route from our routing engine, drawn by our own web SDK. Map data © Rana Maps © OpenStreetMap.

Coordinates in, an address out.

Reverse geocoding is Beta.

  • Contributors first. Street names recorded on the ground and checked.
  • Then road names. OpenStreetMap roads within 40 metres. street_source says which.
  • Unknown is null. We never guess a field.
  • All Nigeria. State, LGA and city everywhere; streets thinner outside Lagos.
Illustration: a pin with coordinates turned into street, area, LGA and state
Admiralty Way, Lekki Phase I, Eti-Osa, Lagos.

What you can call

Five services, one key.

See the geocoding docs and places docs.

ServiceStatusYou getOutside Lagos
Reverse geocodingBetaStreet, area, ward, city, LGA, state, countryState, LGA, city
Forward geocodingAlphaA point for a place or street nameLittle
AutocompleteAlphaSuggestions as people typeLittle
Place detailsAlphaLocation, gates, hours, verified photosLittle
Nearby searchAlphaPlaces in a radius, nearest firstLittle

The request

A point in, a line out.

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

# Example values
{ "street": "Herbert Macaulay Way", "street_source": "rana",
  "area": "Yaba", "city": "Lagos", "lga": "Lagos Mainland",
  "state": "Lagos", "country": "NG",
  "formatted": "Herbert Macaulay Way, Yaba, Lagos" }

Honest limits

Names, not sentences.

Works today

  • Reverse geocoding. a point to a readable address
  • Place and street names. matched, with an optional bias point
  • State, LGA and city. across Nigeria

Use it

Where teams use geocoding.

Fintech and KYC

An address with LGA and state for field verification.

Delivery drops

A readable address on the rider's screen.

Store locators

Search as you type for local places.

Records

Keep a static map image with the record.

Price

Free every month, then per 1,000.

Billed in naira, before VAT. Empty results still count. See pricing.

Geocoding₦1,500per 1,000 requests10,000 free a month
Autocomplete₦1,500per 1,000 requests25,000 free a month
Place details₦3,000per 1,000 requests25,000 free a month
Nearby search₦3,000per 1,000 requests25,000 free a month

Questions

Geocoding questions.

Something else? Write to us and a person will answer.

Can I turn a written Nigerian address into coordinates?

Partly, and it is Alpha: forward geocoding matches names of places and streets, not free sentences. It finds little outside Lagos today.

What does reverse geocoding return?

A street, area, ward, city, LGA, state and country, plus a formatted line. A field we do not know is null.

Where do the street names come from?

First from Rana's contributors, then from OpenStreetMap road names within 40 metres. The street_source field says which.

Does it work outside Lagos?

Reverse geocoding gives state, LGA and city across Nigeria. Streets and places are thinner outside Lagos for now.

How much does geocoding cost?

The first 10,000 geocoding requests each month are free. After that it is ₦1,500 per 1,000 requests, before VAT.

Put Nigerian addresses on a map you can trust.

Create your organisation in a few minutes. Your first requests every month are free.