Alpha

Places

Alpha. Places can change with 7 days' notice, and finds few or no places outside Lagos. Read stability.

Today: live (Alpha) since 11 November 2026, with few places outside Lagos. The answers show example values.

What it does

Our places are collected by contributors who walk and ride the streets. They include things other maps often miss: estate gates and whether they are open, bus stops, and the street a place is really on.

Autocomplete

curl "https://maps-api.ranamaps.com/v1/places/autocomplete?q=yaba+mar&lat=6.51&lng=3.37" -H "X-Rana-Key: $RANA_PUBLIC_KEY"

{
  "suggestions": [{
    "place_id": "6f1c2a9e-…",
    "name": "Yaba Market",
    "secondary": "Market",
    "kind": "market",
    "point": { "lat": 6.5095, "lng": 3.3711 }
  }],
  "attribution": "© Rana Maps © OpenStreetMap"
}

Details

GET https://maps-api.ranamaps.com/v1/places/6f1c2a9e-…

{
  "place_id": "6f1c2a9e-…",
  "name": "Yaba Market",
  "aliases": [],
  "kind": "market",
  "point": { "lat": 6.5095, "lng": 3.3711 },
  "street": "Murtala Muhammed Way",
  "house_number": null,
  "how_to_find": "Enter by the north gate, opposite the bus stop.",
  "gates": [{ "name": "North gate", "role": "main", "point": { "lat": 6.5097, "lng": 3.3712 }, "status": "open", "hours": "07:00-19:00" }],
  "photos": [{ "id": "…", "url": "https://maps-api.ranamaps.com/v1/places/photos/…" }],
  "updated_at": "2026-11-01T10:00:00Z",
  "attribution": "© Rana Maps © OpenStreetMap"
}

• status is the gate now, in Lagos time: open, closed, or unknown when we have no hours.
• Photo URLs need your key like any other request. Photos are approved by a person, with faces and number plates blurred. Viewing them is not counted as usage.
• A place_id from another map service answers 404 not_found.

Nearby

GET https://maps-api.ranamaps.com/v1/places/nearby?lat=6.51&lng=3.37&radius_m=500&kind=health

• radius_m is 1 to 2,000 (default 500). limit is 1 to 50 (default 20). keyword matches part of the name.
• kind is one of fuel, bank, worship, education, health, lodging, market, food, shop, service, government, office, leisure, other.
• Each result has place_id, name, kind, point and distance_m, nearest first.

What it does not do

• Place ids from other map services do not work here. Store our place_id values instead.
• No reviews, ratings or prices.
• No bulk download. Show places to your users; do not build a dataset from them.

Coverage

Lagos has the most places, because that is where our contributors map today. Outside Lagos, expect empty answers for now. Empty is 200 with an empty list, never an error.

Limits

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