Add an Icon to the Map

Adding a custom icon to a Maptoolkit map involves loading an image into the map’s sprite with addImage, then referencing it by name in a symbol layer’s icon-image paint property. The icon is rendered at the coordinates of each feature in a GeoJSON point source. Use this pattern to mark locations with branded pins, category icons, or any custom SVG or PNG asset.

const API_KEY = 'YOUR_API_KEY';

    const map = new maptoolkit.Map({
        container: 'map',
        apiKey: API_KEY,
        style: `https://styles.maptoolkit.net/maptoolkit/maptoolkit.summer.json?api_key=${API_KEY}`,
        center: [11.39085, 47.27574],
        zoom: 12,
        attributionControl: { compact: false }
    });

    map.addControl(new maptoolkit.NavigationControl(), 'top-right');

    map.on('load', async () => {
        const image = await map.loadImage('https://maplibre.org/maplibre-gl-js/docs/assets/custom_marker.png');
        map.addImage('custom-marker', image.data);

        map.addSource('points', {
                type: 'geojson',
                data: {
                    type: 'FeatureCollection',
                    features: [
                        { type: 'Feature', geometry: { type: 'Point', coordinates: [11.39085, 47.27574] }, properties: { title: 'Innsbruck' } },
                        { type: 'Feature', geometry: { type: 'Point', coordinates: [13.0550, 47.8095] }, properties: { title: 'Salzburg' } },
                        { type: 'Feature', geometry: { type: 'Point', coordinates: [16.3738, 48.2082] }, properties: { title: 'Vienna' } }
                    ]
                }
            });

            map.addLayer({
                id: 'symbols',
                type: 'symbol',
                source: 'points',
                layout: {
                    'icon-image': 'custom-marker'
                }
        });
    });

<!DOCTYPE html>
<html lang="en">
<head>
    <title>Add an Icon to the Map - Maptoolkit Maps JS</title>
    <meta property="og:description" content="Load a custom icon image and use it as a symbol layer." />
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <script src="https://unpkg.com/@maptoolkit/[email protected]/dist/maptoolkit.js"></script>
    <link rel="stylesheet" href="https://unpkg.com/@maptoolkit/[email protected]/dist/maptoolkit.css" />
    <style>
        html, body { width: 100%; height: 100%; margin: 0; padding: 0; }
        #map { width: 100%; height: 100%; }
    </style>
</head>
<body>
<div id="map"></div>
<script>
    const API_KEY = 'YOUR_API_KEY';

    const map = new maptoolkit.Map({
        container: 'map',
        apiKey: API_KEY,
        style: `https://styles.maptoolkit.net/maptoolkit/maptoolkit.summer.json?api_key=${API_KEY}`,
        center: [11.39085, 47.27574],
        zoom: 12,
        attributionControl: { compact: false }
    });

    map.addControl(new maptoolkit.NavigationControl(), 'top-right');

    map.on('load', async () => {
        const image = await map.loadImage('https://maplibre.org/maplibre-gl-js/docs/assets/custom_marker.png');
        map.addImage('custom-marker', image.data);

        map.addSource('points', {
                type: 'geojson',
                data: {
                    type: 'FeatureCollection',
                    features: [
                        { type: 'Feature', geometry: { type: 'Point', coordinates: [11.39085, 47.27574] }, properties: { title: 'Innsbruck' } },
                        { type: 'Feature', geometry: { type: 'Point', coordinates: [13.0550, 47.8095] }, properties: { title: 'Salzburg' } },
                        { type: 'Feature', geometry: { type: 'Point', coordinates: [16.3738, 48.2082] }, properties: { title: 'Vienna' } }
                    ]
                }
            });

            map.addLayer({
                id: 'symbols',
                type: 'symbol',
                source: 'points',
                layout: {
                    'icon-image': 'custom-marker'
                }
        });
    });
</script>
</body>
</html>

Add an Animated Icon to the Map Add Contour Lines

Add an Icon to the Map

Related Examples