> Documentation index: https://www.gooddata.ai/docs/gooddata-ui/llms.txt lists every page of these docs as Markdown.

# IGeoLayerBase

- Package: [@gooddata/sdk-ui-geo](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/index.md)
- Kind: interface
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-ui-geo/src/next/types/layers/index.ts

Base interface for all geo layer configurations.

**Signature:**

```typescript
export interface IGeoLayerBase 
```

## Remarks

This interface defines the common properties shared by all layer types. Each layer operates independently with its own data execution, allowing different data sources, filters, and configurations per layer.

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [color?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeolayerbase/index.md#igeolayerbasecolor) |  | [IAttributeOrMeasure](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iattributeormeasure/index.md) | _(Optional)_ Color measure or attribute for this layer. |
| [config?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeolayerbase/index.md#igeolayerbaseconfig) |  | [IGeoLayerConfig](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeolayerconfig/index.md) | _(Optional)_ Optional per-layer configuration. |
| [filters?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeolayerbase/index.md#igeolayerbasefilters) |  | [INullableFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.inullablefilter/index.md)[] | _(Optional)_ Filters specific to this layer. |
| [id](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeolayerbase/index.md#igeolayerbaseid) |  | string | Unique identifier for this layer. |
| [name?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeolayerbase/index.md#igeolayerbasename) |  | string | _(Optional)_ Human-readable name for the layer. |
| [segmentBy?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeolayerbase/index.md#igeolayerbasesegmentby) |  | [IAttribute](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iattribute/index.md) | _(Optional)_ Segment attribute for categorization. |
| [sortBy?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeolayerbase/index.md#igeolayerbasesortby) |  | [ISortItem](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.isortitem/index.md)[] | _(Optional)_ Sorting for this layer. |
| [tooltipText?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeolayerbase/index.md#igeolayerbasetooltiptext) |  | [IAttribute](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iattribute/index.md) | _(Optional)_ Tooltip text attribute for this layer. |
| [type](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeolayerbase/index.md#igeolayerbasetype) |  | [GeoLayerType](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.geolayertype/index.md) | Layer type discriminator. |

## Property details

### IGeoLayerBase.color

Color measure or attribute for this layer.

**Signature:**

```typescript
color?: IAttributeOrMeasure;
```

#### Remarks

When a measure is provided, colors are determined by the measure values using a color scale (gradient). When an attribute is provided, colors are assigned categorically based on attribute values.

For pushpin layers, this affects the fill color of the markers. For area layers, this affects the fill color of the regions.

### IGeoLayerBase.config

Optional per-layer configuration.

**Signature:**

```typescript
config?: IGeoLayerConfig;
```

#### Remarks

This config is intentionally limited to layer-scoped options only.

### IGeoLayerBase.filters

Filters specific to this layer.

**Signature:**

```typescript
filters?: INullableFilter[];
```

#### Remarks

Array of filters applied only to this layer's data execution.

These filters are applied \*\*before\*\* any global/component-level filters (e.g. `GeoChart.filters`). When both layer and global filters are provided, the global filters are applied \*after\* the layer filters and therefore take precedence for filter types with “last wins” merge rules (for example date filters for the same date dataset or measure value filters for the same measure). Other filter types may accumulate according to SDK merge semantics.

### IGeoLayerBase.id

Unique identifier for this layer.

**Signature:**

```typescript
id: string;
```

#### Remarks

Used internally to track layer state and for debugging purposes. Each layer in a GeoChart must have a unique id.

### IGeoLayerBase.name

Human-readable name for the layer.

**Signature:**

```typescript
name?: string;
```

#### Remarks

Optional display name that may be shown in legends or tooltips. If not provided, the layer id is used.

### IGeoLayerBase.segmentBy

Segment attribute for categorization.

**Signature:**

```typescript
segmentBy?: IAttribute;
```

#### Remarks

Groups data points by the specified attribute, creating separate visual categories with distinct colors. When segmentBy is used, a category legend is displayed.

For pushpin layers, different segments get different marker colors. For area layers, different segments get different fill colors.

### IGeoLayerBase.sortBy

Sorting for this layer.

**Signature:**

```typescript
sortBy?: ISortItem[];
```

#### Remarks

Defines how data points are sorted for this layer. Sorting can affect tooltip display order and rendering priority.

### IGeoLayerBase.tooltipText

Tooltip text attribute for this layer.

**Signature:**

```typescript
tooltipText?: IAttribute;
```

#### Remarks

An attribute whose values are displayed in tooltips when hovering over data points in this layer. If not provided, falls back to the unified config's `tooltipText` setting.

### IGeoLayerBase.type

Layer type discriminator.

**Signature:**

```typescript
type: GeoLayerType;
```

#### Remarks

Determines the rendering mode for this layer. Use `"pushpin"` for point/marker data or `"area"` for region/polygon data.