background color for sections where the painter doesn't draw to Default is rgba(0, 0, 0, 0) (transparent)

Strictly a WM Projection property. Force the view to fill. Defaults to false.

description of the style - not used for anything other than debugging

Strictly a WM Projection property. Render the world map as necessary to fill the screen horizontally. Defaults to true.

Utilize WIP experimental components that still have bugs in them.

Fonts and how to fetch them

ex.

"fonts": {
 "robotoMedium": "/api/glyphs-v2/RobotoMedium"
}
Copy

Glyph Data (both fonts and icons) and how to fetch them

ex.

"glyphs": {
 "robotoMedium": "/api/glyphs-v2/RobotoMedium",
 "streets": "/api/glyphs-v2/streets"
}
Copy

Icons and how to fetch them

ex.

"icons": {
 "streets": "/api/glyphs-v2/streets"
}
Copy

Image names and where to fetch

ex.

"images": {
  "pattern": "/images/pattern.jpg"

Copy

Layers are the main way to render data on the map. Your layer options are:

• fill - Draw polygons with a fill color, outline, and opacity
• glyph - Draw text, icons, sprites, etc.
• heatmap - Takes lots of points as an input and produces a heatmap
• hillshade - Draw hillshading on the map given an input elevation tile.
• line - Lines with variable width, cap, and join types
• point - Draw individual points, even if they're clustered, deconstruct lines and polygons, etc.
• raster - RGBA encoded tile data
• sensor - Sensor data is a temporal construct that takes gridded data and draws it on the map using a color ramp.
• shade - Draw a nice "shade" gradient on the globe to give it depth if you're using the S2 Projection. Usually only want one.

The maximum latitude position. Useful for the S2 Projection to avoid wonky movemeny at low zooms

The closest you allow the camera to get to the planet

The minimum latitude position. Useful for the S2 Projection to avoid wonky movemeny at low zooms

The furthest away from the planet you allow

name of the style - not used for anything other than debugging

Allow the camera to go past the max-min latitudes. Useful for animations.

Use Either The Web Mercator "WM" or the "S2" Projection. [Default: "S2"]

Skybox is often used as a background feature for raster data. Uses a skybox image to render to the screen.

See UrlMap to use your own scheme/protocol for the URL path.

ex.

"skybox": {
   "path": "baseURL://backgrounds/milkyway",
   "loadingBackground": "rgb(9, 8, 17)",
   "size": 2048,
   "type": "webp"
}
Copy

Where to fetch data and JSON guides on how to fetch them. If JSON data, it can be included directly in the source

ex.

"sources": {
     "countries": "/s2json/countriesHD.s2json",
     "earthquakes": "/s2json/earthquakes.s2json"
   }
Copy

Sprites names and where to fetch

Sprites have a default expectancy of a png image.

If you want to use a different format, you can use an object instead of a string.

See UrlMap to use your own scheme/protocol for the URL path.

ex.

"sprites": {
   "streets": "/sprites/streets/sprite@2x"
}
Copy

ex.

"sprites": {
   "streets": {
     "path": "/sprites/streets/sprite@2x",
     "fileType": "jpg"
   }
}
Copy

Time series data is a WIP. Is a guide on how to render &/ animate data at various timestamps

version of the style - not used for anything other than debugging

Set the camera view. Properties include:

• zoom: the zoom level of the map
• lon: the longitude of the map
• lat: the latitude of the map
• bearing: the bearing/compass of the map camera
• pitch: the pitch/vertical-angle of the map camera

Wallpaper is often used with vector data. Control the coloring of the background.

ex.

"wallpaper": {
  "background": "#030a2d",
  "fade1": "rgb(138, 204, 255)",
  "fade2": "rgb(217, 255, 255)",
  "halo": "rgb(230, 255, 255)"
}
Copy

zFar is a parameter for the camera. Recommend not touching

zNear is a parameter for the camera. Recommend not touching

Often times to improve the quality of raster data, you can apply a zoomOffset for tiles to render.