Move the map to set the centre and zoom. Click to add a marker, click a marker to remove it.
Order confirmations, delivery updates and event reminders. Email clients block scripts, but they show images.
Job sheets, quotes, property reports and receipts generated on the server.
An og:image showing the place a page is about, for social posts and chat apps.
A light image in place of an interactive map, swapped for the live map when someone taps it.
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
| Part | Meaning |
|---|---|
style | Any of the twenty style ids, such as standard, linen or carbon. |
lon,lat,zoom | Centre and zoom (0 to 20, fractions allowed). Use auto instead to fit every marker. |
width x height | 1 to 1280 each, in CSS pixels. Add @2x for a sharp image on retina screens (double the pixels). |
key | Your API key. Required. |
marker | lon,lat or lon,lat,color (hex without #). Repeat up to 20 times. |
padding | With auto: space around the markers in pixels, default 40. |
bearing, pitch | Rotation in degrees, and tilt from 0 to 60. |
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.
| Status | Meaning |
|---|---|
200 | The PNG image. |
400 | A parameter is wrong. The JSON body says which. |
401 | The key is missing, unknown or disabled. |
403 | The key's website or IP restrictions do not allow this request. |
429 | More than 60 images a minute for this key. Wait for the Retry-After seconds. |
The print map maker makes posters and PDFs up to A0 at 300 DPI, in the same styles.