Generate map images for email, cards, PDFs, social previews and server-rendered pages.

What you’ll achieve

Get a shareable PNG from a URL without running browser JavaScript.

Create an image

The path specifies center, zoom and output size. Query parameters select a style, language, markers or a route path.

Edit the inputs, send a real request, and inspect the live response.

Editable inputs

lonLatZoomrequiredstring

sizeFilerequiredstring

styleIdoptionalstring1 options

langoptionalstring17 options

accentoptionalstring

markersoptionalstringmax length 4096

pathoptionalstringmax length 4096

curl \
  -H "X-MapScale-Key: $MAPSCALE_API_KEY" \
  "https://api.mapscale.io/v1/static/100.5018%2C13.7563%2C12/1200x630.png?lang=th"

Default response

{
  "status": "200",
  "contentType": "image/png",
  "description": "A rendered PNG static map."
}

A second example, with a marker

@2x requests a double-density image for high-DPI screens; markers burns a pin into the image itself, since there is no JavaScript on the other end to add one.

Edit the inputs, send a real request, and inspect the live response.

Editable inputs

lonLatZoomrequiredstring

sizeFilerequiredstring

styleIdoptionalstring1 options

langoptionalstring17 options

accentoptionalstring

markersoptionalstringmax length 4096

pathoptionalstringmax length 4096

curl \
  -H "X-MapScale-Key: $MAPSCALE_API_KEY" \
  "https://api.mapscale.io/v1/static/100.5348%2C13.7466%2C14/600x400%402x.png?lang=th"

Default response

{
  "status": "200",
  "contentType": "image/png",
  "description": "A rendered PNG static map."
}

Choose useful dimensions

Generate at the final aspect ratio to avoid cropped labels. Use a larger source image for high-density screens, then constrain its displayed CSS dimensions.

Serve images safely

For private or user-specific maps, request the image on your server and cache it with an appropriate lifetime. Do not place a secret key in public HTML or an email URL.

Next stepPut a map in email →

Static Maps

Create an image

Sign in or create an account

Editable inputs

A second example, with a marker

Sign in or create an account

Editable inputs

Choose useful dimensions

Serve images safely

On this page