UrlTemplateImageryProvider

概述

UrlTemplateImageryProvider是一个提供基于URL模板的图像服务的ImageryProvider，它被用来在Cesium场景中加载图像数据。

一些Web地图服务如OpenStreetMap或Mapbox都提供了基于URL模板的图像服务，方便用户以自定义的方式定制地图样式。UrlTemplateImageryProvider可以被用来加载这些类型的图像服务。

示例

var provider = new Cesium.UrlTemplateImageryProvider({
    url: 'https://api.mapbox.com/styles/v1/mapbox/dark-v9/tiles/256/{z}/{x}/{y}?access_token=[YOUR_ACCESS_TOKEN]'
});

viewer.imageryLayers.addImageryProvider(provider);

构造函数

new Cesium.UrlTemplateImageryProvider(options)

创建一个UrlTemplateImageryProvider对象。

参数

options：提供如下参数：

方法

UrlTemplateImageryProvider对象没有公开方法。

属性

url

需要加载的图像服务的URL模板。

var provider = new Cesium.UrlTemplateImageryProvider({
    url: 'http://www.example.com/{z}/{x}/{y}.png'
});

console.log(provider.url); // 'http://www.example.com/{z}/{x}/{y}.png'

tileWidth

每个网格瓦片的宽度，单位像素。

var provider = new Cesium.UrlTemplateImageryProvider({
    url: 'http://www.example.com/{z}/{x}/{y}.png',
    tileWidth: 512
});

console.log(provider.tileWidth); // 512

tileHeight

每个网格瓦片的高度，单位像素。

var provider = new Cesium.UrlTemplateImageryProvider({
    url: 'http://www.example.com/{z}/{x}/{y}.png',
    tileHeight: 512
});

console.log(provider.tileHeight); // 512

maximumLevel

允许加载的最大瓦片级别。

var provider = new Cesium.UrlTemplateImageryProvider({
    url: 'http://www.example.com/{z}/{x}/{y}.png',
    maximumLevel: 18
});

console.log(provider.maximumLevel); // 18

minimumLevel

允许加载的最小瓦片级别。

var provider = new Cesium.UrlTemplateImageryProvider({
    url: 'http://www.example.com/{z}/{x}/{y}.png',
    minimumLevel: 5
});

console.log(provider.minimumLevel); // 5

rectangle

数据的覆盖范围。

var provider = new Cesium.UrlTemplateImageryProvider({
    url: 'http://www.example.com/{z}/{x}/{y}.png',
    rectangle: Cesium.Rectangle.fromDegrees(0.0, 0.0, 10.0, 10.0)
});

console.log(provider.rectangle); // Rectangle(0.0, 0.0, 10.0, 10.0)

proxy

用于代理图像请求。

var proxy = new Cesium.DefaultProxy('/proxy/');
var provider = new Cesium.UrlTemplateImageryProvider({
    url: 'http://www.example.com/{z}/{x}/{y}.png',
    proxy: proxy
});

console.log(provider.proxy); // DefaultProxy(http://localhost:8080/proxy/)

credit

用于表示数据提供方。

var credits = new Cesium.Credit('©2017 Example Company');
var provider = new Cesium.UrlTemplateImageryProvider({
    url: 'http://www.example.com/{z}/{x}/{y}.png',
    credit: credits
});

console.log(provider.credit); // Credit(©2017 Example Company)

事件

UrlTemplateImageryProvider对象没有公开事件。

参考

UrlTemplateImageryProvider