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

# IGeoPushpinChartConfig

- 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/pushpinChart.ts

Configuration for MapLibre-based pushpin rendering.

**Signature:**

```typescript
export interface IGeoPushpinChartConfig 
```

## Remarks

This config type is used by the MapLibre-based geo engine when rendering pushpin layers.

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [basemap?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigbasemap) |  | [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.igeopushpinchartconfig/index.md#igeopushpinchartconfigbounds) |  | [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.igeopushpinchartconfig/index.md#igeopushpinchartconfigcenter) |  | [IGeoLngLat](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeolnglat/index.md) | _(Optional)_ |
| [colorMapping?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigcolormapping) |  | [IColorMapping](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-vis-commons/sdk-ui-vis-commons.icolormapping/index.md)[] | _(Optional)_ |
| [colorPalette?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigcolorpalette) |  | [IColorPalette](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.icolorpalette/index.md) | _(Optional)_ |
| [colors?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigcolors) |  | string[] | _(Optional)_ |
| [cooperativeGestures?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigcooperativegestures) |  | boolean | _(Optional)_ |
| [customTooltip?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigcustomtooltip) |  | [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.igeopushpinchartconfig/index.md#igeopushpinchartconfigenableexecutioncancelling) |  | boolean | _(Optional)_ |
| [isExportMode?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigisexportmode) |  | boolean | _(Optional)_ |
| [legend?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfiglegend) |  | [IGeoChartLegendConfig](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartlegendconfig/index.md) | _(Optional)_ |
| [limit?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfiglimit) |  | number | _(Optional)_ |
| [mapboxToken?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigmapboxtoken) |  | string | _(Optional)_ Mapbox access token. |
| [mapStyle?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigmapstyle) |  | string \| [StyleSpecification](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.stylespecification/index.md) | _(Optional)_ Custom MapLibre style URL or inline specification. |
| [maxZoomLevel?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigmaxzoomlevel) |  | 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.igeopushpinchartconfig/index.md#igeopushpinchartconfigpoints) |  | [IGeoChartPointsConfig](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartpointsconfig/index.md) | _(Optional)_ |
| [respectLegendPosition?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigrespectlegendposition) |  | boolean | _(Optional)_ |
| [selectedSegmentItems?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigselectedsegmentitems) |  | string[] | _(Optional)_ |
| [separators?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigseparators) |  | [ISeparators](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iseparators/index.md) | _(Optional)_ |
| [showLabels?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigshowlabels) |  | boolean | _(Optional)_ |
| [tooltipText?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigtooltiptext) |  | [IAttribute](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iattribute/index.md) | _(Optional)_ Location tooltip label attribute. |
| [viewport?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigviewport) |  | [IGeoChartViewport](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeochartviewport/index.md) | _(Optional)_ |
| [zoom?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.igeopushpinchartconfig/index.md#igeopushpinchartconfigzoom) |  | number | _(Optional)_ |

## Property details

### IGeoPushpinChartConfig.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.

### IGeoPushpinChartConfig.bounds

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

**Signature:**

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

### IGeoPushpinChartConfig.center

**Signature:**

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

### IGeoPushpinChartConfig.colorMapping

**Signature:**

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

### IGeoPushpinChartConfig.colorPalette

**Signature:**

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

### IGeoPushpinChartConfig.colors

**Signature:**

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

### IGeoPushpinChartConfig.cooperativeGestures

**Signature:**

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

### IGeoPushpinChartConfig.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;
```

### IGeoPushpinChartConfig.enableExecutionCancelling

**Signature:**

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

### IGeoPushpinChartConfig.isExportMode

**Signature:**

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

### IGeoPushpinChartConfig.legend

**Signature:**

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

### IGeoPushpinChartConfig.limit

**Signature:**

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

### IGeoPushpinChartConfig.mapboxToken

> Warning: This API is now obsolete.
> 
> Kept only for backward compatibility. Not used by MapLibre-based geo charts.
> 

Mapbox access token.

**Signature:**

```typescript
mapboxToken?: string;
```

#### Remarks

Kept only for backward compatibility with the legacy Mapbox-based implementation. MapLibre-based geo charts ignore this value.

### IGeoPushpinChartConfig.mapStyle

Custom MapLibre style URL or inline specification.

**Signature:**

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

### IGeoPushpinChartConfig.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

### IGeoPushpinChartConfig.points

**Signature:**

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

### IGeoPushpinChartConfig.respectLegendPosition

**Signature:**

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

### IGeoPushpinChartConfig.selectedSegmentItems

**Signature:**

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

### IGeoPushpinChartConfig.separators

**Signature:**

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

### IGeoPushpinChartConfig.showLabels

**Signature:**

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

### IGeoPushpinChartConfig.tooltipText

Location tooltip label attribute.

**Signature:**

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

#### Remarks

Kept for backward compatibility with the legacy GeoPushpinChart API where this lived under `config`. Prefer `tooltipText` on pushpin layers when using [GeoChart()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-geo/sdk-ui-geo.geochart/index.md).

### IGeoPushpinChartConfig.viewport

**Signature:**

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

### IGeoPushpinChartConfig.zoom

**Signature:**

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