@alcalin/leaflet-tilelayer-wmts
Advanced tools
A modern, lightweight Leaflet plugin for displaying WMTS tile layers.
A modern, lightweight Leaflet WMTS TileLayer plugin.
SERVICE, REQUEST, VERSION, …)extraParams, baseQuery, crossOrigin, error hooksnpm i @alcalin/leaflet-tilelayer-wmts leaflet
Peer dep: you must also install
leafletin your app.
import * as L from "leaflet";
import { wmts } from "@alcalin/leaflet-tilelayer-wmts";
const map = L.map("map").setView([40.7128, -74.0060], 5);
L.tileLayer("https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png", {
maxZoom: 19
}).addTo(map);
// GoogleMapsCompatible (WebMercator) example
const layer = wmts("https://basemap.nationalmap.gov/arcgis/rest/services/USGSTopo/MapServer/WMTS/tile/1.0.0/", {
layer: "USGSTopo",
style: "default",
tileMatrixSet: "default028mm",
format: "image/png",
googleMapsCompatible: true,
crossOrigin: true
});
layer.addTo(map);
A prebuilt UMD bundle is available under dist/.
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>WMTS Plugin Demo</title>
<link rel="stylesheet" href="https://unpkg.com/leaflet@1.9.4/dist/leaflet.css" />
</head>
<body>
<div id="map" style="height:100vh"></div>
<script src="https://unpkg.com/leaflet@1.9.4/dist/leaflet.js"></script>
<script src="./dist/leaflet.tilelayer.wmts.min.js"></script>
<script>
const map = L.map("map").setView([40.7, -74], 5);
L.tileLayer("https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png", {
maxZoom: 19
}).addTo(map);
const layer = LTileLayerWMTS.wmts(
"https://basemap.nationalmap.gov/arcgis/rest/services/USGSTopo/MapServer/WMTS/tile/1.0.0/",
{
layer: "USGSTopo",
style: "default",
tileMatrixSet: "default028mm",
format: "image/png",
googleMapsCompatible: true
}
);
layer.addTo(map);
</script>
</body>
</html>
WMTSOptions (in addition to L.TileLayerOptions):
| Option | Type | Default | Description |
|---|---|---|---|
layer | string | — | WMTS layer name |
tileMatrixSet | string | — | WMTS matrix set |
style | string | "default" | WMTS style |
format | string | "image/png" | Tile MIME type |
tileMatrixLabels | (string|number)[] | undefined | Map Leaflet zoom → TILEMATRIX |
googleMapsCompatible | boolean | true | Use XYZ mapping directly |
extraParams | Record<string, any> | {} | Extra query params (e.g., token) |
crossOrigin | string|true | undefined | Sets crossorigin on tile images |
baseQuery | string | undefined | Appended before WMTS KVPs |
/src
leaflet.tilelayer.wmts.js # ESM source
leaflet.tilelayer.wmts.d.ts # TypeScript typings
/dist
leaflet.tilelayer.wmts.umd.js # UMD build (Rollup output)
leaflet.tilelayer.wmts.min.js # Minified UMD build (for browser/demo)
example.html # GitHub Pages demo (loads dist build)
Failed to resolve module specifier "leaflet"dist/.Beerware
FAQs
A modern, lightweight Leaflet plugin for displaying WMTS tile layers.
We found that @alcalin/leaflet-tilelayer-wmts demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Company News
Socket won two 2026 Reppy Awards from RepVue, ranking in the top 5% of all sales orgs. AE Alexandra Lister shares what it's like to grow a sales career here.
Security News
NIST will stop enriching most CVEs under a new risk-based model, narrowing the NVD's scope as vulnerability submissions continue to surge.
Company News
/Security News
Socket is an initial recipient of OpenAI's Cybersecurity Grant Program, which commits $10M in API credits to defenders securing open source software.