# DeckGL (Scripting Interface)
`DeckGL` extends the core [Deck](./deck.md) class with some additional features such as Mapbox integration. It offers a convenient way to use deck.gl in prototype environments such as [Codepen](https://codepen.io), [JSFiddle](https://jsfiddle.net) and [Observable](https://observablehq.com).
Make sure to read the [Using deck.gl Scripting API](../../get-started/using-standalone.md) article.
## Usage
```js
new deck.DeckGL({
mapStyle: 'https://tiles.openfreemap.org/styles/positron',
initialViewState: {
longitude: -122.45,
latitude: 37.8,
zoom: 12
},
controller: true,
layers: [
new deck.ScatterplotLayer({
data: [
{position: [-122.45, 37.8], color: [255, 0, 0], radius: 100}
],
getColor: d => d.color,
getRadius: d => d.radius
})
]
});
```
## Properties
All [Deck](./deck.md) class properties, with these additional props that can be passed to the constructor:
#### `container` (DOMElement | String, optional) {#container}
Default: `document.body`
The container in which deck.gl should append its canvas. Can be either a HTMLDivElement or the element id. The deck.gl canvas is resized to fill the container.
#### `map` (object, optional) {#map}
Default: `window.mapboxgl || window.maplibregl`
The scripting API offers out-of-the-box integration with [Mapbox GL JS](https://mapbox.com) or [MapLibre GL JS](https://maplibre.org). To add a base map to your visualization, you need to include the base map library and stylesheet:
```html
```
The above script adds `mapboxgl` or `maplibregl` to the global scope, which will be picked up by default.
To disable the base map, simply exclude the mapbox script or set `map` to false.
In some environments such as Observable, libraries cannot be imported into the global scope, in which case you need to manually pass the mapboxgl object to `map`:
```js
mapboxgl = require('mapbox-gl@^3.0.0/dist/mapbox-gl.js');
// or
maplibregl = require('maplibre-gl@^3.0.0/dist/maplibre-gl.js');
```
And
```js
new deck.DeckGL({
...
map: mapboxgl // or maplibregl
});
```
#### `mapStyle` (object | string, optional) {#mapstyle}
The style JSON or URL for the Mapbox map.
#### `mapboxApiAccessToken` (string, optional) {#mapboxapiaccesstoken}
The API access token to use Mapbox tiles. See [Mapbox GL JS](https://www.mapbox.com/mapbox-gl-js/api) documentation for how to use Mapbox.
#### `mapOptions` (object, optional) {#mapoptions}
Additional options to pass to the [mapboxgl.Map](https://docs.mapbox.com/mapbox-gl-js/api/map/) or [maplibregl.Map](https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/MapOptions/) constructor.
## Methods
All [Deck](./deck.md) class methods, with these additional methods:
#### `getMapboxMap` {#getmapboxmap}
Returns the mapbox-gl or maplibre-gl [Map](https://www.mapbox.com/mapbox-gl-js/api/#map) instance if a base map is present.
## Source
[modules/main/bundle.ts](https://github.com/visgl/deck.gl/blob/master/modules/main/bundle.ts)