Beta

Static maps

Today: live (Beta) since 11 November 2026.

What it does

Gives a PNG or WebP picture of the map for an address you build: a centre, a zoom, a size, and optional markers and a route line. Use it in trip receipts, emails and pages where a live map is too heavy. The picture always carries "© Rana Maps © OpenStreetMap".

Request

https://maps-api.ranamaps.com/v1/static?center=6.5244,3.3792&zoom=14&size=600x300&markers=6.5244,3.3792&key=pk_live_...

Parameter	Notes
`size`	Required. `WIDTHxHEIGHT`, each 1 to 1280
`center`, `zoom`	`lat,lng` and 0 to 20. Leave both out to fit the markers and the path
`scale`	`2` for sharp screens (twice the pixels)
`format`	`png` (default) or `webp`
`style`	`day` (default), `night` or a published Rana Studio style code
`markers`	`color:red\|size:small\|label:A\|lat,lng\|lat,lng`. Repeat the parameter for different styles. Up to 50 markers. Colours are names or `0xRRGGBB`
`path`	`color:0x1c7ed6\|weight:5\|lat,lng\|lat,lng`, or `enc:` with a polyline at precision 6. One path, up to 500 points

In an <img> tag, use ?key= with a public key limited to your site's origin. The browser's Referer (its origin, under the default referrer policy) is matched against the key, so do not set referrerpolicy="no-referrer".
Addresses are not accepted in center or markers; geocode them first.

<img alt="Map of the pickup point" width="600" height="300"
     src="https://maps-api.ranamaps.com/v1/static?center=6.5244,3.3792&zoom=14&size=600x300&key=pk_live_...">
<!-- The picture already shows "© Rana Maps © OpenStreetMap". Do not crop it out. -->

Caching

Identical addresses are served from Cloudflare's cache for a day and do not count as usage. A new image takes about 2 seconds the first time in a place and well under a second after that.

Coverage

The picture shows whatever the map shows: roads across Nigeria once the Nigeria release is deployed, with the most names and places in Lagos.

Limits

Trial: 30 images a minute, 500 a day.