---
title: "How to turn on the globe projection | JavaScript maps SDK"
description: "Enable the 3D globe map projection in your application."
---
> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.
# How to turn on the globe projection
This example shows how to turn on the globe projection. Creating a 3D globe view of your map requires only a single line of code. Simply include the `projection` option within the map constructor, specifying the **globe** projection.
The choice between Mercator and Globe can be done at different levels and moments in the lifecycle of the map, yet, unless stated otherwise, **Mercator remains the default**.
### NPM module setup
```bash
npm install --save @maptiler/sdk
```
#### main.js
```js
import { Map, MapStyle, config } from '@maptiler/sdk';
import '@maptiler/sdk/dist/maptiler-sdk.css';
config.apiKey = 'YOUR_MAPTILER_API_KEY_HERE';
const map = new Map({
container: 'map', // container's id or the HTML element to render the map
style: MapStyle.SATELLITE,
center: [-70.8, 0], // starting position [lng, lat]
zoom: 1, // starting zoom
projection: 'globe' //enable globe projection
});
```
#### index.html
```html
How to turn on the globe projection | NPM example
```
#### style.css
```css
body { margin: 0; padding: 0; }
#map { position: absolute; top: 0; bottom: 0; width: 100%; }
```
### Basic JavaScript setup
```html
MapTiler Globe projection
```
## Related examples
### [Projection control (globe)](https://docs.maptiler.com/sdk-js/examples/globe-control/)
Tutorials
Toggle between Mercator and globe projections using map controls.
### [Switch between “mercator” and “globe”](https://docs.maptiler.com/sdk-js/examples/globe-projection-switch/)
Examples
Programmatically switch between Mercator and globe map projections.
### [Globe with ocean bathymetry](https://docs.maptiler.com/sdk-js/examples/globe-bathymetry/)
Examples
Display ocean bathymetry and terrain elevation on 3D globe.
### [3D terrain map](https://docs.maptiler.com/sdk-js/examples/3d-map/)
Tutorials
Create and display 3D terrain maps on web pages.