---
title: "MapOptions | Geosplats sdk"
description: "Documentation for MapTiler GeoSplats SDK"
---

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

# Interface MapOptions

Options for initializing a [Map](https://docs-qmgv.pages.dev/geosplats-sdk/api/classes/Map/) instance.

interface MapOptions {  
    [apiKey](#apikey)?: string;  
    [basemap](#basemap)?: [ReferenceMapStyle](https://docs-qmgv.pages.dev/geosplats-sdk/api/types/ReferenceMapStyle/);  
    [bearing](#bearing)?: number;  
    [center](#center)?: [LngLatLike](https://docs-qmgv.pages.dev/geosplats-sdk/api/types/LngLatLike/);  
    [container](#container): string | HTMLElement;  
    [logoControl](#logocontrol)?: [ControlPosition](https://docs-qmgv.pages.dev/geosplats-sdk/api/types/ControlPosition/);  
    [maxPitch](#maxpitch)?: number;  
    [maxZoom](#maxzoom)?: number;  
    [minPitch](#minpitch)?: number;  
    [minZoom](#minzoom)?: number;  
    [modelResolutionControl](#modelresolutioncontrol)?: boolean | [ControlPosition](https://docs-qmgv.pages.dev/geosplats-sdk/api/types/ControlPosition/);  
    [navigationControl](#navigationcontrol)?: boolean | [ControlPosition](https://docs-qmgv.pages.dev/geosplats-sdk/api/types/ControlPosition/);  
    [pitch](#pitch)?: number;  
    [zoom](#zoom)?: number;  
}

##### Index

### Properties[](#properties)

[apiKey?](#apikey) [basemap?](#basemap) [bearing?](#bearing) [center?](#center) [container](#container) [logoControl?](#logocontrol) [maxPitch?](#maxpitch) [maxZoom?](#maxzoom) [minPitch?](#minpitch) [minZoom?](#minzoom) [modelResolutionControl?](#modelresolutioncontrol) [navigationControl?](#navigationcontrol) [pitch?](#pitch) [zoom?](#zoom)

## Properties[](#properties-1)

### `Optional`apiKey[](#apikey)

apiKey?: string

Your MapTiler Cloud API key. Get one for free at [https://maptiler.com/cloud/](https://maptiler.com/cloud/)

### `Optional`basemap[](#basemap)

basemap?: [ReferenceMapStyle](https://docs-qmgv.pages.dev/geosplats-sdk/api/types/ReferenceMapStyle/)

The base map style to use.

#### Default[](#default)

```typescript
'satellite-v4'
```

### `Optional`bearing[](#bearing)

bearing?: number

The initial bearing (rotation) in degrees.

### `Optional`center[](#center)

center?: [LngLatLike](https://docs-qmgv.pages.dev/geosplats-sdk/api/types/LngLatLike/)

The initial center position of the map.

### container[](#container)

container: string | HTMLElement

The HTML element or ID of the container where the map will be rendered.

### `Optional`logoControl[](#logocontrol)

logoControl?: [ControlPosition](https://docs-qmgv.pages.dev/geosplats-sdk/api/types/ControlPosition/)

Where to show MapTiler logo

### `Optional`maxPitch[](#maxpitch)

maxPitch?: number

The maximum pitch (tilt) allowed.

### `Optional`maxZoom[](#maxzoom)

maxZoom?: number

The maximum zoom level allowed.

### `Optional`minPitch[](#minpitch)

minPitch?: number

The minimum pitch (tilt) allowed.

### `Optional`minZoom[](#minzoom)

minZoom?: number

The minimum zoom level allowed.

### `Optional`modelResolutionControl[](#modelresolutioncontrol)

modelResolutionControl?: boolean | [ControlPosition](https://docs-qmgv.pages.dev/geosplats-sdk/api/types/ControlPosition/)

Whether to show the detail control.

### `Optional`navigationControl[](#navigationcontrol)

navigationControl?: boolean | [ControlPosition](https://docs-qmgv.pages.dev/geosplats-sdk/api/types/ControlPosition/)

Whether to show navigation controls (zoom, compass).

### `Optional`pitch[](#pitch)

pitch?: number

The initial pitch (tilt) in degrees.

### `Optional`zoom[](#zoom)

zoom?: number

The initial zoom level.