提供来自 Azure 的 2D 图像瓦片。
| Name | Type | Description |
|---|---|---|
options |
Azure2DImageryProvider.ConstructorOptions | 描述初始化选项的对象 |
Example:
// Azure 2D imagery provider
const azureImageryProvider = new Cesium.Azure2DImageryProvider({
subscriptionKey: "subscription-key",
tilesetId: "microsoft.base.road"
});
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
获取瓦片丢弃策略。如果未定义,丢弃策略负责通过其 shouldDiscardImage 函数
过滤掉"缺失"的瓦片。如果该函数返回 undefined,则不进行任何过滤。
获取每个瓦片的高度(以像素为单位)。
获取每个瓦片的宽度(以像素为单位)。
readonly tilingScheme : TilingScheme
获取提供者使用的切片方案。
获取 Azure 2D 影像服务器的 URL。
Methods
getTileCredits(x, y, level) → Array.<Credit>|undefined
获取给定瓦片显示时要显示的版权信息。
| 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:
由于不支持拾取而未定义。
requestImage(x, y, level, request) → Promise.<ImageryTypes>|undefined
请求给定瓦片的图像。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片 X 坐标。 |
y |
number | 瓦片 Y 坐标。 |
level |
number | 瓦片层级。 |
request |
Request | optional 请求对象。仅供内部使用。 |
Returns:
图像的 Promise,当图像可用时将 resolve,或者
如果对服务器的活跃请求太多,则返回 undefined,请求应该稍后重试。
Type Definitions
Azure2DImageryProvider 构造函数的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
subscriptionKey |
string | 影像的公共订阅密钥。 | ||
url |
string |
<optional> |
"https://atlas.microsoft.com/" | Azure 服务器 URL。 |
tilesetId |
string |
<optional> |
"microsoft.imagery" | Azure 瓦片集 ID。有效值为 microsoft.imagery、microsoft.base.road 和 microsoft.base.labels.road |
ellipsoid |
Ellipsoid |
<optional> |
Ellipsoid.default | 椭球体。如果未指定,则使用默认椭球体。 |
minimumLevel |
number |
<optional> |
0 | 影像提供者支持的最低细节层次。在指定此值时请注意, 最小层次的瓦片数量应较小(例如四个或更少)。 较大的数值可能会导致渲染问题。 |
maximumLevel |
number |
<optional> |
22 | 影像提供者支持的最高细节层次。 |
rectangle |
Rectangle |
<optional> |
Rectangle.MAX_VALUE | 图像覆盖的范围(以弧度为单位)。 |
