MapScale Docs
•••
API ReferenceStatic maps
MapScale API
GET/v1/static/{lonLatZoom}/{sizeFile}

Render a static map image

Generate a PNG map image with an optional style, language, markers and path.

LIVE API PLAYGROUND

Sign in or create an account

Continue to run live requests directly from the docs.

Sends this request to the live API and shows the real response.

Parameters

Equivalent request
curl \
  -H "X-MapScale-Key: $MAPSCALE_API_KEY" \
  "https://api.mapscale.io/v1/static/100.5018%2C13.7563%2C12/1200x630.png?lang=th"
Response
Default response
{
  "status": "200",
  "contentType": "image/png",
  "description": "A rendered PNG static map."
}

Responses

200A rendered PNG static map.image/png
400Invalid coordinates, zoom, or size.application/json
401mapscale/effect-api/UnauthorizedFailureapplication/json
403mapscale/effect-api/ForbiddenFailureapplication/json
404Unknown styleId.application/json
429mapscale/effect-api/RateLimitedFailureapplication/json
500mapscale/effect-api/MiddlewareInternalFailureapplication/json
502The render service returned an error.application/json
503The render service is unreachable or not configured. | mapscale/effect-api/UpstreamUnavailableFailureapplication/json

On this page