JSAPI Three API Reference
    正在准备搜索索引...

    类 WMTSImageryTileProvider

    WMTS影像瓦片提供者，用于加载和渲染WMTS服务的影像瓦片数据。 支持Web墨卡托和地理坐标两种投影方式。

    主要功能：

    • 支持WMTS 1.0.0版本
    • 支持多种投影系统和TileMatrixSet
    • 自动处理瓦片坐标转换
    • 支持透明度和样式设置
    • 支持不同服务器类型的HiDPI处理
    • 支持RESTful和KVP两种请求方式
    • 支持自定义瓦片矩阵ID映射
    // 创建WMTS影像瓦片提供者 - 使用默认TILEMATRIX模板
    const provider1 = new WMTSImageryTileProvider({
        url: 'https://example.com/geoserver/gwc/service/wmts',
        params: {
            LAYER: 'layer1',
            TILEMATRIXSET: 'EPSG:900913',
            TILEMATRIX: 'EPSG:900913:{z}',
            VERSION: '1.0.0',
        },
    });

    // 创建WMTS影像瓦片提供者 - 使用自定义matrixIds
    const provider2 = new WMTSImageryTileProvider({
        url: 'https://example.com/geoserver/gwc/service/wmts',
        params: {
            LAYER: 'layer1',
            TILEMATRIXSET: 'EPSG:3857',
            VERSION: '1.0.0',
        },
        matrixIds: ['EPSG:3857:0', 'EPSG:3857:1', 'EPSG:3857:2'],
    });

    // 创建WMTS影像瓦片提供者 - 使用REST请求方式
    const provider3 = new WMTSImageryTileProvider({
        url: 'https://example.com/wmts/{layer}/{style}/{tilematrixset}/{tilematrix}/{tilerow}/{tilecol}.png',
        params: {
            LAYER: 'layer1',
            STYLE: 'default',
            TILEMATRIXSET: 'EPSG:3857',
        },
        requestEncoding: 'REST',
    });

    层级 (查看层级一览)

    索引

    属性

    isBaseImageryTileProvider isImageryTileProvider name visible

    方法

    appendParams doRequestImageTileData doRequestTileData errorFallback getParams getTileURL getUrlParams initProjectionAndGrid onTileDispose setParams shouldReproject

    访问器

    addDebugLabel colorTint maxLevel minLevel opacity randomColorTint sourceProjection targetProjection

    属性

    isBaseImageryTileProvider: true

    是否为基础影像瓦片提供者

    isImageryTileProvider: true

    是否为影像瓦片提供者

    name: string = 'WMTSImageryTileProvider'

    瓦片提供者名称

    visible: boolean = true

    是否可见

    方法

    • 拼接params到url

      参数

      • uri: string

        基础URL

      • params: Object

        参数对象

      返回 string

      拼接后的URL

    • 请求瓦片数据 加载影像瓦片纹理，并根据需要进行投影变换

      参数

      • tile: object

        瓦片对象

      • surfaceTile: object

        表面瓦片对象

      返回 Promise<Texture>

      瓦片纹理

    • 请求瓦片数据 子类需要重写doRequestImageTileData方法

      参数

      • tile: object

        瓦片对象

      • surfaceTile: object

        表面瓦片对象

      返回 Promise<Texture>

      瓦片纹理

    • 错误回退处理 当瓦片加载失败时返回透明纹理

      返回 DataTexture

      透明纹理

    • 获取当前WMTS参数

      返回 Object

      当前参数对象

    • 获取瓦片URL

      参数

      • z: number

        缩放级别

      • x: number

        瓦片X坐标

      • y: number

        瓦片Y坐标

      • tile: Object

        瓦片对象

      返回 string

      瓦片URL

    • 解析URL参数

      参数

      • url: string

        URL字符串

      返回 Object

      参数对象

    • 瓦片销毁时的回调 释放瓦片纹理资源

      参数

      • tile: object

        瓦片对象

      返回 void

    • 设置WMTS参数

      参数

      • params: Object

        新的参数对象

      返回 void

    • 判断是否需要进行投影变换 取中心点的像素坐标，计算变换后的像素坐标，判断是否有明显的偏移

      参数

      • sourceProjection: object

        源投影

      • targetProjection: object

        目标投影

      • tile: object

        瓦片对象

      • terrainTile: object

        地形瓦片对象

      返回 boolean

      是否需要重投影

    访问器

    • get addDebugLabel(): boolean

      获取是否绘制调试标签

      返回 boolean

    • set addDebugLabel(addDebugLabel: boolean): void

      设置是否绘制调试标签

      参数

      • addDebugLabel: boolean

        是否绘制调试标签

      返回 void

    • get colorTint(): number[]

      获取色彩调整值

      返回 number[]

    • set colorTint(colorTint: number[]): void

      设置色彩调整值

      参数

      • colorTint: number[]

        色彩调整值，RGB分量

      返回 void

    • get maxLevel(): number

      获取最大等级

      返回 number

    • get minLevel(): number

      获取最小等级

      返回 number

    • get opacity(): number

      获取不透明度

      返回 number

    • set opacity(opacity: number): void

      设置不透明度

      参数

      • opacity: number

        不透明度，取值范围0-1

      返回 void

    • get randomColorTint(): boolean

      获取是否使用随机色彩调整

      返回 boolean

    • set randomColorTint(randomColorTint: boolean): void

      设置是否使用随机色彩调整

      参数

      • randomColorTint: boolean

        是否使用随机色彩调整

      返回 void

    • get sourceProjection(): any

      获取源投影

      返回 any

    • get targetProjection(): any

      获取目标投影

      返回 any

    • set targetProjection(value: any): void

      设置目标投影

      参数

      • value: any

      返回 void

    显示设置

    成员可见性

    目录

    属性
    方法
    访问器