Skip to content
Change a Map's Language

Change a Map's Language

Switch map label language by updating the text-field expression on symbol layers.

const API_KEY = 'toursprung';

    const map = new maptoolkit.Map({
        container: 'map',
        style: `https://static.maptoolkit.net/styles/toursprung/terrain.json?api_key=${API_KEY}`,
        center: [10.0, 51.0],
        zoom: 4,
        attributionControl: { compact: false }
    });

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

    function setLanguage(field) {
        if (!map.isStyleLoaded()) return;
        const layers = map.getStyle().layers;
        for (const layer of layers) {
            if (layer.type !== 'symbol') continue;
            if (!layer.layout || !layer.layout['text-field']) continue;
            const expr = field === 'name'
                ? ['get', 'name']
                : ['coalesce', ['get', field], ['get', 'name']];
            map.setLayoutProperty(layer.id, 'text-field', expr);
        }
    }
<!DOCTYPE html>
<html lang="en">
<head>
    <title>Change a Map's Language – Maptoolkit Maps JS</title>
    <meta property="og:description" content="Switch map label language by updating the text-field expression on symbol layers." />
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <script src="https://unpkg.com/@maptoolkit/maps@11.0.0-beta.2/dist/maptoolkit.js"></script>
    <link rel="stylesheet" href="https://unpkg.com/@maptoolkit/maps@11.0.0-beta.2/dist/maptoolkit.css" />
    <style>
        html, body { width: 100%; height: 100%; margin: 0; padding: 0; }
        #map { width: 100%; height: 100%; }
        #controls {
            position: absolute;
            top: 10px;
            left: 10px;
            display: flex;
            gap: 6px;
            flex-wrap: wrap;
            max-width: 320px;
        }
        #controls button {
            padding: 8px 14px;
            background: #3887be;
            color: white;
            border: none;
            border-radius: 3px;
            cursor: pointer;
            font-size: 13px;
        }
        #controls button:hover { background: #2c6d9e; }
    </style>
</head>
<body>
<div id="map"></div>
<div id="controls">
    <button onclick="setLanguage('name')">Local</button>
    <button onclick="setLanguage('name_de')">DE</button>
    <button onclick="setLanguage('name_en')">EN</button>
    <button onclick="setLanguage('name_fr')">FR</button>
    <button onclick="setLanguage('name_it')">IT</button>
    <button onclick="setLanguage('name_es')">ES</button>
    <button onclick="setLanguage('name_zh')">中文</button>
</div>
<script>
    const API_KEY = 'toursprung';

    const map = new maptoolkit.Map({
        container: 'map',
        style: `https://static.maptoolkit.net/styles/toursprung/terrain.json?api_key=${API_KEY}`,
        center: [10.0, 51.0],
        zoom: 4,
        attributionControl: { compact: false }
    });

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

    function setLanguage(field) {
        if (!map.isStyleLoaded()) return;
        const layers = map.getStyle().layers;
        for (const layer of layers) {
            if (layer.type !== 'symbol') continue;
            if (!layer.layout || !layer.layout['text-field']) continue;
            const expr = field === 'name'
                ? ['get', 'name']
                : ['coalesce', ['get', field], ['get', 'name']];
            map.setLayoutProperty(layer.id, 'text-field', expr);
        }
    }
</script>
</body>
</html>