Map External Layer
Add your own layers on top of Woosmap Map.
Example
Map External Layer
let map: woosmap.map.Map;
let styleSelect: HTMLSelectElement;
let layerSelect: HTMLSelectElement;
let opacityInput: HTMLInputElement;
let opacityDisplay: HTMLElement;
const centerLatLng: woosmap.map.LatLngLiteral = {
lat: 45.126643,
lng: 6.073999,
};
function initMap() {
map = new window.woosmap.map.Map(
document.getElementById("map") as HTMLElement,
{
zoom: 15.64,
center: centerLatLng,
mapTypeControl: true,
styles: STYLE_PRESETS.lightgrey,
},
);
styleSelect = document.getElementById(
"woosmap-style-select",
) as HTMLSelectElement;
layerSelect = document.getElementById(
"layer-provider-select",
) as HTMLSelectElement;
opacityInput = document.getElementById(
"opacity-value-input",
) as HTMLInputElement;
opacityDisplay = document.getElementById(
"opacity-value-display",
) as HTMLElement;
updateOpacityDisplay();
applyLayer(layerSelect.value, readOpacity());
styleSelect.addEventListener("change", onStyleChange);
layerSelect.addEventListener("change", onLayerChange);
opacityInput.addEventListener("input", updateOpacityDisplay);
opacityInput.addEventListener("change", onOpacityChange);
}
function updateOpacityDisplay() {
const opacity = parseFloat(opacityInput.value);
opacityDisplay.textContent = `${Math.round(opacity * 100)}%`;
}
function readOpacity(): number {
const opacity = parseFloat(opacityInput.value);
return isNaN(opacity) ? 1 : opacity;
}
function onStyleChange() {
applyStyle(styleSelect.value);
// Recreating the map wipes overlays — reapply the current layer.
applyLayer(layerSelect.value, readOpacity());
}
function onLayerChange() {
const view = LAYER_VIEWS[layerSelect.value];
if (view) {
map.flyTo(view);
}
applyLayer(layerSelect.value, readOpacity());
}
function onOpacityChange() {
applyLayer(layerSelect.value, readOpacity());
}
function applyStyle(name: string) {
const styles = STYLE_PRESETS[name] ?? [];
map = new window.woosmap.map.Map(
document.getElementById("map") as HTMLElement,
{
zoom: map.getZoom(),
center: map.getCenter(),
mapTypeControl: true,
styles,
},
);
}
function applyLayer(provider: string, opacity: number) {
map.overlayMapTypes.clear();
const config = LAYER_CONFIGS[provider];
if (!config) {
return;
}
map.overlayMapTypes.insertAt(
0,
new woosmap.map.ImageMapType({
...config,
tileSize: new woosmap.map.Size(256, 256),
opacity,
}),
);
}
const nightStyles = [
{
elementType: "geometry",
stylers: [{ color: "#242f3e" }],
},
{
elementType: "labels.text.stroke",
stylers: [{ color: "#242f3e" }],
},
{
elementType: "labels.text.fill",
stylers: [{ color: "#746855" }],
},
{
featureType: "administrative.locality",
elementType: "labels.text.fill",
stylers: [{ color: "#d59563" }],
},
{
featureType: "poi",
elementType: "labels.text.fill",
stylers: [{ color: "#d59563" }],
},
{
featureType: "poi.park",
elementType: "geometry",
stylers: [{ color: "#326030" }],
},
{
featureType: "poi.park",
elementType: "labels.text.fill",
stylers: [{ color: "#6b9a76" }],
},
{
featureType: "road",
elementType: "geometry",
stylers: [{ color: "#38414e" }],
},
{
featureType: "road",
elementType: "geometry.stroke",
stylers: [{ color: "#212a37" }],
},
{
featureType: "road",
elementType: "labels.text.fill",
stylers: [{ color: "#9ca5b3" }],
},
{
featureType: "road.highway",
elementType: "geometry",
stylers: [{ color: "#746855" }],
},
{
featureType: "road.highway",
elementType: "geometry.stroke",
stylers: [{ color: "#1f2835" }],
},
{
featureType: "road.highway",
elementType: "labels.text.fill",
stylers: [{ color: "#C38B5F" }],
},
{
featureType: "transit",
elementType: "geometry",
stylers: [{ color: "#2f3948" }],
},
{
featureType: "transit.station",
elementType: "labels.text.fill",
stylers: [{ color: "#d59563" }],
},
{
featureType: "water",
elementType: "geometry",
stylers: [{ color: "#17263c" }],
},
{
featureType: "water",
elementType: "labels.text.fill",
stylers: [{ color: "#515c6d" }],
},
{
featureType: "water",
elementType: "labels.text.stroke",
stylers: [{ color: "#17263c" }],
},
]
const retroStyles = [
{
elementType: "geometry",
stylers: [{ color: "#ebe3cd" }],
},
{
elementType: "labels.text.fill",
stylers: [{ color: "#523735" }],
},
{
elementType: "labels.text.stroke",
stylers: [{ color: "#f5f1e6" }],
},
{
featureType: "administrative",
elementType: "geometry.stroke",
stylers: [{ color: "#c9b2a6" }],
},
{
featureType: "administrative.land_parcel",
elementType: "geometry.stroke",
stylers: [{ color: "#dcd2be" }],
},
{
featureType: "administrative.land_parcel",
elementType: "labels.text.fill",
stylers: [{ color: "#ae9e90" }],
},
{
featureType: "landscape.natural",
elementType: "geometry",
stylers: [{ color: "#dfd2ae" }],
},
{
featureType: "poi",
elementType: "geometry",
stylers: [{ color: "#dfd2ae" }],
},
{
featureType: "poi",
elementType: "labels.text.fill",
stylers: [{ color: "#93817c" }],
},
{
featureType: "poi.park",
elementType: "geometry",
stylers: [{ color: "#738E00" }],
},
{
featureType: "poi.park",
elementType: "labels.text.fill",
stylers: [{ color: "#447530" }],
},
{
featureType: "road",
elementType: "geometry",
stylers: [{ color: "#f5f1e6" }],
},
{
featureType: "road.arterial",
elementType: "geometry",
stylers: [{ color: "#fdfcf8" }],
},
{
featureType: "road.highway",
elementType: "geometry",
stylers: [{ color: "#f8c967" }],
},
{
featureType: "road.highway",
elementType: "geometry.stroke",
stylers: [{ color: "#e9bc62" }],
},
{
featureType: "road.highway.controlled_access",
elementType: "geometry",
stylers: [{ color: "#e98d58" }],
},
{
featureType: "road.highway.controlled_access",
elementType: "geometry.stroke",
stylers: [{ color: "#db8555" }],
},
{
featureType: "road.local",
elementType: "labels.text.fill",
stylers: [{ color: "#806b63" }],
},
{
featureType: "road.local",
elementType: "geometry.fill",
stylers: [{ color: "#F5F1E6" }],
},
{
featureType: "transit.line",
elementType: "geometry",
stylers: [{ color: "#dfd2ae" }],
},
{
featureType: "transit.line",
elementType: "labels.text.fill",
stylers: [{ color: "#8f7d77" }],
},
{
featureType: "transit.line",
elementType: "labels.text.stroke",
stylers: [{ color: "#ebe3cd" }],
},
{
featureType: "transit.station",
elementType: "geometry",
stylers: [{ color: "#dfd2ae" }],
},
{
featureType: "water",
elementType: "geometry.fill",
stylers: [{ color: "#b9d3c2" }],
},
{
featureType: "water",
elementType: "labels.text.fill",
stylers: [{ color: "#92998d" }],
},
]
const lightgreyStyles = [
{
elementType: "geometry",
stylers: [{ color: "#f6f6f6" }],
},
{
elementType: "labels.icon",
stylers: [{ visibility: "off" }],
},
{
elementType: "labels.text.fill",
stylers: [{ color: "#616161" }],
},
{
elementType: "labels.text.stroke",
stylers: [{ color: "#f5f5f5" }],
},
{
featureType: "administrative.land_parcel",
elementType: "labels.text.fill",
stylers: [{ color: "#bdbdbd" }],
},
{
featureType: "road",
elementType: "geometry",
stylers: [{ color: "#ffffff" }],
},
{
featureType: "road.arterial",
elementType: "labels.text.fill",
stylers: [{ color: "#757575" }],
},
{
featureType: "road.highway",
elementType: "geometry",
stylers: [{ color: "#dadada" }],
},
{
featureType: "road.highway",
elementType: "labels.text.fill",
stylers: [{ color: "#616161" }],
},
{
featureType: "road.local",
elementType: "labels.text.fill",
stylers: [{ color: "#9e9e9e" }],
},
{
featureType: "transit.line",
elementType: "geometry",
stylers: [{ color: "#e5e5e5" }],
},
{
featureType: "transit.station",
elementType: "geometry",
stylers: [{ color: "#eeeeee" }],
},
{
featureType: "water",
elementType: "geometry",
stylers: [{ color: "#c9c9c9" }],
},
{
featureType: "water",
elementType: "labels.text.fill",
stylers: [{ color: "#9e9e9e" }],
},
]
const STYLE_PRESETS: Record<string, woosmap.map.MapStyleSpec[]> = {
retro: retroStyles,
lightgrey: lightgreyStyles,
night: nightStyles,
};
const LAYER_CONFIGS: Record<string, { url: string; name: string; minZoom?: number; maxZoom?: number }> = {
pistes: {
url: "https://tiles.opensnowmap.org/pistes/{z}/{x}/{y}.png",
name: "OpenSnowMap",
maxZoom: 19,
},
temperature: {
url: `https://tile.openweathermap.org/map/temp_new/{z}/{x}/{y}?appid=${openWeatherMapKey}`,
name: "Temperature",
maxZoom: 19,
},
precipitation: {
url: `https://tile.openweathermap.org/map/precipitation_new/{z}/{x}/{y}?appid=${openWeatherMapKey}`,
name: "Precipitation",
maxZoom: 19,
},
};
const US_VIEW = {
center: { lat: 39.8283, lng: -98.5795 },
zoom: 4,
};
const LAYER_VIEWS: Record<string, { center: { lat: number; lng: number }; zoom: number }> = {
pistes: { center: { lat: 45.126643, lng: 6.073999 }, zoom: 15.64 },
temperature: US_VIEW,
precipitation: US_VIEW,
};
declare global {
interface Window {
initMap: () => void;
}
}
window.initMap = initMap;
let map;
let styleSelect;
let layerSelect;
let opacityInput;
let opacityDisplay;
const centerLatLng = {
lat: 45.126643,
lng: 6.073999,
};
function initMap() {
map = new window.woosmap.map.Map(document.getElementById("map"), {
zoom: 15.64,
center: centerLatLng,
mapTypeControl: true,
styles: STYLE_PRESETS.lightgrey,
});
styleSelect = document.getElementById("woosmap-style-select");
layerSelect = document.getElementById("layer-provider-select");
opacityInput = document.getElementById("opacity-value-input");
opacityDisplay = document.getElementById("opacity-value-display");
updateOpacityDisplay();
applyLayer(layerSelect.value, readOpacity());
styleSelect.addEventListener("change", onStyleChange);
layerSelect.addEventListener("change", onLayerChange);
opacityInput.addEventListener("input", updateOpacityDisplay);
opacityInput.addEventListener("change", onOpacityChange);
}
function updateOpacityDisplay() {
const opacity = parseFloat(opacityInput.value);
opacityDisplay.textContent = `${Math.round(opacity * 100)}%`;
}
function readOpacity() {
const opacity = parseFloat(opacityInput.value);
return isNaN(opacity) ? 1 : opacity;
}
function onStyleChange() {
applyStyle(styleSelect.value);
// Recreating the map wipes overlays — reapply the current layer.
applyLayer(layerSelect.value, readOpacity());
}
function onLayerChange() {
const view = LAYER_VIEWS[layerSelect.value];
if (view) {
map.flyTo(view);
}
applyLayer(layerSelect.value, readOpacity());
}
function onOpacityChange() {
applyLayer(layerSelect.value, readOpacity());
}
function applyStyle(name) {
const styles = STYLE_PRESETS[name] ?? [];
map = new window.woosmap.map.Map(document.getElementById("map"), {
zoom: map.getZoom(),
center: map.getCenter(),
mapTypeControl: true,
styles,
});
}
function applyLayer(provider, opacity) {
map.overlayMapTypes.clear();
const config = LAYER_CONFIGS[provider];
if (!config) {
return;
}
map.overlayMapTypes.insertAt(
0,
new woosmap.map.ImageMapType({
...config,
tileSize: new woosmap.map.Size(256, 256),
opacity,
}),
);
}
const nightStyles = [
{
elementType: "geometry",
stylers: [{ color: "#242f3e" }],
},
{
elementType: "labels.text.stroke",
stylers: [{ color: "#242f3e" }],
},
{
elementType: "labels.text.fill",
stylers: [{ color: "#746855" }],
},
{
featureType: "administrative.locality",
elementType: "labels.text.fill",
stylers: [{ color: "#d59563" }],
},
{
featureType: "poi",
elementType: "labels.text.fill",
stylers: [{ color: "#d59563" }],
},
{
featureType: "poi.park",
elementType: "geometry",
stylers: [{ color: "#326030" }],
},
{
featureType: "poi.park",
elementType: "labels.text.fill",
stylers: [{ color: "#6b9a76" }],
},
{
featureType: "road",
elementType: "geometry",
stylers: [{ color: "#38414e" }],
},
{
featureType: "road",
elementType: "geometry.stroke",
stylers: [{ color: "#212a37" }],
},
{
featureType: "road",
elementType: "labels.text.fill",
stylers: [{ color: "#9ca5b3" }],
},
{
featureType: "road.highway",
elementType: "geometry",
stylers: [{ color: "#746855" }],
},
{
featureType: "road.highway",
elementType: "geometry.stroke",
stylers: [{ color: "#1f2835" }],
},
{
featureType: "road.highway",
elementType: "labels.text.fill",
stylers: [{ color: "#C38B5F" }],
},
{
featureType: "transit",
elementType: "geometry",
stylers: [{ color: "#2f3948" }],
},
{
featureType: "transit.station",
elementType: "labels.text.fill",
stylers: [{ color: "#d59563" }],
},
{
featureType: "water",
elementType: "geometry",
stylers: [{ color: "#17263c" }],
},
{
featureType: "water",
elementType: "labels.text.fill",
stylers: [{ color: "#515c6d" }],
},
{
featureType: "water",
elementType: "labels.text.stroke",
stylers: [{ color: "#17263c" }],
},
];
const retroStyles = [
{
elementType: "geometry",
stylers: [{ color: "#ebe3cd" }],
},
{
elementType: "labels.text.fill",
stylers: [{ color: "#523735" }],
},
{
elementType: "labels.text.stroke",
stylers: [{ color: "#f5f1e6" }],
},
{
featureType: "administrative",
elementType: "geometry.stroke",
stylers: [{ color: "#c9b2a6" }],
},
{
featureType: "administrative.land_parcel",
elementType: "geometry.stroke",
stylers: [{ color: "#dcd2be" }],
},
{
featureType: "administrative.land_parcel",
elementType: "labels.text.fill",
stylers: [{ color: "#ae9e90" }],
},
{
featureType: "landscape.natural",
elementType: "geometry",
stylers: [{ color: "#dfd2ae" }],
},
{
featureType: "poi",
elementType: "geometry",
stylers: [{ color: "#dfd2ae" }],
},
{
featureType: "poi",
elementType: "labels.text.fill",
stylers: [{ color: "#93817c" }],
},
{
featureType: "poi.park",
elementType: "geometry",
stylers: [{ color: "#738E00" }],
},
{
featureType: "poi.park",
elementType: "labels.text.fill",
stylers: [{ color: "#447530" }],
},
{
featureType: "road",
elementType: "geometry",
stylers: [{ color: "#f5f1e6" }],
},
{
featureType: "road.arterial",
elementType: "geometry",
stylers: [{ color: "#fdfcf8" }],
},
{
featureType: "road.highway",
elementType: "geometry",
stylers: [{ color: "#f8c967" }],
},
{
featureType: "road.highway",
elementType: "geometry.stroke",
stylers: [{ color: "#e9bc62" }],
},
{
featureType: "road.highway.controlled_access",
elementType: "geometry",
stylers: [{ color: "#e98d58" }],
},
{
featureType: "road.highway.controlled_access",
elementType: "geometry.stroke",
stylers: [{ color: "#db8555" }],
},
{
featureType: "road.local",
elementType: "labels.text.fill",
stylers: [{ color: "#806b63" }],
},
{
featureType: "road.local",
elementType: "geometry.fill",
stylers: [{ color: "#F5F1E6" }],
},
{
featureType: "transit.line",
elementType: "geometry",
stylers: [{ color: "#dfd2ae" }],
},
{
featureType: "transit.line",
elementType: "labels.text.fill",
stylers: [{ color: "#8f7d77" }],
},
{
featureType: "transit.line",
elementType: "labels.text.stroke",
stylers: [{ color: "#ebe3cd" }],
},
{
featureType: "transit.station",
elementType: "geometry",
stylers: [{ color: "#dfd2ae" }],
},
{
featureType: "water",
elementType: "geometry.fill",
stylers: [{ color: "#b9d3c2" }],
},
{
featureType: "water",
elementType: "labels.text.fill",
stylers: [{ color: "#92998d" }],
},
];
const lightgreyStyles = [
{
elementType: "geometry",
stylers: [{ color: "#f6f6f6" }],
},
{
elementType: "labels.icon",
stylers: [{ visibility: "off" }],
},
{
elementType: "labels.text.fill",
stylers: [{ color: "#616161" }],
},
{
elementType: "labels.text.stroke",
stylers: [{ color: "#f5f5f5" }],
},
{
featureType: "administrative.land_parcel",
elementType: "labels.text.fill",
stylers: [{ color: "#bdbdbd" }],
},
{
featureType: "road",
elementType: "geometry",
stylers: [{ color: "#ffffff" }],
},
{
featureType: "road.arterial",
elementType: "labels.text.fill",
stylers: [{ color: "#757575" }],
},
{
featureType: "road.highway",
elementType: "geometry",
stylers: [{ color: "#dadada" }],
},
{
featureType: "road.highway",
elementType: "labels.text.fill",
stylers: [{ color: "#616161" }],
},
{
featureType: "road.local",
elementType: "labels.text.fill",
stylers: [{ color: "#9e9e9e" }],
},
{
featureType: "transit.line",
elementType: "geometry",
stylers: [{ color: "#e5e5e5" }],
},
{
featureType: "transit.station",
elementType: "geometry",
stylers: [{ color: "#eeeeee" }],
},
{
featureType: "water",
elementType: "geometry",
stylers: [{ color: "#c9c9c9" }],
},
{
featureType: "water",
elementType: "labels.text.fill",
stylers: [{ color: "#9e9e9e" }],
},
];
const STYLE_PRESETS = {
retro: retroStyles,
lightgrey: lightgreyStyles,
night: nightStyles,
};
const LAYER_CONFIGS = {
pistes: {
url: "https://tiles.opensnowmap.org/pistes/{z}/{x}/{y}.png",
name: "OpenSnowMap",
maxZoom: 19,
},
temperature: {
url: `https://tile.openweathermap.org/map/temp_new/{z}/{x}/{y}?appid=${openWeatherMapKey}`,
name: "Temperature",
maxZoom: 19,
},
precipitation: {
url: `https://tile.openweathermap.org/map/precipitation_new/{z}/{x}/{y}?appid=${openWeatherMapKey}`,
name: "Precipitation",
maxZoom: 19,
},
};
const US_VIEW = {
center: { lat: 39.8283, lng: -98.5795 },
zoom: 4,
};
const LAYER_VIEWS = {
pistes: { center: { lat: 45.126643, lng: 6.073999 }, zoom: 15.64 },
temperature: US_VIEW,
precipitation: US_VIEW,
};
window.initMap = initMap;
/*
* Always set the map height explicitly to define the size of the div element
* that contains the map.
*/
#map {
height: 100%;
}
/*
* Optional: Makes the sample page fill the window.
*/
html,
body {
height: 100%;
margin: 0;
padding: 0;
font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Helvetica Neue, Arial, Noto Sans, sans-serif, Apple Color Emoji, Segoe UI Emoji, Segoe UI Symbol, Noto Color Emoji;
}
#app {
height: 100%;
}
#selector {
position: absolute;
top: 0;
left: 0;
background-color: #fff;
border-radius: 3px;
box-shadow: 0 0 0 2px rgba(0, 0, 0, 0.1);
margin: 10px;
padding: 5px;
overflow: hidden;
z-index: 1;
width: 220px;
padding: 12px;
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
}
.panel-title {
margin: 0 0 10px;
font-size: 0.75rem;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.05em;
color: #5f6368;
}
.select-container {
display: flex;
flex-direction: column;
margin-bottom: 10px;
}
.select-container:last-child {
margin-bottom: 0;
}
.select-container .label {
font-size: 0.8125rem;
font-weight: 500;
color: #202124;
margin-bottom: 4px;
}
.select-container select {
width: 100%;
height: 30px;
box-sizing: border-box;
border: 1px solid #dadce0;
border-radius: 4px;
padding: 0 8px;
font-size: 0.8125rem;
background: #fff;
cursor: pointer;
}
.select-container select:hover {
border-color: #b8bcc1;
}
.select-container select:focus {
outline: none;
border-color: #1a73e8;
}
.opacity-control {
display: flex;
align-items: center;
gap: 8px;
}
.opacity-control input[type=range] {
flex: 1;
accent-color: #1a73e8;
cursor: pointer;
}
#opacity-value-display {
font-variant-numeric: tabular-nums;
font-size: 0.8125rem;
color: #5f6368;
min-width: 36px;
text-align: right;
}
<html>
<head>
<title>Map External Layer</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta charset="utf-8" />
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
</head>
<body>
<div id="app">
<div id="selector">
<h3 class="panel-title">Map options</h3>
<label class="select-container">
<span class="label">Map style</span>
<select id="woosmap-style-select">
<option value="default">Default</option>
<option value="lightgrey" selected>Light Grey</option>
<option value="night">Transit By Night</option>
<option value="retro">Retro</option>
</select>
</label>
<label class="select-container">
<span class="label">Overlay layer</span>
<select id="layer-provider-select">
<option value="pistes">OpenSnowMap ski runs</option>
<option value="temperature">OpenWeather temperature</option>
<option value="precipitation">OpenWeather precipitation</option>
</select>
</label>
<label class="select-container">
<span class="label">Opacity</span>
<div class="opacity-control">
<input
id="opacity-value-input"
type="range"
value="1"
step="0.05"
min="0"
max="1"
/>
<span id="opacity-value-display">100%</span>
</div>
</label>
</div>
<div id="map"></div>
</div>
<script
src="https://sdk.woosmap.com/map/map.js?key=woos-48c80350-88aa-333e-835a-07f4b658a9a4&callback=initMap"
defer
></script>
</body>
</html>
Running the Sample Locally
Before you can run this sample on your local machine, you need to have Git and Node.js installed. If they’re not already installed, follow these instructions to get them set up.
Once you have Git and Node.js installed, you can run the sample by following these steps:
-
Clone the repository and navigate to the directory of the sample.
-
Install the necessary dependencies.
-
Start running the sample.
Here are the commands you can use in your terminal to do this:
git clone -b sample/map-external-layer https://github.com/woosmap/js-samples.git
cd js-samples
npm i
npm start
You can experiment with other samples by switching to any branch that starts with the pattern sample/SAMPLE_NAME.
git checkout sample/SAMPLE_NAME
npm i
npm start