Static Maps API

Easily show a map of anywhere in the world anywhere you can display an image. This API is completely free to use, with options to customise the location, size, zoom, and colour theme of the map as well as letting you place a custom marker.

Try it out here!

This was built with TypeScript, with Express as the web framework, Protomaps for map tiles, MapLibre GL JS to render the map, and Playwright to take a screenshot of the map to provide to the user.

API endpoint documentation

The API is available at /map with the following parameters:

• width: Width of the map in pixels. Default: 640
• height: Height of the map in pixels. Default: 480
• lon: Longitude coordinate the map should be centred on. Default: 0
• lat: Latitude coordinate the map should be centred on. Default: 0
• zoom: Zoom level of the map from 1-22 (with 1 being the most zoomed out). Default: 1
• country: Country code of the country to focus the map on. This is optional, and if you set it then it will overide the lon, lat, and zoom options. You can view a list of the valid country codes here.
• theme: Theme of the map, can be light, dark, or satellite. Default: light
• markerLon: Longitude coordinate of the marker. If you exclude this option there will be no marker on the map.
• markerLat: Latitude coordinate of the marker.
• markerColor: Colour of the marker as a hex code (excluding the #). Default: ff5050