Cesium文档翻译--ArcGisMapServerImageryProvider

new Cesium.ArcGisMapServerImageryProvider(options)
由ArcGIS MapServer托管的瓦片图像。默认情况下，如果可用，将使用服务器的预缓存块。

名称	类型	描述
options	ArcGisMapServerImageryProvider.ConstructorOptions	初始化选项

示例

var esri = new Cesium.ArcGisMapServerImageryProvider({
    url : 'https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer'
});

成员变量

名称	操作	类型	默认值	描述
credit	只读	Credit	获取当此图像提供程序处于活动状态时要显示的credit，用来确定图像来源。在ArcGisMapServerImageryProvider#ready返回true之后调用
defaultAlpha		Number|undefined	undefined	默认alpha混合值，0.0表示完全透明，1.0表示完全不透明
defaultBrightness		Number|undefined	undefined	默认亮度值，1.0使用未经修改的图像颜色。小于1.0则图像变暗，大于1.0则图像变亮
defaultContrast		Number|undefined	undefined	默认对比度，1.0使用未经修改的图像颜色。小于1.0会降低对比度，大于1.0则会增加对比度
defaultDayAlpha		Number|undefined	undefined	地球日面的默认alpha混合值，0.0表示完全透明，1.0表示完全不透明
defaultGamma		Number|undefined	undefined	默认gamma校正。1.0使用未经修改的图像颜色
defaultHue		Number|undefined	undefined	默认色调(以弧度为单位)。0.0使用未经修改的图像颜色
defaultMagnificationFilter		TextureMagnificationFilter	undefined	默认纹理放大过滤器
defaultNightAlpha		Number|undefined	undefined	地球的夜晚侧默认的alpha混合值，0.0表示完全透明，1.0表示完全不透明
defaultSaturation		Number|undefined	undefined	默认饱和度。1.0使用未经修改的图像颜色。小于1.0会降低饱和度，大于1.0则会增加饱和度
enablePickFeatures		Boolean	true	获取或设置一个值，该值指示是否启用特性选择。如果为true, ArcGisMapServerImageryProvider#pickFeatures将调用ArcGIS服务器上的“identify”操作，并返回响应中包含的特性。如果为false, ArcGisMapServerImageryProvider#pickFeatures不需要与服务器通信并立即返回undefined(表示没有可选特性)
errorEvent	只读	Event		获取当图像提供程序遇到异步错误时引发的事件。通过订阅事件，您将得到错误通知，并可能从中恢复。传递给事件监听器一个TileProviderError实例
hasAlphaChannel	只读	Boolean	true	获取一个值，该值指示此图像提供程序提供的图像是否包含alpha通道。如果该属性为false, alpha通道(如果存在)将被忽略。如果该属性为真，任何没有alpha通道的图像都将被视为其alpha值为1.0。当此属性为false时，内存使用和纹理上传时间将减少
layers		String		获取要显示的以逗号分隔的图层id列表
maximumLevel	只读	Number|undefined		获取可以请求的最大详细级别。在ArcGisMapServerImageryProvider#ready返回true之后调用
minimumLevel	只读	Number		获取可以请求的最小细节级别。在ArcGisMapServerImageryProvider#ready返回true之后调用
proxy	只读	Proxy		获取代理
ready	只读	Boolean		获取一个值，该值指示提供程序是否已准备好可供使用
readyPromise	只读	Promise.<Boolean>		获取一个promise，该promise在提供程序准备好使用时解析为true
rectangle	只读	Rectangle		获取此实例提供的图像的矩形(以弧度为单位)。在ArcGisMapServerImageryProvider#ready返回true之后调用
tileDiscardPolicy	只读	TileDiscardPolicy		获取块丢弃策略。如果没有未定义，discard策略负责通过shouldDiscardImage函数过滤掉“缺失的”贴图。如果该函数返回undefined，则不过滤贴片。在ArcGisMapServerImageryProvider#ready返回true之后调用
tileHeight	只读	Number		获取每个贴图的高度(以像素为单位)。在ArcGisMapServerImageryProvider#ready返回true之后调用
tilingScheme	只读	TilingScheme		获取使用的平铺方案。在ArcGisMapServerImageryProvider#ready返回true之后调用
token	只读	String		获取用于与ArcGIS MapServer服务进行身份验证的ArcGIS token
url	只读	String		获取ArcGIS MapServer的URL
usingPrecachedTiles	只读	Boolean	true	获取一个值，该值指示此图像提供程序是否使用了来自ArcGIS MapServer的预缓存贴图。如果图像提供程序还没有准备好(ArcGisMapServerImageryProvider#ready)，这个函数将返回‘options’的值。使用preCachedtilesifavailable '，即使MapServer没有预缓存的贴图

方法

getTileCredits(x, y, level) → Array.<Credit>
返回值： the credits to be displayed when the tile is displayed
异常：DeveloperError : getTileCredits must not be called before the imagery provider is ready.

名称	类型	描述
x	Number	瓦片X坐标
y	Number	瓦片Y坐标
level	Number	瓦片层级

pickFeatures(x, y, level, longitude, latitude) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined
返回值：ImageryLayerFeatureInfo实例的数组
异常：DeveloperError : pickFeatures must not be called before the imagery provider is ready.

名称	类型	描述
x	Number	瓦片X坐标
y	Number	瓦片Y坐标
level	Number	瓦片层级
longitude	Number	经度
latitude	Number	纬度

requestImage(x, y, level, request) → Promise.<(HTMLImageElement|HTMLCanvasElement)>|undefined
返回值：
异常：DeveloperError : requestImage must not be called before the imagery provider is ready.

名称	类型	描述
x	Number	瓦片X坐标
y	Number	瓦片Y坐标
level	Number	瓦片层级
request	Request	可选：请求对象，仅供内部使用

类型定义

Cesium.ArcGisMapServerImageryProvider.ConstructorOptions
ArcGisMapServerImageryProvider构造函数的初始化选项

名称	类型	属性	默认值	描述
url	Resource | String			ArcGIS MapServer服务的URL
token	String			用于ArcGIS MapServer服务认证的token
tileDiscardPolicy	TileDiscardPolicy			块丢弃策略，如果不指定此值，则默认的DiscardMissingTileImagePolicy用于平铺地图服务器，而NeverTileDiscardPolicy用于非平铺地图服务器。在前一种情况下，我们请求最大贴图级别的贴图0,0，并检查像素(0,0)、(200,20)、(20,200)、(80,110)和(160,130)。如果所有这些像素都是透明的，丢弃检查是禁用的，没有块被丢弃。如果它们中的任何一个具有非透明颜色，那么在这些像素位置中具有相同值的任何贴图都将被丢弃。对于标准的ArcGIS服务器，这些默认值的最终结果应该是正确的tile丢弃。为了确保没有瓷砖被丢弃，为这个参数构造并传递一个NeverTileDiscardPolicy
usePreCachedTilesIfAvailable	Boolean		true	如果为真，则使用服务器的预缓存块(如果它们可用)。如果为false，则忽略任何预缓存的块，并使用’export’服务
layers	String			用逗号分隔的要显示的层列表，如果应该显示所有的层则不需要定义
enablePickFeatures	Boolean		true	如果为true, ArcGisMapServerImageryProvider#pickFeatures将调用MapServer上的Identify服务，并返回响应中包含的特性。如果为false, ArcGisMapServerImageryProvider#pickFeatures将立即返回undefined(表示没有可选特性)，而不需要与服务器通信。如果您不希望此提供程序的特性是可选的，则将此属性设置为false。可以通过设置ArcGisMapServerImageryProvider#enablePickFeatures属性覆盖对象
rectangle	Rectangle		Rectangle.MAX_VALUE	图层的矩形。当访问平铺层时，此参数将被忽略
tilingScheme	TilingScheme		new GeographicTilingScheme()	The tiling scheme to use to divide the world into tiles. This parameter is ignored when accessing a tiled server.
ellipsoid	Ellipsoid			椭球。如果指定并使用了tiingscheme，则忽略此参数，使用tiingscheme的椭球体代替。如果两个参数都没有指定，则使用WGS84椭球
credit	Credit | String			A credit for the data source, which is displayed on the canvas. This parameter is ignored when accessing a tiled server.
tileWidth	Number		256	每个贴图的宽度，以像素为单位. This parameter is ignored when accessing a tiled server.
tileHeight	Number	<optional>	256	每个贴图的高度，以像素为单位. This parameter is ignored when accessing a tiled server.
maximumLevel	Number			请求的最大图层级别. This parameter is ignored when accessing a tiled server.