提供由ArcGIS MapServer托管的平铺图像。默认情况下,服务器的预缓存磁贴为使用(如果有)。
Name | Type | Description |
---|---|---|
options
|
ArcGisMapServerImageryProvider.ConstructorOptions | 描述初始化选项的对象 |
Example:
var 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 Server上的'标识'操作并返回响应中包含的功能。如果为假,
ArcGisMapServerImageryProvider#pickFeatures
会立即返回未定义(表示没有可拾取的功能)无需与服务器通信。
-
Default Value:
true
readonly errorEvent : Event
获取当图像提供程序遇到异步错误时引发的事件。通过订阅针对该事件,您将收到有关该错误的通知,并有可能从中恢复。事件监听器传递了
TileProviderError
的实例。
获取一个值,该值指示此图像提供者是否提供了图像包括一个Alpha通道。如果此属性为false,则Alpha通道(如果存在)将被忽略。如果此属性为true,则将处理任何没有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
影像提供者准备就绪之前,不得调用它。
请求给定图块的图像。该功能应在
ArcGisMapServerImageryProvider#ready
返回true之前不会被调用。
Name | Type | Description |
---|---|---|
x
|
Number | 瓦片X坐标。 |
y
|
Number | 瓷砖的Y坐标。 |
level
|
Number | 平铺级别。 |
request
|
Request | 可选 请求对象。仅供内部使用。 |
Returns:
对图像的承诺,将在图像可用时解决,或者 如果对服务器的活动请求过多,并且请求过多,则不确定 应稍后重试。解析的图像可能是 图片或Canvas DOM对象。
Throws:
-
DeveloperError :
requestImage
影像提供者准备就绪之前,不得调用它。
Type Definitions
ArcGisMapServerImageryProvider构造函数的初始化选项
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
url
|
Resource | String | ArcGIS MapServer服务的网址。 | ||
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上识别服务并返回响应中包含的功能。如果为假,
ArcGisMapServerImageryProvider#pickFeatures
会立即返回未定义(表示没有可拾取的功能) 无需与服务器通信。如果您不希望此提供程序的功能被设置为false 可以选择。可以通过在对象上设置
ArcGisMapServerImageryProvider#enablePickFeatures
属性来覆盖。
|
rectangle
|
Rectangle |
<optional>
|
Rectangle.MAX_VALUE | 图层的矩形。访问时将忽略此参数 平铺的图层。 |
tilingScheme
|
TilingScheme |
<optional>
|
new GeographicTilingScheme() | 用于将世界划分为图块的切片方案。 访问切片服务器时,将忽略此参数。 |
ellipsoid
|
Ellipsoid |
<optional>
|
椭球。如果指定并使用了tilingScheme, 忽略此参数,而是使用切片方案的椭球。如果两者都不 参数,则使用WGS84椭球。 | |
credit
|
Credit | String |
<optional>
|
数据源的信用,显示在画布上。访问切片服务器时,将忽略此参数。 | |
tileWidth
|
Number |
<optional>
|
256 | 每个图块的宽度(以像素为单位)。访问切片服务器时,将忽略此参数。 |
tileHeight
|
Number |
<optional>
|
256 | 每个图块的高度(以像素为单位)。访问切片服务器时,将忽略此参数。 |
maximumLevel
|
Number |
<optional>
|
要请求的最大图块级别,如果没有最大值,则未定义。访问时将忽略此参数 平铺的服务器。 |