ArcGisMapServerImageryProvider

new Cesium.ArcGisMapServerImageryProvider (options)

提供由ArcGIS MapServer托管的平铺图像。默认情况下,服务器的预缓存磁贴为使用(如果有)。
Name Type Description
options Object Object with the following properties:
Name Type Default Description
url Resource | String ArcGIS MapServer服务的URL。
token String 可选 用于通过ArcGIS MapServer服务进行身份验证的ArcGIS令牌。
tileDiscardPolicy TileDiscardPolicy 可选 确定磁贴是否存在的策略       无效,应将其丢弃。如果未指定此值,则为默认值 DiscardMissingTileImagePolicy 用于平铺的地图服务器,并且 NeverTileDiscardPolicy 用于非平铺地图服务器。在前一种情况下,       我们要求最大图块级别的图块0,0并检查像素(0,0),(200,20),(20,200),       (80,110)和(160,130)。如果所有这些像素都是透明的,则丢弃检查为       禁用,并且不会丢弃任何图块。如果其中任何一个具有不透明的颜色,       在这些像素位置具有相同值的图块将被丢弃。的最终结果       对于标准ArcGIS Server,这些默认值应该是正确的图块丢弃。确保       不会丢弃任何图块,为此构造并传递 NeverTileDiscardPolicy 参数。
usePreCachedTilesIfAvailable Boolean true 可选 如果为true,则服务器已预先缓存       如果可用,则使用图块。如果为false,则将忽略任何预缓存的图块,并且       使用了'导出'服务。
layers String 可选 要显示的图层的逗号分隔列表,如果应显示所有图层,则未定义。
enablePickFeatures Boolean true 可选 如果为true,则将调用 ArcGisMapServerImageryProvider#pickFeatures 在MapServer上识别服务并返回响应中包含的功能。如果为假, ArcGisMapServerImageryProvider#pickFeatures 会立即返回未定义(表示没有可选取的功能)       无需与服务器通信。如果您不希望此提供程序的功能被设置为false       可以选择。可以通过在对象上设置 ArcGisMapServerImageryProvider#enablePickFeatures 属性来覆盖。
rectangle Rectangle Rectangle.MAX_VALUE 可选 图层的矩形。访问时将忽略此参数                   平铺的图层。
tilingScheme TilingScheme new GeographicTilingScheme() 可选 用于将世界分成瓷砖的切片方案。                      访问切片服务器时,将忽略此参数。
ellipsoid Ellipsoid 可选 椭球。如果指定并使用了tilingScheme,                   忽略此参数,而是使用切片方案的椭球。如果两者都不                   参数,则使用WGS84椭球。
credit Credit | String 可选 数据源的信用,显示在画布上。访问切片服务器时,将忽略此参数。
tileWidth Number 256 可选 每个图块的宽度(以像素为单位)。访问切片服务器时,将忽略此参数。
tileHeight Number 256 可选 每个图块的高度(以像素为单位)。访问切片服务器时,将忽略此参数。
maximumLevel Number 可选 要请求的最大图块级别,如果没有最大值,则未定义。访问时将忽略此参数                                       平铺的服务器。
Example:
var esri = new Cesium.ArcGisMapServerImageryProvider({
    url : 'https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer'
});
See:

Members

获取此图像提供者处于活动状态时要显示的功劳。通常,这用于记入图像的来源。在 ArcGisMapServerImageryProvider#ready 返回true之前,不应调用此函数。
获取或设置一个值,该值指示是否启用了特征拾取。如果为true, ArcGisMapServerImageryProvider#pickFeatures 将调用ArcGIS Server上的'标识'操作并返回响应中包含的功能。如果为假, ArcGisMapServerImageryProvider#pickFeatures 会立即返回未定义(表示没有可选取的功能)无需与服务器通信。
Default Value: true
获取当图像提供程序遇到异步错误时引发的事件。通过订阅事件发生后,您将收到有关该错误的通知,并有可能从中恢复。事件监听器传递了 TileProviderError 的实例。

readonly hasAlphaChannel : Boolean

获取一个值,该值指示此图像提供者是否提供了图像包括一个Alpha通道。如果此属性为false,则Alpha通道(如果存在)将被忽略。如果此属性为true,则将处理没有alpha通道的任何图像好像他们的alpha到处都是1.0。当此属性为false时,内存使用情况并且减少了纹理上载时间。
Default Value: true
获取要显示的图层ID的逗号分隔列表。
获取可以请求的最大详细程度。该功能应在 ArcGisMapServerImageryProvider#ready 返回true之前不会被调用。
获取可以请求的最低详细程度。该功能应在 ArcGisMapServerImageryProvider#ready 返回true之前不会被调用。
获取此提供程序使用的代理。
获取一个值,该值指示提供程序是否准备就绪。

readonly readyPromise : Promise.<Boolean>

获取一个在提供程序准备好使用时解析为true的承诺。
获取此实例提供的图像的矩形(以弧度表示)。该功能应在 ArcGisMapServerImageryProvider#ready 返回true之前不会被调用。
获取切片丢弃策略。如果未定义,则丢弃策略负责用于通过其shouldDiscardImage函数过滤掉'缺失'的图块。如果这个功能返回未定义,不过滤任何图块。该功能应在 ArcGisMapServerImageryProvider#ready 返回true之前不会被调用。
获取每个图块的高度,以像素为单位。该功能应在 ArcGisMapServerImageryProvider#ready 返回true之前不会被调用。
获取每个图块的宽度,以像素为单位。该功能应在 ArcGisMapServerImageryProvider#ready 返回true之前不会被调用。
获取此提供程序使用的切片方案。该功能应在 ArcGisMapServerImageryProvider#ready 返回true之前不会被调用。
获取用于通过ArcGis MapServer服务进行身份验证的ArcGIS令牌。
获取ArcGIS MapServer的URL。

readonly usingPrecachedTiles : Boolean

获取一个值,该值指示此图像提供者是否正在使用来自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.<(Image|Canvas)>|undefined

请求给定图块的图像。该功能应在 ArcGisMapServerImageryProvider#ready 返回true之前不会被调用。
Name Type Description
x Number 瓦片X坐标。
y Number 瓷砖的Y坐标。
level Number 平铺级别。
request Request 可选 请求对象。仅供内部使用。
Returns:
对图像的承诺,将在图像可用时解决,或者         如果对服务器的活动请求过多,并且请求过多,则不确定         应稍后重试。解析的图像可能是         图片或Canvas DOM对象。
Throws:
  • DeveloperError : requestImage 影像提供者准备就绪之前,不得调用它。