提供由 ArcGIS MapServer 托管的切片图像。默认情况下,使用服务器的预缓存切片(如果可用)。
Name | Type | Description |
---|---|---|
options
|
ArcGisMapServerImageryProvider.ConstructorOptions | 描述初始化选项的对象 |
Example:
const esri = new Cesium.ArcGisMapServerImageryProvider({
url : 'https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer'
});
See:
Members
readonly credit : Credit
当此图像提供程序处于活动状态时,获得要显示的功劳。通常,这用于说明图像的来源。在
ArcGisMapServerImageryProvider#ready
返回 true 之前,不应调用此函数。
此提供程序的默认 alpha 混合值,0.0 表示完全透明,1.0 表示完全不透明。
-
Default Value:
undefined
此提供程序的默认亮度。 1.0 使用未修改的图像颜色。小于 1.0 会使图像更暗,而大于 1.0 会使图像更亮。
-
Default Value:
undefined
此提供程序的默认对比度。 1.0 使用未修改的图像颜色。小于 1.0 会降低对比度,而大于 1.0 会增加对比度。
-
Default Value:
undefined
此提供程序的地球日侧的默认 alpha 混合值,0.0 表示完全透明,1.0 表示完全不透明。
-
Default Value:
undefined
应用于此提供程序的默认伽马校正。 1.0 使用未修改的图像颜色。
-
Default Value:
undefined
此提供程序的默认色调(以弧度为单位)。 0.0 使用未修改的图像颜色。
-
Default Value:
undefined
defaultMagnificationFilter : TextureMagnificationFilter
应用于此提供程序的默认纹理放大过滤器。
-
Default Value:
undefined
defaultMinificationFilter : TextureMinificationFilter
应用于此提供程序的默认纹理缩小过滤器。
-
Default Value:
undefined
此提供程序的地球夜晚的默认 alpha 混合值,0.0 表示完全透明,1.0 表示完全不透明。
-
Default Value:
undefined
此提供程序的默认饱和度。 1.0 使用未修改的图像颜色。小于 1.0 会降低饱和度,而大于 1.0 会增加饱和度。
-
Default Value:
undefined
获取或设置一个值,该值指示是否启用特征选择。如果为 true,
ArcGisMapServerImageryProvider#pickFeatures
将调用 ArcGIS 服务器上的'识别'操作并返回响应中包含的要素。如果为 false,
ArcGisMapServerImageryProvider#pickFeatures
将立即返回 undefined(表示没有可挑选的要素)而不与服务器通信。
-
Default Value:
true
readonly errorEvent : Event
获取图像提供程序遇到异步错误时引发的事件。通过订阅该事件,您将收到错误通知,并有可能从中恢复。事件侦听器被传递一个
TileProviderError
实例。
获取一个值,该值指示此图像提供程序提供的图像是否包含 Alpha 通道。如果此属性为 false,则 Alpha 通道(如果存在)将被忽略。如果此属性为真,则任何没有 alpha 通道的图像都将被视为其 alpha 在任何地方都是 1.0。当此属性为 false 时,内存使用量和纹理上传时间会减少。
-
Default Value:
true
获取要显示的图层 ID 的逗号分隔列表。
获取可以请求的最大细节级别。在
ArcGisMapServerImageryProvider#ready
返回 true 之前,不应调用此函数。
获取可以请求的最低详细级别。在
ArcGisMapServerImageryProvider#ready
返回 true 之前,不应调用此函数。
readonly proxy : Proxy
获取此提供程序使用的代理。
获取一个值,该值指示提供程序是否已准备好使用。
当提供者准备好使用时,获取一个解析为 true 的承诺。
readonly rectangle : Rectangle
获取此实例提供的图像的矩形(以弧度为单位)。在
ArcGisMapServerImageryProvider#ready
返回 true 之前,不应调用此函数。
readonly tileDiscardPolicy : TileDiscardPolicy
获取瓦片丢弃策略。如果未定义,丢弃策略负责通过其 shouldDiscardImage 函数过滤掉'丢失的'图块。如果此函数返回未定义,则不过滤任何图块。在
ArcGisMapServerImageryProvider#ready
返回 true 之前,不应调用此函数。
获取每个图块的高度,以像素为单位。在
ArcGisMapServerImageryProvider#ready
返回 true 之前,不应调用此函数。
获取每个图块的宽度,以像素为单位。在
ArcGisMapServerImageryProvider#ready
返回 true 之前,不应调用此函数。
readonly tilingScheme : TilingScheme
获取此提供程序使用的切片方案。在
ArcGisMapServerImageryProvider#ready
返回 true 之前,不应调用此函数。
获取用于对 ArcGis MapServer 服务进行身份验证的 ArcGIS 令牌。
获取 ArcGIS MapServer 的 URL。
获取一个值,该值指示此影像提供程序是否使用来自 ArcGIS MapServer 的预缓存切片。如果图像提供程序尚未准备好 (
ArcGisMapServerImageryProvider#ready
),即使 MapServer 没有预缓存切片,此函数也会返回 `options.usePreCachedTilesIfAvailable` 的值。
-
Default Value:
true
Methods
getTileCredits (x, y, level) → Array.< Credit >
获取显示给定磁贴时要显示的积分。
Name | Type | Description |
---|---|---|
x
|
Number | 平铺 X 坐标。 |
y
|
Number | 瓦片 Y 坐标。 |
level
|
Number | 瓷砖级别; |
Returns:
显示磁贴时要显示的学分。
Throws:
-
DeveloperError : 在图像提供程序准备好之前,不得调用
getTileCredits
。
pickFeatures (x, y, level, longitude, latitude) → Promise.<Array.< ImageryLayerFeatureInfo >>|undefined
/** 异步确定哪些特征(如果有)位于图块内的给定经度和纬度处。在
ImageryProvider#ready
返回 true 之前不应调用此函数。
Name | Type | Description |
---|---|---|
x
|
Number | 平铺 X 坐标。 |
y
|
Number | 瓦片 Y 坐标。 |
level
|
Number | 瓷砖级别。 |
longitude
|
Number | 选择要素的经度。 |
latitude
|
Number | 选择要素的纬度。 |
Returns:
异步拾取完成时将解决的拾取特征的承诺。解析的值是
ImageryLayerFeatureInfo
实例的数组。如果在给定位置未找到任何特征,则该数组可能为空。
Throws:
-
DeveloperError : 在图像提供程序准备好之前,不得调用
pickFeatures
。
requestImage (x, y, level, request ) → Promise.< ImageryTypes >|undefined
请求给定图块的图像。在
ArcGisMapServerImageryProvider#ready
返回 true 之前,不应调用此函数。
Name | Type | Description |
---|---|---|
x
|
Number | 平铺 X 坐标。 |
y
|
Number | 瓦片 Y 坐标。 |
level
|
Number | 瓷砖级别。 |
request
|
Request | 可选 请求对象。仅供内部使用。 |
Returns:
对图像的承诺,当图像可用时将解析,或者如果对服务器的活动请求过多,则未定义,并且应稍后重试请求。
Throws:
-
DeveloperError :在图像提供程序准备好之前,不得调用
requestImage
。
Type Definitions
ArcGisMapServerImageryProvider 构造函数的初始化选项
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
url
|
Resource | String | ArcGIS MapServer 服务的 URL。 | ||
token
|
String |
<optional>
|
用于对 ArcGIS MapServer 服务进行身份验证的 ArcGIS 令牌。 | |
tileDiscardPolicy
|
TileDiscardPolicy |
<optional>
|
确定图块是否无效并应丢弃的策略。如果未指定此值,则默认
DiscardMissingTileImagePolicy
用于切片地图服务器,而
NeverTileDiscardPolicy
用于非切片地图服务器。在前一种情况下,我们在最大平铺级别请求平铺 0,0 并检查像素 (0,0)、(200,20)、(20,200)、(80,110) 和 (160, 130)。如果所有这些像素都是透明的,则禁用丢弃检查并且不会丢弃任何图块。如果它们中的任何一个具有不透明的颜色,则丢弃在这些像素位置具有相同值的任何图块。这些默认值的最终结果应该是标准 ArcGIS Server 的正确切片丢弃。为确保不丢弃任何切片,请为此参数构造并传递
NeverTileDiscardPolicy
。
|
|
usePreCachedTilesIfAvailable
|
Boolean |
<optional>
|
true | 如果为 true,则使用服务器的预缓存切片(如果可用)。如果为 false,则忽略任何预缓存的切片并使用'导出'服务。 |
layers
|
String |
<optional>
|
要显示的层的逗号分隔列表,如果应显示所有层,则未定义。 | |
enablePickFeatures
|
Boolean |
<optional>
|
true |
如果为 true,
ArcGisMapServerImageryProvider#pickFeatures
将调用 MapServer 上的识别服务并返回响应中包含的要素。如果为 false,
ArcGisMapServerImageryProvider#pickFeatures
将立即返回 undefined(表示没有可挑选的要素)而不与服务器通信。如果您不希望此提供程序的功能可供选择,请将此属性设置为 false。可以通过在对象上设置
ArcGisMapServerImageryProvider#enablePickFeatures
属性来覆盖。
|
rectangle
|
Rectangle |
<optional>
|
Rectangle.MAX_VALUE | 图层的矩形。访问平铺图层时忽略此参数。 |
tilingScheme
|
TilingScheme |
<optional>
|
new GeographicTilingScheme() | 用于将世界划分为瓦片的瓦片方案。访问平铺服务器时忽略此参数。 |
ellipsoid
|
Ellipsoid |
<optional>
|
椭球体。如果指定并使用了 tilingScheme,则忽略此参数,而使用 tiling scheme 的 ellipsoid。如果两个参数均未指定,则使用 WGS84 椭球。 | |
credit
|
Credit | String |
<optional>
|
数据源的功劳,显示在画布上。访问平铺服务器时忽略此参数。 | |
tileWidth
|
Number |
<optional>
|
256 | 每个图块的宽度(以像素为单位)。访问平铺服务器时忽略此参数。 |
tileHeight
|
Number |
<optional>
|
256 | 每个图块的高度(以像素为单位)。访问平铺服务器时忽略此参数。 |
maximumLevel
|
Number |
<optional>
|
要请求的最大磁贴级别,如果没有最大值,则未定义。访问平铺服务器时忽略此参数。 |