提供单个顶层影像瓦片。该单张图像假定采用
Geographic 投影（即 WGS84 / EPSG:4326），
并将使用
GeographicTilingScheme 进行渲染。
| Name | Type | Description |
|---|---|---|
options |
SingleTileImageryProvider.ConstructorOptions | 描述初始化选项的对象 |
Members
readonly credit : Credit
获取此影像提供者处于活动状态时要显示的版权信息。通常这用于标注
影像的来源。
readonly errorEvent : Event
获取当影像提供者遇到异步错误时引发的事件。通过订阅
该事件，你会收到错误通知并可能从中恢复。事件监听器
会接收一个
TileProviderError 实例。
获取一个指示此影像提供者提供的图像是否
包含 alpha 通道的值。如果此属性为 false，则 alpha 通道（如果存在）将被
忽略。如果此属性为 true，则任何没有 alpha 通道的图像将被视为
其 alpha 在所有位置均为 1.0。当此属性为 false 时，内存占用
和纹理上传时间会减少。
获取可请求的最大细节级别。
获取可请求的最小细节级别。
readonly proxy : Proxy
获取此提供者使用的代理。
readonly rectangle : Rectangle
获取此实例提供的影像的矩形范围（以弧度为单位）。
readonly tileDiscardPolicy : TileDiscardPolicy
获取瓦片丢弃策略。如果不为 undefined，该丢弃策略负责
通过其 shouldDiscardImage 函数过滤掉“缺失”的瓦片。如果该函数
返回 undefined，则不会过滤任何瓦片。
获取每个瓦片的高度（以像素为单位）。
获取每个瓦片的宽度（以像素为单位）。
readonly tilingScheme : TilingScheme
获取此提供者使用的瓦片方案。
获取单个顶层影像瓦片的 URL。
Methods
static Cesium.SingleTileImageryProvider.fromUrl(url, options) → Promise.<SingleTileImageryProvider>
为单个顶层影像瓦片创建提供者。该单张图像假定使用 a
| Name | Type | Description |
|---|---|---|
url |
Resource | string | 瓦片的 url |
options |
SingleTileImageryProvider.fromUrlOptions | optional 描述初始化选项的对象。 |
Returns:
已解析的 SingleTileImageryProvider。
Example:
const provider = await SingleTileImageryProvider.fromUrl("https://yoururl.com/image.png");getTileCredits(x, y, level) → Array.<Credit>
获取给定瓦片显示时要显示的版权信息。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片的 X 坐标。 |
y |
number | 瓦片的 Y 坐标。 |
level |
number | 瓦片级别； |
Returns:
瓦片显示时要显示的版权信息。
此影像提供者当前不支持拾取要素，因此此函数直接返回
undefined。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片的 X 坐标。 |
y |
number | 瓦片的 Y 坐标。 |
level |
number | 瓦片级别。 |
longitude |
number | 拾取要素所在的经度。 |
latitude |
number | 拾取要素所在的纬度。 |
Returns:
由于不支持拾取，返回 undefined。
requestImage(x, y, level, request) → Promise.<ImageryTypes>|undefined
请求给定瓦片的图像。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片的 X 坐标。 |
y |
number | 瓦片的 Y 坐标。 |
level |
number | 瓦片级别。 |
request |
Request | optional 请求对象。仅供内部使用。 |
Returns:
已解析的图像
Type Definitions
SingleTileImageryProvider 构造函数的初始化选项。
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
url |
Resource | string | 瓦片的 url。 | ||
tileWidth |
number |
<optional> |
瓦片的宽度（以像素为单位）。 | |
tileHeight |
number |
<optional> |
瓦片的高度（以像素为单位）。 | |
rectangle |
Rectangle |
<optional> |
Rectangle.MAX_VALUE | 图像覆盖的矩形范围（以弧度为单位）。 |
credit |
Credit | string |
<optional> |
数据源的版权信息，显示在画布上。 | |
ellipsoid |
Ellipsoid |
<optional> |
椭球体。如果未指定，则使用 WGS84 椭球体。 |
使用 SingleTileImageryProvider.fromUrl 时 SingleTileImageryProvider 构造函数的初始化选项。