Get Map API Reference
Estimated reading time: 1 minuteThe 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
andpbf
. - 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 arede
,en
,es
,fr
,it
,ja
,ko
,nl
,ru
,zh
. You can useint
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 arede
,en
,es
,fr
,it
,ja
,ko
,nl
,ru
,zh
. You can useint
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):