light

A style's light property provides a global light source for that style. Since this property is the light used to light extruded features, you will only see visible changes to your map style when modifying this property if you are using extrusions.

1
"light": {
2
  "anchor": 'viewport',
3
  "color": 'white',
4
  "intensity": 0.4,
5
}

Let’s take a look at the properties available for light attribute:

anchor

Optional enum. Allow values are 'map', 'viewport' . default: 'viewport'

Should belong to one of map, viewport. It determines whether extruded geometries are lit relative to the map or viewport.

• map: The position of the light source is aligned to the rotation of the map.

• viewport: The position of the light source is aligned to the rotation of the viewport.

1
"anchor": "map"

color

Optional color. Default: '#ffffff'

Supports interpolate expressions. Transitionable. Determines the color tint for lighting extruded geometries.

intensity

Optional number. Default: '0.5'

Should be between 0 and 1 inclusive. Supports interpolate expressions. Transitionable. Intensity of lighting (on a scale from 0 to 1). Higher numbers will present as more extreme contrast.

position

Optional Array<number>. Default: '[1.15,210,30]'

Supports interpolate expressions. Transitionable. Position of the light source relative to lit (extruded) geometries, in [r radial coordinate, a azimuthal angle, p polar angle] where r indicates the distance from the center of the base of an object to its light, a indicates the position of the light relative to 0° (0° when light.anchor is set to viewport corresponds to the top of the viewport, or 0° when light.anchor is set to map corresponds to due north, and degrees proceed clockwise), and p indicates the height of the light (from 0°, directly above, to 180°, directly below).

1
"position": [ 1.5, 90, 80 ]