Skip to content

Animate a series of images

Use a series of image sources to create an animation.

const map = new maplibregl.Map({
    container: 'map',
    style: 'https://demotiles.maplibre.org/style.json',
    maxZoom: 5.99,
    minZoom: 4,
    zoom: 5,
    center: [-75.789, 41.874]
});

const frameCount = 5;
let currentImage = 0;

function getPath() {
    return (
        `https://maplibre.org/maplibre-gl-js/docs/assets/radar${
            currentImage
        }.gif`
    );
}

map.on('load', () => {
    map.addSource('radar', {
        type: 'image',
        url: getPath(),
        coordinates: [
            [-80.425, 46.437],
            [-71.516, 46.437],
            [-71.516, 37.936],
            [-80.425, 37.936]
        ]
    });
    map.addLayer({
        id: 'radar-layer',
        'type': 'raster',
        'source': 'radar',
        'paint': {
            'raster-fade-duration': 0
        }
    });

    setInterval(() => {
        currentImage = (currentImage + 1) % frameCount;
        map.getSource('radar').updateImage({url: getPath()});
    }, 200);
});

<!DOCTYPE html>
<html lang="en">
<head>
    <title>Animate a series of images</title>
    <meta property="og:description" content="Use a series of image sources to create an animation." />
    <meta property="og:created" content="2025-06-25" />
    <meta charset='utf-8'>
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <link rel='stylesheet' href='https://unpkg.com/maplibre-gl@5.24.0/dist/maplibre-gl.css' />
    <script src='https://unpkg.com/maplibre-gl@5.24.0/dist/maplibre-gl.js'></script>
    <style>
        body { margin: 0; padding: 0; }
        html, body, #map { height: 100%; }
    </style>
</head>
<body>
<div id="map"></div>
<script>
    const map = new maplibregl.Map({
        container: 'map',
        style: 'https://demotiles.maplibre.org/style.json',
        maxZoom: 5.99,
        minZoom: 4,
        zoom: 5,
        center: [-75.789, 41.874]
    });

    const frameCount = 5;
    let currentImage = 0;

    function getPath() {
        return (
            `https://maplibre.org/maplibre-gl-js/docs/assets/radar${
                currentImage
            }.gif`
        );
    }

    map.on('load', () => {
        map.addSource('radar', {
            type: 'image',
            url: getPath(),
            coordinates: [
                [-80.425, 46.437],
                [-71.516, 46.437],
                [-71.516, 37.936],
                [-80.425, 37.936]
            ]
        });
        map.addLayer({
            id: 'radar-layer',
            'type': 'raster',
            'source': 'radar',
            'paint': {
                'raster-fade-duration': 0
            }
        });

        setInterval(() => {
            currentImage = (currentImage + 1) % frameCount;
            map.getSource('radar').updateImage({url: getPath()});
        }, 200);
    });
</script>
</body>
</html>