Static Maps API

A map image from a single URL. Put it in an email, a PDF, an invoice or a link preview, anywhere JavaScript can't run.
Loading preview…

Move the map to set the centre and zoom. Click to add a marker, click a marker to remove it.

Only used in the copied URL. Get a key.

What people use it for

Emails

Order confirmations, delivery updates and event reminders. Email clients block scripts, but they show images.

PDFs and invoices

Job sheets, quotes, property reports and receipts generated on the server.

Link previews

An og:image showing the place a page is about, for social posts and chat apps.

Fast pages

A light image in place of an interactive map, swapped for the live map when someone taps it.

URL format

https://static.expressmaps.com/static/{style}/{lon},{lat},{zoom}/{width}x{height}[@2x].png?key=KEY
https://static.expressmaps.com/static/{style}/auto/{width}x{height}[@2x].png?key=KEY&marker=lon,lat
PartMeaning
styleAny of the twenty style ids, such as standard, linen or carbon.
lon,lat,zoomCentre and zoom (0 to 20, fractions allowed). Use auto instead to fit every marker.
width x height1 to 1280 each, in CSS pixels. Add @2x for a sharp image on retina screens (double the pixels).
keyYour API key. Required.
markerlon,lat or lon,lat,color (hex without #). Repeat up to 20 times.
paddingWith auto: space around the markers in pixels, default 40.
bearing, pitchRotation in degrees, and tilt from 0 to 60.

Keys, limits and billing

Each image counts as one map load, the same as an interactive map, so the free plan includes 100,000 a month. Images are cached for a day, and repeat requests for the same URL served from that cache are not counted.

If your key is restricted to websites, images only render when they are embedded on those sites. For emails and server-side code, create a separate key in the console with no website restriction, or restrict it to your server's IP addresses. Each key can render 60 images a minute; ask us if you need more.

StatusMeaning
200The PNG image.
400A parameter is wrong. The JSON body says which.
401The key is missing, unknown or disabled.
403The key's website or IP restrictions do not allow this request.
429More than 60 images a minute for this key. Wait for the Retry-After seconds.

Start free

100,000 map loads a month, static images included. No card.

Get a free API key

Printing a map?

The print map maker makes posters and PDFs up to A0 at 300 DPI, in the same styles.