Get Map API Reference

Estimated reading time: 1 minute

The Maps API allows you to retrieve vector or raster tiles generated by the lab. You can use some libraries like Leaflet or MapLibre GL for JavaScript, Android or iOS to add a map to your website.

Endpoints

If you need tile URL, you should use this endpoint. We are supporting both raster png and vector pbf tiles.

https://tile.jawg.io/your-style-id/{z}/{x}/{y}{@2x}.{format}?access-token=your-jawg-access-token&lang={lang}
\___/   \__________/\_____________/\_________/\___/  \____/               \____________________/      \____/
  |          \         /              /           \       \                          |                   |
scheme        domain  style ID  tiles coordinates  retina  tile format      authentication token      language
  • style ID: your style ID or one of our default styles for raster tiles or streets-v2, landcover-v1, hillshade-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.
  • language: for raster tiles (png) you will get tiles in your language, but you can force the desired one via query parameter. Valid values are de, en, es, fr, it, ja, ko, nl, ru, zh. You can use int for international map.

If you want your style as json for MapLibre GL you will need this endpoint:

https://api.jawg.io/styles/your-style-id.json?access-token=your-jawg-access-token&lang={lang}&extrude={true|false}
\___/   \_________/        \___________/                   \____________________/      \____/         \__________/
  |          |                  |                                     |                  |                  |
scheme     domain            style ID                        authentication token     language       extrude buildings
  • style ID: your style ID or one of our default styles or your custom style from the lab.
  • authentication token: create your access token on the lab.
  • language (optional): for raster tiles (png) you will get tiles in your language, but you can force the desired one via query parameter. Valid values are de, en, es, fr, it, ja, ko, nl, ru, zh. You can use int for international map.
  • extrude (optional): extrude building for 3D view

Map Request Counter

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-terrain
jawg-lagoon
jawg-sunny
jawg-light
jawg-dark