---
title: "Add a raster tile source | JavaScript maps SDK"
description: "Add a third-party raster source to the map."
---
> 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.
# Add a raster tile source
To enhance your map, you have the option to incorporate a third-party raster source into the map. This could involve integrating satellite maps or drone images, as well as other raster layers like historical maps, for example. By doing so, you can enrich the visual representation and expand the range of information provided on your map.
### NPM module setup
```bash
npm install --save @maptiler/sdk
```
#### main.js
```js
import { Map, 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 id
style: {
'version': 8,
'sources': {
'raster-tiles': {
'type': 'raster',
'tiles': [
`https://api.maptiler.com/tiles/satellite-v2/{z}/{x}/{y}.jpg`
],
'tileSize': 256,
'attribution':
'© MapTiler © OpenStreetMap contributors'
}
},
'layers': [
{
'id': 'simple-tiles',
'type': 'raster',
'source': 'raster-tiles',
'minzoom': 0,
'maxzoom': 22
}
]
},
center: [-74.5, 40], // starting position
zoom: 2 // starting zoom
});
```
#### index.html
```html
Add a raster tile source | NPM example
```
#### style.css
```css
body {margin: 0; padding: 0;}
#map {position: absolute; top: 0; bottom: 0; width: 100%;}
```
### Basic JavaScript setup
```html
Add a raster tile source
```
## Related examples
### [Add a WMS source](https://docs.maptiler.com/sdk-js/examples/wms/)
Examples
Add an external Web Map Service raster layer.
### [Raster layer](https://docs.maptiler.com/sdk-js/examples/raster-layer/)
Tutorials
Add a raster image overlay to the map.
### [Display a satellite map](https://docs.maptiler.com/sdk-js/examples/satellite-map/)
Examples
Display a satellite raster map baselayer.
### [Add hillshading](https://docs.maptiler.com/sdk-js/examples/hillshade/)
Examples
Add raster hillshading effect to a MapTiler map.