Class WmtsSource

A TiledImageSource backed by a single WMTS layer. Note: this is a convenient class that simplifies the usage of TiledImageSource.

Currently, it is not possible to directly create a WmtsSource from its constructor. Use the fromCapabilities static method to build a source from a WMTS capabilities document.

WmtsSource.fromCapabilities('http://example.com/wmts?SERVICE=WMTS&REQUEST=GetCapabilities', {
    layer: 'MyLayerName',
})
.then(wmtsSource => {
  // Do something with the source.
});

Hierarchy (view full)

TiledImageSource
- WmtsSource

Properties

`Readonly` containsFn

containsFn: CustomContainsFn

datatype

datatype: TextureDataType

Gets the datatype of images generated by this source.

`Readonly` flipY

flipY: boolean

Gets whether images generated from this source should be flipped vertically.

`Readonly` format

format: ImageFormat

`Readonly` isImageSource

isImageSource: boolean = true

`Readonly` isTiledImageSource

isTiledImageSource: boolean = true

`Readonly` isWmtsSource

isWmtsSource: true = true

`Readonly` noDataValue

noDataValue: number

`Readonly` olprojection

olprojection: Projection

`Readonly` source

source: UrlTile

`Readonly` synchronous

synchronous: boolean = false

If true, this source can immediately generate images without any delay.

`Readonly` type

type: string = 'WmtsSource'

Accessors

colorSpace

get colorSpace(): ColorSpace
Gets the color space of the textures generated by this source.

Returns ColorSpace
Inherited from TiledImageSource.colorSpace
- Defined in sources/ImageSource.ts:171

Methods

adjustExtentAndPixelSize

adjustExtentAndPixelSize(requestExtent, requestWidth, requestHeight, margin?): {
    extent: Extent;
    height: number;
    width: number;
}
Returns an adjusted extent, width and height so that request pixels are aligned with source pixels, and requests do not oversample the source.
Parameters
- requestExtent: Extent
  The request extent.
- requestWidth: number
  The width, in pixels, of the request extent.
- requestHeight: number
  The height, in pixels, of the request extent.
- margin: number = 0
  The margin, in pixels, around the initial extent.
Returns {
    extent: Extent;
    height: number;
    width: number;
}
The adjusted parameters.
- extent: Extent
- height: number
- width: number
Inherited from TiledImageSource.adjustExtentAndPixelSize
- Defined in sources/TiledImageSource.ts:145

contains

contains(extent): boolean
Gets whether this source contains the specified extent. If a custom contains function is provided, it will be used. Otherwise, intersects is used.

This method is mainly used to discard non-relevant requests (i.e don't process regions that are not relevant to this source).
Parameters
- extent: Extent
  The extent to test.
Returns boolean
Inherited from TiledImageSource.contains
- Defined in sources/ImageSource.ts:238

dispose

dispose(): void
Disposes unmanaged resources of this source.

Returns void
Inherited from TiledImageSource.dispose
- Defined in sources/ImageSource.ts:293

getCrs

getCrs(): string
Returns the CRS of this source.

Returns string
The CRS.
Inherited from TiledImageSource.getCrs
- Defined in sources/TiledImageSource.ts:141

getExtent

getExtent(): Extent
Returns the extent of this source expressed in the CRS of the source.

Returns Extent
The extent of the source.
Inherited from TiledImageSource.getExtent
- Defined in sources/TiledImageSource.ts:137

getImages

getImages(options): {
id: string;
request: (() => Promise<ImageResult>);
}[]
Gets the images for the specified extent and pixel size.
Parameters
- options: GetImageOptions
  The options.
Returns {
id: string;
request: (() => Promise<ImageResult>);
}[]
An array containing the functions to generate the images asynchronously.
Inherited from TiledImageSource.getImages
- Defined in sources/TiledImageSource.ts:224

getMemoryUsage

getMemoryUsage(_context, target?): MemoryUsageReport
Returns an approximation of the memory used by this object, in bytes.
Parameters
- _context: GetMemoryUsageContext
  The graphics context.
- Optional target: MemoryUsageReport
  If specified, the values computed during this call must be added to the existing values in the target. Otherwise, a new report must be built.
Returns MemoryUsageReport
The memory usage report. If target is specified, then this must be returned.
Inherited from TiledImageSource.getMemoryUsage
- Defined in sources/ImageSource.ts:164

initialize

initialize(options): Promise<void>
Initializes the source.
Parameters
- options: {
  targetProjection: string;
  }
  Options.
  - targetProjection: string
    The target projection. Only useful for sources that are able to reproject their data on the fly (typically vector sources).
Returns Promise<void>
A promise that resolves when the source is initialized.
Inherited from TiledImageSource.initialize
- Defined in sources/ImageSource.ts:272

intersects

intersects(extent): boolean
Test the intersection between the specified extent and this source's extent. This method may be overriden to perform special logic.
Parameters
- extent: Extent
  The extent to test.
Returns boolean
true if the extent and this source extent intersects, false otherwise.
Inherited from TiledImageSource.intersects
- Defined in sources/ImageSource.ts:255

update

update(extent?): void
Raises an event to reload the source.
Parameters
- Optional extent: Extent
Returns void
Inherited from TiledImageSource.update
- Defined in sources/ImageSource.ts:224

`Static` fromCapabilities

fromCapabilities(url, options): Promise<WmtsSource>

Constructs a WmtsSource from a WMTS capabilities document.

Parameters

url: string
The URL to the WMTS capabilities document.
options: WmtsFromCapabilitiesOptions
Source options.

Returns Promise<WmtsSource>

A promise that resolve with the created WmtsSource.

const url = 'http://example.com/wmts?SERVICE=WMTS&VERSION=1.0.0&REQUEST=GetCapabilities';

// Creates the source with layer 'MyLayer' in the 'PM' tile matrix set.
const wmtsSource = await WmtsSource.fromCapabilities(url, {
  layer: 'MyLayer',
  matrixSet: 'PM',
  imageFormat: 'image/png',
});

Class WmtsSource

Hierarchy (view full)

Index

Properties

Accessors

Methods

Properties

Readonly containsFn

datatype

Readonly flipY

Readonly format

Readonly isImageSource

Readonly isTiledImageSource

Readonly isWmtsSource

Readonly noDataValue

Readonly olprojection

Readonly source

Readonly synchronous

Readonly type

Accessors

colorSpace

Returns ColorSpace

Methods

adjustExtentAndPixelSize

Parameters

Returns { extent: Extent; height: number; width: number; }

extent: Extent

height: number

width: number

contains

Parameters

Returns boolean

dispose

Returns void

getCrs

Returns string

getExtent

Returns Extent

getImages

Parameters

Returns { id: string; request: (() => Promise<ImageResult>); }[]

getMemoryUsage

Parameters

Returns MemoryUsageReport

initialize

Parameters

targetProjection: string

Returns Promise<void>

intersects

Parameters

Returns boolean

update

Parameters

Returns void

Static fromCapabilities

Parameters

Returns Promise<WmtsSource>

Settings

Member Visibility

On This Page

`Readonly` containsFn

`Readonly` flipY

`Readonly` format

`Readonly` isImageSource

`Readonly` isTiledImageSource

`Readonly` isWmtsSource

`Readonly` noDataValue

`Readonly` olprojection

`Readonly` source

`Readonly` synchronous

`Readonly` type

Returns {
extent: Extent;
height: number;
width: number;
}

Returns {
id: string;
request: (() => Promise<ImageResult>);
}[]

`Static` fromCapabilities