Illustrates the use of a secondary Giro3D instance to display a minimap.

100% © IGN

You can use any number of Giro3D instance in a given page. One common use for multiple instances is to implement a minimap view, where the minimap view contains a single map with a simple, fast to load color layer. You can also synchronize the position of the minimap camera with the main view camera. In this example, the minimap view uses an orthographic camera.

import { Vector3, CubeTextureLoader, Color, OrthographicCamera } from 'three';
import { MapControls } from 'three/examples/jsm/controls/MapControls.js';

import OSM from 'ol/source/OSM.js';

import Coordinates from '@giro3d/giro3d/core/geographic/Coordinates.js';
import Instance from '@giro3d/giro3d/core/Instance.js';
import Extent from '@giro3d/giro3d/core/geographic/Extent.js';
import WmtsSource from '@giro3d/giro3d/sources/WmtsSource.js';
import ColorLayer from '@giro3d/giro3d/core/layer/ColorLayer.js';
import ElevationLayer from '@giro3d/giro3d/core/layer/ElevationLayer.js';
// NOTE: changing the imported name because we use the native `Map` object in this example.
import Giro3dMap from '@giro3d/giro3d/entities/Map.js';
import Inspector from '@giro3d/giro3d/gui/Inspector.js';
import BilFormat from '@giro3d/giro3d/formats/BilFormat.js';

import TiledImageSource from '@giro3d/giro3d/sources/TiledImageSource.js';

// Defines projection that we will use (taken from, Proj4js section)
    '+proj=lcc +lat_0=46.5 +lon_0=3 +lat_1=49 +lat_2=44 +x_0=700000 +y_0=6600000 +ellps=GRS80 +towgs84=0,0,0,0,0,0,0 +units=m +no_defs +type=crs',

const SKY_COLOR = new Color(0xf1e9c6);
const viewerDiv = document.getElementById('viewerDiv');
const mainInstance = new Instance(viewerDiv, {
    crs: 'EPSG:2154',
    renderer: { clearColor: SKY_COLOR },

// create a map
const extent = new Extent('EPSG:2154', -111629.52, 1275028.84, 5976033.79, 7230161.64);
const map = new Giro3dMap('planar', {
    backgroundColor: 'gray',
    hillshading: {
        enabled: true,
        elevationLayersOnly: true,
    discardNoData: true,
    doubleSided: false,

const noDataValue = -1000;

const capabilitiesUrl =

WmtsSource.fromCapabilities(capabilitiesUrl, {
    format: new BilFormat(),
    .then(elevationWmts => {
            new ElevationLayer({
                name: 'wmts_elevation',
                extent: map.extent,
                // We don't need the full resolution of terrain because we are not using any shading
                resolutionFactor: 0.25,
                minmax: { min: 0, max: 5000 },
                noDataOptions: {
                    replaceNoData: false,
                source: elevationWmts,

WmtsSource.fromCapabilities(capabilitiesUrl, {
    .then(orthophotoWmts => {
            new ColorLayer({
                name: 'wmts_orthophotos',
                extent: map.extent,
                source: orthophotoWmts,

// place camera above grenoble, 6456426.459171033, 1706.0108044011636);
// and look at the Bastille
const lookAt = new Vector3(913896, 6459191, 200);;
// Notify Giro3D we've changed the three.js camera position directly

// Creates controls
const controls = new MapControls(, mainInstance.domElement);
controls.enableDamping = true;
controls.dampingFactor = 0.2;

// you need to use these 2 lines each time you change the camera lookAt or position programatically;


// add a skybox background
const cubeTextureLoader = new CubeTextureLoader();
const cubeTexture = cubeTextureLoader.load([

mainInstance.scene.background = cubeTexture;

/////////////////////////////// Minimap configuration //////////////////////////////////////////////

// The minimap is a regular Giro3D instance located in a <div> element in the top right corner
// of the window. Its configuration is very similar to the main view, with some important
// differences related to the camera and navigation.

// Create our minimap instance and attach it to the 'minimap' <div> element.
const minimapDiv = document.getElementById('minimap');

const minimapInstance = new Instance(minimapDiv, {
    crs: 'EPSG:3857', // Contrary to the main view, this minimap uses the Web mercator projection

// Set the minimap camera view width, in meters. This can be changed later when
// the user uses the mouse wheel on to zoom in/out.
const minimapCameraWidth = 2000;
const minimapCamera = new OrthographicCamera(
    -minimapCameraWidth / 2,
    minimapCameraWidth / 2,

// We replace the default perspective camera of the minimap view by
// an orthographic camera, which is much more suitable for this kind of view. = minimapCamera;

// Let's create our minimap map with the same extent than the main map.
const minimap = new Giro3dMap('minimap', {
    extent: map.extent,
    // Since the map is flat (no terrain applied), we can use 1 segment per tile.
    segments: 1,
    backgroundColor: 'black',
    terrain: false, // We can disable terrain because our map will be flat.


// We use an OpenStreetMap color layer for the minimap, because it's readable and fast to display.
const osmLayer = new ColorLayer({
    name: 'osm',
    source: new TiledImageSource({ source: new OSM() }),


function synchronizeCameras() {
    const target =;

    // Since our minimap does not use the same projection as the main view (EPSG:2154),
    // we must convert the camera position into this projection (EPSG:3857).
    const srcProj = mainInstance.referenceCrs;
    const dstProj = minimapInstance.referenceCrs;
    const srcPosition = new Coordinates(srcProj, target.x, target.y);
    const position =;

    // Then we can assign the position to the camera, while still keeping a constant altitude.
    // The minimap camera "altitude" never changes because we are using an orthographic camera.
    // Changing this value will not change the size of objects rendered in this view.

    // Instruct the minimap instance to render the view.

// Synchronize the minimap camera position with the *target* of the main camera
mainInstance.addEventListener('after-camera-update', synchronizeCameras);

function handleMouseWheel(event) {
    const delta = event.wheelDelta;

    const ZOOM_SPEED = 1.5;

    if (delta > 0) {
        minimapCamera.zoom *= ZOOM_SPEED;
    } else if (delta < 0) {
        minimapCamera.zoom /= ZOOM_SPEED;


    // Prevent this event from bubbling and make the page scroll.

// Use the mouse wheel on the minimap view to set the zoom of the minimap camera.
// We use the 'wheel' event (careful not to use the non-standard 'mousewheel' event).
minimapInstance.domElement.addEventListener('wheel', handleMouseWheel);

Inspector.attach(document.getElementById('panelDiv'), minimapInstance, { title: 'minimap' });
<!doctype html>
<html lang="en">
        <meta charset="UTF-8" />
        <meta name="name" content="minimap" />
        <meta name="description" content="Illustrates the use of a secondary Giro3D instance to display a minimap." />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />

        <link rel="icon" href="" />
        <link href="" rel="stylesheet" />
        <script src=""></script>


        <div id="viewerDiv" class="m-0 p-0 w-100 h-100"></div>
        <div id="panelDiv" class="position-absolute top-0 start-0 mh-100 overflow-auto"></div>

        <div class="side-pane-with-status-bar">
                class="card m-1"
                    width: 20rem;
                    height: 14rem;
                    overflow: hidden;
                    border-radius: var(--bs-card-border-radius);

        <script type="module" src="index.js"></script>
            /* activate popovers */
            const popoverTriggerList = []
                // bootstrap is used as script in the template, disable warning about undef
                // eslint-disable-next-line no-undef
                popoverTriggerEl =>
                    new bootstrap.Popover(popoverTriggerEl, {
                        trigger: 'hover',
                        placement: 'left',
                        content: document.getElementById(
                        html: true,
    "name": "minimap",
    "dependencies": {
        "@giro3d/giro3d": "git+"
    "devDependencies": {
        "vite": "^3.2.3"
    "scripts": {
        "start": "vite",
        "build": "vite build"