Thunderforest Maps API
Mar 26,2026
GISBox is a one-stop 3D GIS data editing, conversion and publishing platform that supports editing in multiple GIS formats such as OSGB/GEOTIFF/RVT, converting to 3DTiles/Terrain and publishing.
Introduction
Thunderforest Maps API is a collective term for the map delivery services provided by Thunderforest, offering an API that allows for the rapid integration of high-quality maps into web and mobile applications. It is accessed using an API key and provides multiple services, including standard map style delivery, raster tiles, static maps, vector styles, and vector sources. It features map styles such as OpenCycleMap, Transport, Landscape, Outdoors, and Atlas, and is easy to integrate with existing map libraries.
File Structure
The Thunderforest Maps API is not a single API but consists of several related services. The main components are as follows:
- Map Tiles API: An API that delivers raster-format map tiles. It supports the tile delivery method commonly used in web maps and can be used directly with many map libraries.
- Static Maps API: An API that generates static map images based on specified parameters such as location, zoom level, and size. It is suitable for uses such as thumbnails, reports, and shareable images.
- Vector Styles API: An API that provides drawing styles for vector maps. It allows flexible map rendering on the client side, making it suitable for design adjustments and customization.
- Vector Sources API: An API that provides vector data sources. It can be used for map drawing with vector tiles or for advanced display in combination with custom styles.
- API Key: An authentication key required to use Thunderforest's APIs and services. All major services are accessed via an API key.
- Supported Map Styles: Multiple map styles optimized for different purposes are available, including OpenCycleMap, Transport, Landscape, Outdoors, Atlas, and Transport Dark.
Pros
- Easy Integration: Usage can begin immediately after obtaining an API key, and it can be integrated relatively easily into existing web map libraries.
- Diverse Map Styles Provided: Multiple map designs can be selected according to purpose, such as cycling, transportation, outdoor activities, and general navigation.
- Supports Both Raster and Vector: In addition to traditional raster tiles, vector styles and vector sources are also provided, accommodating flexible rendering methods.
- Easy to Leverage Existing Tech Stacks: It does not rely on a proprietary SDK and can be used in combination with various libraries such as OpenLayers, Leaflet, Flutter, and MapLibre.
- Extensibility to Custom Maps: Beyond using standard styles, it also supports custom map creation, such as adjusting brand colors or display elements.
Cons
- API Key Management Required: An API key is necessary for use, requiring operational awareness of public exposure and access control.
- Reliance on External Services: Map delivery depends on Thunderforest's infrastructure, so operations must be designed assuming the use of an external service. This may result in reduced flexibility compared to self-hosted delivery. This is an operational characteristic derived from the official features of "rapid integration" and "hosting provision."
- Limitations on Free Usage: Official sources indicate the existence of both free and paid plans, meaning cost management according to usage volume is necessary for full-scale operation.
- Additional Design Required for Advanced Customization: While standard styles are ready to use, achieving project-specific appearances or expressions requires knowledge of vector styles and custom map design.
Application Scenario
The Thunderforest Maps API is a map API well-suited for use in web mapping services, mobile navigation, cycling applications, public transportation guides, and outdoor support applications. For example, OpenCycleMap is suitable for displaying cycling routes, Transport is geared towards transportation information, Outdoors is appropriate for hiking and understanding natural environments, and Atlas is suitable for general guide maps. Additionally, the Static Maps API enables embedding maps in reports or shareable images, while the Vector Styles API and Vector Sources API support applications requiring more flexible map expressions.
Example
1. Thunderforest Static Maps API.

Related GIS Services
Web Coverage Service (WCS)
Web Feature Service(WFS)
Web Map Tile Service (WMTS)
Tile Map Service (TMS)
References
- https://www.thunderforest.com/docs/static-maps-api/
- https://www.thunderforest.com/
- https://help.openstreetmap.org/questions/55965/thunderforest-api-key-and-qgis/