---
title: "LightSpecification | JavaScript maps SDK"
description: "Documentation for MapTiler SDK"
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# Type Alias LightSpecification

type LightSpecification \= {  
    [anchor](#anchor)?: [PropertyValueSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/PropertyValueSpecification/)<"map" | "viewport"\>;  
    [color](#color)?: [PropertyValueSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/PropertyValueSpecification/)<[ColorSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/ColorSpecification/)\>;  
    ["color-transition"](#color-transition)?: [TransitionSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/TransitionSpecification/);  
    [intensity](#intensity)?: [PropertyValueSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/PropertyValueSpecification/)<number\>;  
    ["intensity-transition"](#intensity-transition)?: [TransitionSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/TransitionSpecification/);  
    [position](#position)?: [PropertyValueSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/PropertyValueSpecification/)<\[number, number, number\]\>;  
    ["position-transition"](#position-transition)?: [TransitionSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/TransitionSpecification/);  
}

##### Index

### Properties[](#properties)

[anchor?](#anchor) [color?](#color) [color-transition?](#color-transition) [intensity?](#intensity) [intensity-transition?](#intensity-transition) [position?](#position) [position-transition?](#position-transition)

## Properties[](#properties-1)

### `Optional`anchor[](#anchor)

anchor?: [PropertyValueSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/PropertyValueSpecification/)<"map" | "viewport"\>

Whether extruded geometries are lit relative to the map or viewport.

#### Default[](#default)

```typescript
"viewport"
```

#### Example[](#example)

```typescript
"map"
```

### `Optional`color[](#color)

color?: [PropertyValueSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/PropertyValueSpecification/)<[ColorSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/ColorSpecification/)\>

Color tint for lighting extruded geometries.

#### Default[](#default-1)

```typescript
"#ffffff"
```

### `Optional`color-transition[](#color-transition)

"color-transition"?: [TransitionSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/TransitionSpecification/)

### `Optional`intensity[](#intensity)

intensity?: [PropertyValueSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/PropertyValueSpecification/)<number\>

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

#### Default[](#default-2)

```typescript
0.5
```

### `Optional`intensity-transition[](#intensity-transition)

"intensity-transition"?: [TransitionSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/TransitionSpecification/)

### `Optional`position[](#position)

position?: [PropertyValueSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/PropertyValueSpecification/)<\[number, number, number\]\>

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).

#### Default[](#default-3)

```json
[1.15, 210, 30]
```

#### Example[](#example-1)

```json
[1.5, 90, 80]
```

### `Optional`position-transition[](#position-transition)

"position-transition"?: [TransitionSpecification](https://docs.maptiler.com/sdk-js/api-reference/types/TransitionSpecification/)