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

# IGeoChartConfig

- 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/config/unified.ts
- Guides: [Geo chart](https://www.gooddata.ai/docs/gooddata-ui/latest/visualisations/geo-chart/index.md)

Unified configuration shared by [GeoChart()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.geochart/index.md) and its wrappers.

**Signature:**

```typescript
export interface IGeoChartConfig 
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [areas?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigareas) |  | [IGeoAreasConfig](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeoareasconfig/index.md) | _(Optional)_ Area-specific options (opacity, border styling, ...). |
| [basemap?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigbasemap) |  | [GeoBasemap](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.geobasemap/index.md) | **_(ALPHA)_** _(Optional)_ Selected basemap style identifier (e.g. `"standard-light"`, `"satellite"`). |
| [bounds?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigbounds) |  | [IGeoLngLatBounds](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeolnglatbounds/index.md) | _(Optional)_ Bounding box for custom viewport. Takes priority over center/zoom and adapts to container dimensions. |
| [center?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigcenter) |  | [IGeoLngLat](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeolnglat/index.md) | _(Optional)_ Initial map center. Defaults to auto-centering based on data. |
| [colorMapping?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigcolormapping) |  | [IColorMapping](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-vis-commons/sdk-ui-vis-commons.icolormapping/index.md)[] | _(Optional)_ Explicit color-mapping overrides. |
| [colorPalette?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigcolorpalette) |  | [IColorPalette](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.icolorpalette/index.md) | _(Optional)_ Structured color palette compatible with color mapping GUIDs. |
| [colors?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigcolors) |  | string[] | _(Optional)_ Simple palette expressed as color strings. |
| [cooperativeGestures?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigcooperativegestures) |  | boolean | _(Optional)_ Requires Ctrl/Cmd + scroll to zoom (helps inside scroll containers). |
| [customTooltip?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigcustomtooltip) |  | [ICustomTooltipConfig](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-vis-commons/sdk-ui-vis-commons.icustomtooltipconfig/index.md) | **_(ALPHA)_** _(Optional)_ Custom tooltip configuration with Markdown content and metric/attribute references. |
| [enableExecutionCancelling?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigenableexecutioncancelling) |  | boolean | _(Optional)_ Cancels running executions when props change. |
| [isExportMode?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigisexportmode) |  | boolean | _(Optional)_ Enables export mode (disables gestures, preserves drawing buffer). |
| [legend?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfiglegend) |  | [IGeoChartLegendConfig](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartlegendconfig/index.md) | _(Optional)_ Legend configuration. |
| [limit?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfiglimit) |  | number | _(Optional)_ Maximum number of rendered data points. |
| [mapStyle?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigmapstyle) |  | string \| [StyleSpecification](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.stylespecification/index.md) | _(Optional)_ MapLibre style URL or inline style specification. |
| [maxZoomLevel?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigmaxzoomlevel) |  | number \| null | _(Optional)_ Maximum zoom level allowed on the map. |
| [points?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigpoints) |  | [IGeoChartPointsConfig](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartpointsconfig/index.md) | _(Optional)_ Pushpin-specific options (size range, clustering, ...). |
| [respectLegendPosition?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigrespectlegendposition) |  | boolean | _(Optional)_ Keeps the requested legend position even when responsive heuristics disagree. |
| [selectedSegmentItems?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigselectedsegmentitems) |  | string[] | _(Optional)_ Segment values that should stay visible when using legend-driven filtering. |
| [separators?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigseparators) |  | [ISeparators](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iseparators/index.md) | _(Optional)_ Custom number separators used for formatting. |
| [showLabels?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigshowlabels) |  | boolean | _(Optional)_ Displays data labels on the map when supported by the layer. |
| [viewport?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigviewport) |  | [IGeoChartViewport](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartviewport/index.md) | _(Optional)_ Viewport preset or explicit bounds. |
| [zoom?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartconfig/index.md#igeochartconfigzoom) |  | number | _(Optional)_ Initial zoom level (0-22). Defaults to auto-fit. |

## Property details

### IGeoChartConfig.areas

Area-specific options (opacity, border styling, ...).

**Signature:**

```typescript
areas?: IGeoAreasConfig;
```

### IGeoChartConfig.basemap

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Selected basemap style identifier (e.g. `"standard-light"`, `"satellite"`).

**Signature:**

```typescript
basemap?: GeoBasemap;
```

#### Remarks

`undefined` uses the backend default basemap.

### IGeoChartConfig.bounds

Bounding box for custom viewport. Takes priority over center/zoom and adapts to container dimensions.

**Signature:**

```typescript
bounds?: IGeoLngLatBounds;
```

### IGeoChartConfig.center

Initial map center. Defaults to auto-centering based on data.

**Signature:**

```typescript
center?: IGeoLngLat;
```

### IGeoChartConfig.colorMapping

Explicit color-mapping overrides.

**Signature:**

```typescript
colorMapping?: IColorMapping[];
```

### IGeoChartConfig.colorPalette

Structured color palette compatible with color mapping GUIDs.

**Signature:**

```typescript
colorPalette?: IColorPalette;
```

### IGeoChartConfig.colors

Simple palette expressed as color strings.

**Signature:**

```typescript
colors?: string[];
```

### IGeoChartConfig.cooperativeGestures

Requires Ctrl/Cmd + scroll to zoom (helps inside scroll containers).

**Signature:**

```typescript
cooperativeGestures?: boolean;
```

### IGeoChartConfig.customTooltip

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Custom tooltip configuration with Markdown content and metric/attribute references.

**Signature:**

```typescript
customTooltip?: ICustomTooltipConfig;
```

### IGeoChartConfig.enableExecutionCancelling

Cancels running executions when props change.

**Signature:**

```typescript
enableExecutionCancelling?: boolean;
```

### IGeoChartConfig.isExportMode

Enables export mode (disables gestures, preserves drawing buffer).

**Signature:**

```typescript
isExportMode?: boolean;
```

### IGeoChartConfig.legend

Legend configuration.

**Signature:**

```typescript
legend?: IGeoChartLegendConfig;
```

### IGeoChartConfig.limit

Maximum number of rendered data points.

**Signature:**

```typescript
limit?: number;
```

### IGeoChartConfig.mapStyle

MapLibre style URL or inline style specification.

**Signature:**

```typescript
mapStyle?: string | StyleSpecification;
```

### IGeoChartConfig.maxZoomLevel

Maximum zoom level allowed on the map.

**Signature:**

```typescript
maxZoomLevel?: number | null;
```

#### Remarks

- `undefined` keeps default max zoom level - `null` switches to unrestricted zoom level

### IGeoChartConfig.points

Pushpin-specific options (size range, clustering, ...).

**Signature:**

```typescript
points?: IGeoChartPointsConfig;
```

### IGeoChartConfig.respectLegendPosition

Keeps the requested legend position even when responsive heuristics disagree.

**Signature:**

```typescript
respectLegendPosition?: boolean;
```

### IGeoChartConfig.selectedSegmentItems

Segment values that should stay visible when using legend-driven filtering.

**Signature:**

```typescript
selectedSegmentItems?: string[];
```

### IGeoChartConfig.separators

Custom number separators used for formatting.

**Signature:**

```typescript
separators?: ISeparators;
```

### IGeoChartConfig.showLabels

Displays data labels on the map when supported by the layer.

**Signature:**

```typescript
showLabels?: boolean;
```

### IGeoChartConfig.viewport

Viewport preset or explicit bounds.

**Signature:**

```typescript
viewport?: IGeoChartViewport;
```

### IGeoChartConfig.zoom

Initial zoom level (0-22). Defaults to auto-fit.

**Signature:**

```typescript
zoom?: number;
```