Get Map API Reference

Estimated reading time: 1 minute

Map API

The Maps API allows you to retrieve vector or raster tiles generated by the lab. You can use some libraries like Leaflet or Mapbox GL JS to add a map to your website.

Endpoint to use

https://{s}.tile.jawg.io/your-style-id/{z}/{x}/{y}{@2x}.{format}?access-token=your-jawg-access-token
\___/   \_/ \__________/\_____________/\_________/\___/  \____/               \____________________/
  |      |       \         /              /           \       \                          |
scheme subdomain  domain  style ID  tiles coordinates  retina  tile format    authentication token
  • subdomain: available subdomains are a, b, c and d. Browser-based applications can thus request multiple tiles from multiple subdomains faster than from one subdomain.
  • style ID: your style ID or one of our default styles for raster tiles or streets-v1, landcover-v1 for vector tiles.
  • retina: only for raster tiles, this generate 512x512 tiles instead of 256x256.
  • tile format: available formats are png and pbf.
  • authentication token: create your access token on the lab.

Jawg default styles

We have some default styles which can be used by anyone with an access token. Here is our list (click on the image for a preview):

jawg-streets

jawg-sunny

jawg-terrain

jawg-dark

jawg-light

jawg-matrix

jawg-silver