Maps API
Learn how the Mappinest Maps API provides available map styles through StyleJSON, supported map IDs, and map client integration guides.
Overview
The Maps API provides available map styles through StyleJSON. Use it when you want to render a basemap without uploading your own dataset or maintaining style assets yourself. It works with MapLibre GL JS, Mapbox GL JS, OpenLayers, and Leaflet.
Clients such as MapLibre GL JS, Mapbox GL JS, and OpenLayers can load the StyleJSON document directly. Leaflet can use the same styles through a MapLibre bridge.
Available styles
The supported map IDs are streets, light, dark, and satellite. Each map uses the same endpoint pattern. Switching maps means changing only the map ID in the URL.
Use Available map styles to compare their appearance and copy the correct map ID for your app.
How to integrate
Each map is returned as a StyleJSON document. The document includes the complete source and layer configuration. Pass its URL directly as the style option in supported map clients.
Use the StyleJSON setup guides for MapLibre GL JS, Mapbox GL JS, OpenLayers, and Leaflet.
Maps API pricing
- Billed by map loads
- See current map load allowances and rates in the pricing page's Maps section.
One map load is recorded when a successful request for StyleJSON reaches Mappinest. A visitor can pan, zoom, rotate, and interact with that initialized map as much as they want without creating another map load.
The browser can cache the StyleJSON response for up to 10 minutes. Reusing that browser-cached response does not count as another map load when no new request reaches Mappinest.
Sprites, glyphs, and map raster assets are not counted as additional map loads.
What to read next
Last updated: August 27, 2026