# WMTSTilesOverlay

class in `3d-tiles-renderer/three/plugins`, extends `TiledImageOverlay`

```js
import { WMTSTilesOverlay } from '3d-tiles-renderer/three/plugins';
```

Overlay that renders WMTS (Web Map Tile Service) image tiles on top of 3D tile geometry.
Pass a parsed capabilities object from `WMTSCapabilitiesLoader` or provide a URL template
directly. See the `WMTS specification`.

## Constructor

```js
new WMTSTilesOverlay( options?: Object )
```

- `options`, `Object`, optional
  - `url`, `string`, optional: WMTS service URL.
  - `layer`, `string`, optional: WMTS layer identifier.
  - `tileMatrixSet`, `string`, optional: TileMatrixSet identifier (e.g., 'GoogleMapsCompatible', 'EPSG:3857').
  - `style`, `string`, optional, default `'default'`: Style identifier.
  - `format`, `string`, optional, default `'image/jpeg'`: Output image format (e.g., 'image/png', 'image/jpeg').
  - `dimensions`, `Object<string, (string|number)> | null`, optional, default `null`: WMTS dimension values
  - `tileMatrixLabels`, `Array<string> | null`, optional, default `null`: Custom TileMatrix identifiers per level
  - `tileMatrices`, `Array<WMTSTileMatrix> | null`, optional, default `null`: Explicit per-level tile matrix definitions. When provided, `levels` and `tileMatrixLabels` are ignored.
  - `projection`, `string | null`, optional, default `null`: Projection identifier ('EPSG:3857' or 'EPSG:4326'). Defaults to 'EPSG:3857' if not specified.
  - `levels`, `number`, optional, default `20`: Number of zoom levels. Ignored if `tileMatrices` is provided.
  - `tileDimension`, `number`, optional, default `256`: Default tile width and height in pixels.
  - `contentBoundingBox`, `Array<number> | null`, optional, default `null`: Content bounding box in radians, `[west, south, east, north]`. If null, uses full projection bounds.