Load a WMS layer on a Map with various parameters.
This example illustrates how to load a WMS layer on a Giro3D map by using the WmsSource.
/*
* Copyright (c) 2015-2018, IGN France.
* Copyright (c) 2018-2026, Giro3D team.
* SPDX-License-Identifier: MIT
*/
import { Vector3 } from "three";
import { MapControls } from "three/examples/jsm/controls/MapControls.js";
import CoordinateSystem from "@giro3d/giro3d/core/geographic/CoordinateSystem";
import Extent from "@giro3d/giro3d/core/geographic/Extent";
import Instance from "@giro3d/giro3d/core/Instance";
import ColorLayer from "@giro3d/giro3d/core/layer/ColorLayer";
import Map from "@giro3d/giro3d/entities/Map";
import Inspector from "@giro3d/giro3d/gui/Inspector";
import WmsSource from "@giro3d/giro3d/sources/WmsSource";
import { bindDropDown } from "./widgets/bindDropDown";
const epsg3857 = CoordinateSystem.epsg3857;
const epsg4326 = CoordinateSystem.epsg4326;
const epsg2154 = CoordinateSystem.register(
"EPSG:2154",
`PROJCRS["RGF93 v1 / Lambert-93",
BASEGEOGCRS["RGF93 v1",
DATUM["Reseau Geodesique Francais 1993 v1",
ELLIPSOID["GRS 1980",6378137,298.257222101,
LENGTHUNIT["metre",1]]],
PRIMEM["Greenwich",0,
ANGLEUNIT["degree",0.0174532925199433]],
ID["EPSG",4171]],
CONVERSION["Lambert-93",
METHOD["Lambert Conic Conformal (2SP)",
ID["EPSG",9802]],
PARAMETER["Latitude of false origin",46.5,
ANGLEUNIT["degree",0.0174532925199433],
ID["EPSG",8821]],
PARAMETER["Longitude of false origin",3,
ANGLEUNIT["degree",0.0174532925199433],
ID["EPSG",8822]],
PARAMETER["Latitude of 1st standard parallel",49,
ANGLEUNIT["degree",0.0174532925199433],
ID["EPSG",8823]],
PARAMETER["Latitude of 2nd standard parallel",44,
ANGLEUNIT["degree",0.0174532925199433],
ID["EPSG",8824]],
PARAMETER["Easting at false origin",700000,
LENGTHUNIT["metre",1],
ID["EPSG",8826]],
PARAMETER["Northing at false origin",6600000,
LENGTHUNIT["metre",1],
ID["EPSG",8827]]],
CS[Cartesian,2],
AXIS["easting (X)",east,
ORDER[1],
LENGTHUNIT["metre",1]],
AXIS["northing (Y)",north,
ORDER[2],
LENGTHUNIT["metre",1]],
USAGE[
SCOPE["Engineering survey, topographic mapping."],
AREA["France - onshore and offshore, mainland and Corsica (France métropolitaine including Corsica)."],
BBOX[41.15,-9.86,51.56,10.38]],
ID["EPSG",2154]]`,
);
const instance = new Instance({
crs: epsg3857,
target: "view",
});
const extent = Extent.fromCenterAndSize(
CoordinateSystem.epsg3857,
{ x: 260000, y: 6251379 },
32000,
32000,
);
const map = new Map({
extent,
});
instance.add(map).then(() => {
const pov = new Vector3(260304, 6250939, 17182);
// Note, the +1 ensures that the camera is not perfectly vertical, which causes gimbal locks.
const lookAt = new Vector3(pov.x, pov.y + 1, 0);
instance.view.camera.position.copy(pov);
instance.view.camera.lookAt(lookAt);
const controls = new MapControls(instance.view.camera, instance.domElement);
controls.target.copy(lookAt);
instance.view.setControls(controls);
// This layer has the same coordinate system as our scene,
// meaning that no reprojection will be done by Giro3D, as the
// reprojection is done by the WMS server. This provides the best visual quality.
const wmsLayerInEpsg3857 = new ColorLayer({
name: "WMS in EPSG:3857",
source: new WmsSource({
url: "https://data.geopf.fr/wms-r/wms",
layer: "GEOGRAPHICALGRIDSYSTEMS.PLANIGNV2",
projection: "EPSG:3857",
}),
});
// This layer has a different coordinate system than our scene,
// meaning that a reprojection must be done by Giro3D, with a slight
// loss of visual quality.
const wmsLayerInEpsg2154 = new ColorLayer({
name: "WMS in EPSG:2154",
source: new WmsSource({
url: "https://data.geopf.fr/wms-r/wms",
layer: "GEOGRAPHICALGRIDSYSTEMS.PLANIGNV2",
projection: "EPSG:2154",
}),
});
// Finally, this layer also has a different coordinate system,
// but expressed in geographic coordinates rather than being a
// projected coordinate system. This is used to ensure that the
// WMS requests handle the axis ordering properly.
const wmsLayerInEpsg4326 = new ColorLayer({
name: "WMS in EPSG:4326",
source: new WmsSource({
url: "https://data.geopf.fr/wms-r/wms",
layer: "GEOGRAPHICALGRIDSYSTEMS.PLANIGNV2",
projection: "EPSG:4326",
}),
});
map.addLayer(wmsLayerInEpsg3857);
map.addLayer(wmsLayerInEpsg2154);
map.addLayer(wmsLayerInEpsg4326);
wmsLayerInEpsg3857.visible = true;
wmsLayerInEpsg2154.visible = false;
wmsLayerInEpsg4326.visible = false;
bindDropDown("source", (source) => {
wmsLayerInEpsg2154.visible = false;
wmsLayerInEpsg3857.visible = false;
wmsLayerInEpsg4326.visible = false;
switch (source) {
case "2154":
wmsLayerInEpsg2154.visible = true;
break;
case "3857":
wmsLayerInEpsg3857.visible = true;
break;
case "4326":
wmsLayerInEpsg4326.visible = true;
break;
}
instance.notifyChange(map);
});
});
Inspector.attach("inspector", instance);
<!doctype html>
<html lang="en">
<head>
<title>WMS</title>
<meta charset="UTF-8" />
<meta name="name" content="wms" />
<meta
name="description"
content="Load a WMS layer on a Map with various parameters."
/>
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="icon" href="https://giro3d.org/images/favicon.svg" />
<link
href="https://giro3d.org/assets/bootstrap-custom.css"
rel="stylesheet"
/>
<script src="https://giro3d.org/assets/bootstrap.bundle.min.js"></script>
<link
rel="stylesheet"
type="text/css"
href="https://giro3d.org/latest/examples/css/example.css"
/>
</head>
<body>
<div id="view" class="m-0 p-0 w-100 h-100"></div>
<div
id="inspector"
class="position-absolute top-0 start-0 mh-100 overflow-auto"
></div>
<div class="side-pane-with-status-bar">
<div class="card">
<div class="card-header">Parameters</div>
<div class="card-body">
<fieldset id="options">
<!-- Layer selector -->
<div class="input-group mb-2">
<label class="input-group-text" for="source"
>WMS coordinate system</label
>
<select class="form-select" id="source" autocomplete="off">
<option value="3857" selected>
EPSG:3857 (same as Giro3D scene)
</option>
<option value="2154">EPSG:2154</option>
<option value="4326">EPSG:4326</option>
</select>
</div>
</fieldset>
</div>
</div>
</div>
<script type="module" src="index.js"></script>
<script>
/* activate popovers */
const popoverTriggerList = [].slice.call(
document.querySelectorAll('[data-bs-toggle="popover"]'),
);
popoverTriggerList.map(
// 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(
popoverTriggerEl.getAttribute("data-bs-content"),
).innerHTML,
html: true,
}),
);
</script>
</body>
</html>
{
"name": "wms",
"dependencies": {
"@giro3d/giro3d": "2.0.0"
},
"devDependencies": {
"vite": "^3.2.3"
},
"scripts": {
"start": "vite",
"build": "vite build"
}
}
import { defineConfig } from "vite";
export default defineConfig({
build: {
target: 'esnext',
},
optimizeDeps: {
esbuildOptions: {
target: 'esnext',
},
},
})