3D Terrain

Maptoolkit Maps JS supports true 3D terrain rendering by combining a raster-dem elevation source with the map’s terrain option. This example shows how to enable 3D terrain with pitch and a sky layer to create a realistic mountain landscape view. Use this technique to build hiking apps, route planners, or any visualization where actual elevation matters more than a flat hillshade.

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}`,
        zoom: 12,
        center: [11.39085, 47.27574],
        pitch: 70,
        maxZoom: 18,
        maxPitch: 85,
        attributionControl: { compact: false }
    });

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

    map.on('load', () => {
        map.addSource('terrain-rgb', {
            type: 'raster-dem',
            tiles: [`https://vtc-cdn.maptoolkit.net/terrain/{z}/{x}/{y}.webp?api_key=${API_KEY}`],
            tileSize: 256,
            minzoom: 5,
            maxzoom: 12,
            encoding: 'terrarium'
        });

        map.setTerrain({ source: 'terrain-rgb', exaggeration: 1.0 });

        // Force one render after the DEM source loads so terrain shows on initial load
        map.once('idle', () => map.triggerRepaint());

        map.setSky({
            'sky-color': '#199EF3',
            'sky-horizon-blend': 0.5,
            'horizon-color': '#ffffff',
            'horizon-fog-blend': 0.5,
            'fog-color': '#0000ff',
            'fog-ground-blend': 0.9
        });
    });

<!DOCTYPE html>
<html lang="en">
<head>
    <title>3D Terrain - Maptoolkit Maps JS</title>
    <meta property="og:description" content="Go beyond hillshade and show elevation in actual 3D." />
    <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}`,
        zoom: 12,
        center: [11.39085, 47.27574],
        pitch: 70,
        maxZoom: 18,
        maxPitch: 85,
        attributionControl: { compact: false }
    });

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

    map.on('load', () => {
        map.addSource('terrain-rgb', {
            type: 'raster-dem',
            tiles: [`https://vtc-cdn.maptoolkit.net/terrain/{z}/{x}/{y}.webp?api_key=${API_KEY}`],
            tileSize: 256,
            minzoom: 5,
            maxzoom: 12,
            encoding: 'terrarium'
        });

        map.setTerrain({ source: 'terrain-rgb', exaggeration: 1.0 });

        // Force one render after the DEM source loads so terrain shows on initial load
        map.once('idle', () => map.triggerRepaint());

        map.setSky({
            'sky-color': '#199EF3',
            'sky-horizon-blend': 0.5,
            'horizon-color': '#ffffff',
            'horizon-fog-blend': 0.5,
            'fog-color': '#0000ff',
            'fog-ground-blend': 0.9
        });
    });
</script>
</body>
</html>

Use the prompt below with any LLM to get the same result. Make sure the Maptoolkit MCP server is connected first — check out AI Integration & MCP to get started.

Use the Maptoolkit Connector. Create an interactive map with zoom level 12, centered around [11.39085, 47.27574], with pitch 70. Enable 3D terrain with a sky effect.

Add 3D Tiles Using three.js

3D Terrain

Related Examples