Light¶

The global light source.

"light": {"anchor": "viewport", "color": "white", "intensity": 0.4}

anchor¶

Optional enum. Possible values: map, viewport. Defaults to "viewport".

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.

  "anchor": "map"
  

position¶

Optional array. Defaults to [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).

"position": [1.5, 90, 80]

color¶

Optional color. Defaults to "#ffffff". Supports interpolate expressions. Transitionable.

Color tint for lighting extruded geometries.

intensity¶

Optional number in range [0, 1]. Defaults to 0.5. Supports interpolate expressions. Transitionable.

Intensity of lighting (on a scale from 0 to 1). Higher numbers will present as more extreme contrast.