Beta

Rana Maps developer changelog

Newest first. Dates are when a change was written, not when it was released; "not live" means it is built but not deployed. Breaking changes are marked and announced here before they happen: 30 days ahead for Beta, 7 days for Alpha.

11 November 2026: live

• Released: Rana Studio with business accounts, organisations and keys; the web services on maps-api.ranamaps.com (directions, distance matrix, snap to roads, reverse geocoding and static maps in Beta; forward geocoding and places in Alpha); usage counts and the free trial's daily limits; in-house telemetry on the web services.
• Not yet: the SDKs are not published (ask hello@ranamaps.com for early access), and routing covers Lagos until the Nigeria release. Map tiles and styles still load without a key.

11 November 2026 (written before the release)

• Prices set: directions ₦2,500, distance matrix ₦1,500 per 1,000 cells, snap to roads ₦2,000, geocoding ₦1,500, places autocomplete ₦1,500, place details and nearby ₦3,000, static maps ₦1,000, all per 1,000. Every paid plan gets free units every month: 25,000 of each product, except geocoding 10,000 and static maps 5,000. See limits and usage.

• Telemetry, in-house only: the SDKs post health events to POST /v1/telemetry (daily counts, 90 days, off with one setting). Searches that find nothing and route starts and ends are kept only as daily counts per ~1 km cell. See telemetry and privacy. The API and SDK terms describe both (draft, for legal review).

• Static maps (Beta): GET /v1/static with markers, one path, day or night or a Studio style, PNG or WebP, and the attribution drawn into the image. See static maps.

• SDKs (Beta, 0.1.0-beta.1, not published yet): @ranamaps/maps-js for the web, com.ranamaps:maps-android for Android 8.0 and later, RanaMapsSDK for iOS 17 and later. See web, Android and iPhone.

• Places (Alpha): GET /v1/places/autocomplete, GET /v1/places/<id> (street, gates with status and hours, approved photos) and GET /v1/places/nearby. See places.

• Snap to roads (Beta): POST /v1/roads/snap, up to 100 points, with distance along the roads. See roads.

• Reverse geocoding (Beta): GET /v1/geocode/reverse gives street, area, ward, city, LGA and state.

• Forward geocoding (Alpha): GET /v1/geocode?q=. See geocoding.

• Directions (Beta): POST /v1/directions/route with modes car, okada, keke, bicycle and walk, waypoints, alternatives, avoid, and place ids that route to an open gate. See directions.

• Distance matrix (Beta): POST /v1/directions/matrix, up to 100 cells, usage per cell. See distance matrix.

• Keys checked on maps-api.ranamaps.com. Every web service needs a key in X-Rana-Key (or ?key=). New: GET /v1/key describes your key, plan and limits. See keys and security.

• Limits per organisation, usage per product. Studio's Keys and usage page shows usage per product and this month's estimate. See limits and usage.

• Plans: Trial (free), pay as you go, and Starter and Business subscriptions that include usage, with overage billed past it. Prices are proposed and invoiced by hand in naira.

• New error code: spending_cap_reached (429), for organisations with a monthly spending cap.

• Map tiles and styles: a key you send is checked. Loading with no key still works; that will be announced here first.

• route.ranamaps.com is for Rana's own apps. Other websites are refused. Use directions with your key.

10 November 2026

• Labels. Everything is Beta, including all three SDKs when they ship. Places (autocomplete, details, nearby search) and forward geocoding are Alpha. Every page and every response (Rana-Stability header) shows its label. See stability.
• Conventions for all new endpoints (not live yet):
  • Host maps-api.ranamaps.com. api.ranamaps.com stays for Rana's own apps and for style addresses for now.
  • Keys in the X-Rana-Key header (or ?key=). Keys are removed from all logs.
  • Errors are {"error", "message", "docs"} with a stable error code. See errors.
  • Points are {"lat", "lng"}; lines are precision-6 polylines or GeoJSON; metres and seconds as integers.
  • Headers X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After, Rana-Stability and Rana-Request-Id.
• Limits per organisation, not per key, with Trial limits for new organisations. See limits and usage.
• Coming next: key checks are about to be enforced on the web services, then on tiles and styles. Shipped apps keep working during the roll-out.
• Coverage: the Nigeria release is built and tested (not live yet). Roads and routing will cover all of Nigeria, with Lagos having the most street names and places.
• SDK platforms when they ship: Android 8.0 (API 26), iOS 17, and browsers with ES2020.
• Docs reorganised: one page per product, with what works today, what does not, and coverage. The examples pages are now maps on the web, maps on Android and maps on iPhone.

3 November 2026

• Started the developer documentation: overview, web, Android and iPhone examples, and this changelog.
• Not live yet: business accounts (migration 024). Sign in by emailed link, organisations with roles (owner, admin, editor, viewer), invitations, public (pk_) and secret (sk_) API keys, per-key daily usage counts, and an audit log. Needs deployment and an email provider.
• Not live yet: published styles for organisations. GET /v1/styles/<code>/style.json serves the latest published revision to anyone with the code, and ?revision=N serves that published revision. Drafts are never served. The style of a suspended organisation answers 404.
• Not enforced yet: key checks. The API has an internal check endpoint (GET /v1/keys/check) that the edge will use later, with a daily cap on private-layer tiles per key (past the cap the map falls back to roads only). Nothing calls it, so no key is needed to load a published style or tiles, and no cap is applied. Enforcement will be announced here first, with a roll-out that does not break shipped apps.
• Terms: the API and SDK terms now separate public keys (allowed in client code, limited to named origins or apps) from secret keys (server only), and add the daily cap, anti-scraping, attribution and suspension rules. These are drafts pending legal review.
• Search protection for Rana's own apps and web map: Play Integrity on Android, App Attest on iPhone and Cloudflare Turnstile on the web map give a short search session (30 minutes, 30 searches). Not offered to customers.
• Coverage is Lagos only.