---
title: "Add a canvas source | JavaScript maps SDK"
description: "Integrate a dynamic HTML canvas source into 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 canvas source
Add a [`CanvasSource`](https://docs.maptiler.com/sdk-js/api/sources/#canvassource) to the map.
### 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';
//Animation from https://javascript.tutorials24x7.com/blog/how-to-draw-animated-circles-in-html5-canvas
const canvas = document.getElementById('canvasID');
const ctx = canvas.getContext('2d');
const circles = [];
const radius = 20;
function Circle(x, y, dx, dy, radius, color) {
this.x = x;
this.y = y;
this.dx = dx;
this.dy = dy;
this.radius = radius;
this.draw = function () {
ctx.beginPath();
ctx.arc(this.x, this.y, this.radius, 0, Math.PI * 2, false);
ctx.strokeStyle = color;
ctx.stroke();
};
this.update = function () {
if (this.x + this.radius > 400 || this.x - this.radius < 0) {
this.dx = -this.dx;
}
if (this.y + this.radius > 400 || this.y - this.radius < 0) {
this.dy = -this.dy;
}
this.x += this.dx;
this.y += this.dy;
this.draw();
};
}
for (let i = 0; i < 5; i++) {
const color =
'#' +
(0x1000000 + Math.random() * 0xffffff).toString(16).substr(1, 6);
const x = Math.random() * (400 - radius * 2) + radius;
const y = Math.random() * (400 - radius * 2) + radius;
const dx = (Math.random() - 0.5) * 2;
const dy = (Math.random() - 0.5) * 2;
circles.push(new Circle(x, y, dx, dy, radius, color));
}
function animate() {
requestAnimationFrame(animate);
ctx.clearRect(0, 0, 400, 400);
for (let r = 0; r < 5; r++) {
circles[r].update();
}
}
animate();
const map = new Map({
container: 'map',
zoom: 5,
minZoom: 4,
center: [95.899147, 18.088694],
style: MapStyle.STREETS
});
map.on('load', function () {
map.addSource('canvas-source', {
type: 'canvas',
canvas: 'canvasID',
coordinates: [
[91.4461, 21.5006],
[100.3541, 21.5006],
[100.3541, 13.9706],
[91.4461, 13.9706]
],
// Set to true if the canvas source is animated. If the canvas is static, animate should be set to false to improve performance.
animate: true
});
map.addLayer({
id: 'canvas-layer',
type: 'raster',
source: 'canvas-source'
});
});
```
#### index.html
```html
Add a canvas 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 canvas source
```
## Related examples
### [Add an animated icon to the map](https://docs.maptiler.com/sdk-js/examples/add-image-animated/)
Examples
Add animated icons generated at runtime using Canvas API.
### [Add a custom style layer](https://docs.maptiler.com/sdk-js/examples/custom-style-layer/)
Examples
Use a custom style layer for WebGL content.
### [Add a generated icon to the map](https://docs.maptiler.com/sdk-js/examples/add-image-generated/)
Examples
Add custom map icons generated dynamically at runtime.