ArcGisMapServerImageryProvider

new Cesium.ArcGisMapServerImageryProvider(options)
Scene/ArcGisMapServerImageryProvider.js 66

提供由ArcGIS MapServer托管的瓦片图像。默认情况下，使用服务器的预缓存切片（如果有）。
Name Type Description
options Object 此对象拥有以下属性：
Name Type Default Description
url Resource | String ArcGIS MapServer服务的URL。
token String optional ArcGIS令牌用于使用ArcGIS MapServer服务进行身份验证。
tileDiscardPolicy TileDiscardPolicy optional 确定某个瓦片是否无效并应被丢弃的策略。 如果未指定此值，则默认的DiscardMissingTileImagePolicy用于瓦片地图服务器，而NeverTileDiscardPolicy用于非瓦片地图服务器。
usePreCachedTilesIfAvailable Boolean true optional 如果为true，则使用服务器预先缓存的瓦片（如果它们可用）。如果为false，则忽略任何预先缓存的瓦片并使用'export'服务。
layers String optional 要显示图的层的逗号分隔列表，如果应该显示所有图层，则为未定义的列表。
enablePickFeatures Boolean true optional 是否拾取要素。 如果为true，ArcGisMapServerImageryProvider#pickFeatures将调用MapServer上的Identify服务并返回响应中包含的要素。 如果为false， ArcGisMapServerImageryProvider#pickFeatures将立即返回undefined（表示没有可拾取的要素），而不与服务器通信。 如果不希望此提供器的要素拾取，请将此属性设置为false。可以通过在对象上设置ArcGisMapServerImageryProvider#enablePickFeatures属性来重写。
rectangle Rectangle Rectangle.MAX_VALUE optional 图层矩形范围。 访问瓦片图层时，将忽略此参数。
tilingScheme TilingScheme new GeographicTilingScheme() optional 切片方案。访问切片服务器时，将忽略此参数。
ellipsoid Ellipsoid optional 椭球。 如果指定并使用了tilingScheme，则将忽略此参数，而是使用切片方案指定的的椭球。 如果未指定任何参数，则使用WGS84椭球。
credit Credit | String optional 数据源的版权，显示在画布上。 访问切片服务器时，将忽略此参数。
tileWidth Number 256 optional 瓦片宽度（以像素为单位）。 访问切片服务器时，将忽略此参数。
tileHeight Number 256 optional 瓦片高度（以像素为单位）。 访问切片服务器时，将忽略此参数。
maximumLevel Number optional 要请求的最大图块级别，如果没有最大值，则未定义。 访问切片服务器时，将忽略此参数。
Example:
var esri = new Cesium.ArcGisMapServerImageryProvider({
    url : 'https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer'
});
See:

Members

readonlycredit : Credit
Scene/ArcGisMapServerImageryProvider.js 460

获取版权信息。 在ArcGisMapServerImageryProvider＃ready返回true之前，不应调用此函数。

enablePickFeatures : Boolean
Scene/ArcGisMapServerImageryProvider.js 108

获取或设置一个值，该值指示是否启用要素拾取。 如果为true，ArcGisMapServerImageryProvider#pickFeatures将调用MapServer上的Identify服务并返回响应中包含的要素。 如果为false， ArcGisMapServerImageryProvider#pickFeatures将立即返回undefined（表示没有可拾取的要素），而不与服务器通信。
Default Value: true

readonlyerrorEvent : Event
Scene/ArcGisMapServerImageryProvider.js 424

获取此提供器遇到异步错误时触发的事件。 通过订阅事件，您将收到错误通知，并可能从中恢复。事件监听器传递一个TileProviderError的实例。

readonlyhasAlphaChannel : Boolean
Scene/ArcGisMapServerImageryProvider.js 490

获取影像是否有Alpha通道。
Default Value: true

layers : String
Scene/ArcGisMapServerImageryProvider.js 502

获取要显示的图层ID。

readonlymaximumLevel : Number
Scene/ArcGisMapServerImageryProvider.js 328

获取请求的最大级别。 在ArcGisMapServerImageryProvider#ready返回true之前，不应调用此函数。

readonlyminimumLevel : Number
Scene/ArcGisMapServerImageryProvider.js 347

获取请求的最小级别。 在ArcGisMapServerImageryProvider#ready返回true之前，不应调用此函数。

readonlyproxy : Proxy
Scene/ArcGisMapServerImageryProvider.js 277

获取此提供器使用的代理。

readonlyready : Boolean
Scene/ArcGisMapServerImageryProvider.js 436

获取一个值，该值指示提供器是否已准备好使用。

readonlyreadyPromise : Promise.<Boolean>
Scene/ArcGisMapServerImageryProvider.js 448

获取一个在提供器准备就绪时可以解析为true的Promise。

readonlyrectangle : Rectangle
Scene/ArcGisMapServerImageryProvider.js 385

获取要显示的地图矩形范围（以弧度表示）。 在ArcGisMapServerImageryProvider#ready返回true之前，不应调用此函数。

readonlytileDiscardPolicy : TileDiscardPolicy
Scene/ArcGisMapServerImageryProvider.js 405

获取瓦片忽略策略。如果未定义，则丢弃策略负责通过其shouldDiscardImage函数过滤掉“丢失”的瓦片。 如果此函数返回未定义，则不过滤任何切片。 在ArcGisMapServerImageryProvider#ready返回true之前，不应调用此函数。

readonlytileHeight : Number
Scene/ArcGisMapServerImageryProvider.js 309

获取瓦片高，以像素为单位。 在ArcGisMapServerImageryProvider#ready返回true之前，不应调用此函数。

readonlytileWidth : Number
Scene/ArcGisMapServerImageryProvider.js 290

获取瓦片宽，以像素为单位。 在ArcGisMapServerImageryProvider#ready返回true之前，不应调用此函数。

readonlytilingScheme : TilingScheme
Scene/ArcGisMapServerImageryProvider.js 366

获取切片方案。 在ArcGisMapServerImageryProvider#ready返回true之前，不应调用此函数。

readonlytoken : String
Scene/ArcGisMapServerImageryProvider.js 265

获取用于使用ArcGIS MapServer服务进行身份验证的ArcGIS令牌。

readonlyurl : String
Scene/ArcGisMapServerImageryProvider.js 253

获取ArcGIS MapServer 的URL。

readonlyusingPrecachedTiles : Boolean
Scene/ArcGisMapServerImageryProvider.js 476

获取是否启使用预缓存瓦片。 如果图像提供器尚未准备就绪（ArcGisMapServerImageryProvider#ready），即使MapServer没有预缓存的瓦片， 此函数也会返回`options.usePreCachedTilesIfAvailable`的值。
Default Value: true

Methods

getTileCredits(x, y, level) → Array.<Credit>
Scene/ArcGisMapServerImageryProvider.js 519

获取当请求的瓦片被显示出来时，要显示的版权信息。
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
Scene/ArcGisMapServerImageryProvider.js 565

异步地确定哪些要素（如果有的话）位于瓦片中给定的经度和纬度。 在ImageryProvider#ready返回true之前，不应该调用此函数。 这个函数是可选的，所以它可能不存在于所有的ImageryProviders上。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的级别。
longitude Number 拾取要素的经度。
latitude Number 拾取要素的纬度。
Returns:
对所选要素的promise，它将在异步拾取完成时解析。 解析后的值是ImageryLayerFeatureInfo实例的数组。如果在给定位置没有发现任何要素，则该数组可能为空。 如果不支持拾取，它也可能是未定义的。
Throws:
  • DeveloperError : pickFeatures在图像提供器准备好之前不能被调用。

requestImage(x, y, level, request) → Promise.<(Image|Canvas)>|undefined
Scene/ArcGisMapServerImageryProvider.js 538

请求给定块的瓦片。 在ArcGisMapServerImageryProvider#ready返回true之前，不应调用此函数。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的层级。
request Request optional Request对象（仅供内部使用）。
Returns:
返回值有以下3种情况： 1.当图像可用时，返回对图像的Promise。 2.如果有太多对服务器的活动请求，则返回未定义图像，并且应该稍后重新请求。 3.解析后的图像可以是图像，也可以是画布DOM对象。
Throws:
  • DeveloperError : 准备好图像提供器之前，不得调用 requestImage 。