Beta

Limits and usage

Today: live since 11 November 2026. New organisations start on the free trial with daily limits. The numbers below are the first setting and may change; changes are announced in the changelog.

Limits belong to your organisation

Limits apply to your organisation, not to each key. More keys do not raise them. There are two kinds:

Per minute, per product group, over a rolling 60 seconds. Over it you get 429 rate_limited.
Per day, per product, reset at 00:00 UTC (01:00 in Lagos). Over it you get 429 daily_limit_reached.

Trial limits

Every new organisation starts on the Trial plan:

Product group	Per minute	Per day
Directions and roads	60 requests	2,000 directions, 1,000 roads
Distance matrix	1,000 cells	10,000 cells
Geocoding and places	60 requests	2,000 geocoding, 2,000 places
Static maps	30 images	500 images

Plans

Plan	What you pay	Limits
Trial	Nothing	The Trial limits above. Past a daily allowance, requests are refused until 00:00 UTC
Pay as you go	Free units every month (below), then the prices below, invoiced monthly	5 times Trial per minute, 10 times Trial per day
Starter	A monthly fee that includes usage worth more than the fee; usage past it at a discount	As pay as you go
Business	A larger monthly fee, more included usage, a bigger discount past it	20 times Trial per minute, 50 times Trial per day
Custom	Agreed in writing	Agreed in writing

You choose the plan. Write to hello@ranamaps.com to change it.
You can ask for a monthly spending cap. Past it, requests get 429 spending_cap_reached until the next month.
Invoices are sent by hand, in naira. Studio's Keys and usage page shows this month's estimate.

Prices (pay as you go)

On every paid plan, each product has free units every month. After them:

Product	Free every month	Naira per 1,000 units after that
Directions	25,000	2,500
Distance matrix	25,000 cells	1,500 (per 1,000 cells)
Snap to roads	25,000	2,000
Geocoding	10,000	1,500
Places autocomplete	25,000	1,500
Place details, nearby search	25,000 each	3,000
Static maps	5,000 images	1,000 (per 1,000 images)

Subscription	Monthly fee	Usage included (at the prices above)	Past it
Starter	₦100,000	₦150,000	10% off
Business	₦500,000	₦850,000	20% off

Map tiles and styles are not billed.

Request size limits

Product	Limit
Distance matrix	100 cells (origins × destinations) per request
Snap to roads	100 points per request

Map tiles

Map tiles follow their own rule. Each public key has a daily cap on tiles from our private layers (street names, places, stops). Past it, the map shows roads only until the next UTC day. It is never an error, so your map keeps working.

Headers

Every keyed response says where you stand:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
Rana-Stability: beta
Rana-Request-Id: 3f1c9a0e5b7d4c21

On a 429 or 503, Retry-After gives the seconds to wait.

How usage is counted

Usage is counted per key, per product, per UTC day, and shown in Studio's Usage page for the whole organisation.

Product	One unit is
Directions	one request (alternatives do not add)
Distance matrix	one cell (one origin to one destination)
Roads	one request
Geocoding	one request
Places autocomplete, details, nearby	one request each
Static maps	one image made (repeats served from cache are free)
Tiles and styles	one request (not billed)

A request counts when it passed the key check and got a 2xx answer, including empty results. Refused requests do not count. Tiles and styles are counted at the edge once a minute per key, so their numbers are approximate.

Fair use

No bulk download, scraping or building a dataset from our answers. Read the API and SDK terms.

Coverage

Limits are the same everywhere. Results are thinner outside Lagos, especially for places and forward geocoding.