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
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.
| Service | Status | You get | Outside Lagos |
|---|---|---|---|
| Beta | Street, area, ward, city, LGA, state, country | State, LGA, city | |
| Alpha | A point for a place or street name | Little | |
| Alpha | Suggestions as people type | Little | |
| Alpha | Location, gates, hours, verified photos | Little | |
| Alpha | Places in a radius, nearest first | Little |
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
Not yet
- Landmark sentences. "opposite the filling station" will not resolve
- Streets outside Lagos. often null; place searches may be empty
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.
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.