Skip to content

Static Maps

Static maps generate an image of a map based on a set of parameters. They are useful for displaying a map where interactivity is not required.

GET /maps/map/v1/styles/{style_id}/static/{lon},{lat},{zoom}/{width}x{height}

Required path parameters:

  • style_id: The ID of the style to use.
  • lon: The longitude of the center of the map.
  • lat: The latitude of the center of the map.
  • zoom: The zoom level of the map.
  • width: The width of the image in pixels.
  • height: The height of the image in pixels.

Optional arguments:

  • scale: Use hdpi for a high-resolution image.
  • ext: The image extension type. Possible values are png, jpg or webp. Defaults to png.