Beta

Getting started

Today: live (Beta) since 11 November 2026. The SDKs are not published yet: ask hello@ranamaps.com for early access to them.

Go to studio.ranamaps.com and enter your work email address. Rana sends a sign-in link. It works once and expires in 15 minutes. There are no passwords. Disposable email domains are refused.

2. Create an organisation

Give it a name. It is active at once and you are its owner. Limits and usage belong to the organisation, not to one person or one key. Invite your team with one of these roles:

Role	Can do
viewer	See styles and usage
editor	Also edit and publish styles
admin	Also manage keys and invite members
owner	Also change roles and delete the organisation

3. Create a key

In Studio, open Keys and choose a kind:

Public key (pk_live_…) for a web page or an app. Name where it may be used: web origins (for example https://www.example.com), Android apps (package name and signing certificate SHA-256) or iOS bundle ids.
Secret key (sk_live_…) for your server only.

The key is shown once. Copy it into your secret store or app config. Read keys and security before you ship.

4. Make your first call

Show the map in a page with the web SDK (npm i @ranamaps/maps-js, not published yet):

import { Rana } from "@ranamaps/maps-js";
import "@ranamaps/maps-js/style.css";

new Rana.Map({ key: "pk_live_...", container: "map", style: "day", center: { lat: 6.5244, lng: 3.3792 }, zoom: 11 });
// The map shows "© Rana Maps © OpenStreetMap". Keep it visible.

A call from your server to the web services:

curl https://maps-api.ranamaps.com/v1/directions/route \
  -H "X-Rana-Key: $RANA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"origin":{"lat":6.4541,"lng":3.3947},"destination":{"lat":6.5965,"lng":3.3421},"mode":"car"}'
# The answer carries "attribution": "© Rana Maps © OpenStreetMap".

5. Watch your usage

Studio's Usage page shows requests per product per day for your organisation. See limits and usage.

Coverage