MapLoaderArcGisMapServer

Constructor

new MapLoaderArcGisMapServer(options)

Author:

Example

var esri = new MapLoaderArcGisMapServer({
    url : 'https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer'
});
<p>
可用URl列表：
1. https://map.geoq.cn/ArcGIS/rest/services/ChinaOnlineStreetPurplishBlue/MapServer  蓝黑中文；<br>
2. https://map.geoq.cn/arcgis/rest/services/ChinaOnlineStreetGray/MapServer  灰色中文；<br>
3. https://map.geoq.cn/ArcGIS/rest/services/ChinaOnlineStreetWarm/MapServer  暖色中文；<br>
4. https://map.geoq.cn/arcgis/rest/services/ChinaOnlineCommunityENG/MapServer  彩色英文；<br>
5. http://map.geoq.cn/ArcGIS/rest/services/ChinaOnlineCommunity/MapServer  彩色中文；<br>
6. https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer  影像无标注；<br>
7. https://server.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer  街道英文；<br>
8. https://server.arcgisonline.com/ArcGIS/rest/services/Canvas/World_Light_Gray_Base/MapServer  灰色英文；<br>
9. https://server.arcgisonline.com/arcgis/rest/services/Canvas/World_Dark_Gray_Base/MapServer  灰黑英文；<br>
10. https://services.arcgisonline.com/arcgis/rest/services/Elevation/World_Hillshade/MapServer  海拔/山体阴影；<br>
11. https://server.arcgisonline.com/ArcGIS/rest/services/Ocean/World_Ocean_Base/MapServer  海洋基图；
      https://server.arcgisonline.com/ArcGIS/rest/services/Ocean_Basemap/MapServer  海洋带标注<br>
12. https://fly.maptiles.arcgis.com/arcgis/rest/services/World_Imagery_Firefly/MapServer  荧光基图；<br>
13. https://wtb.maptiles.arcgis.com/arcgis/rest/services/World_Topo_Base/MapServer  拓补基图；<br>
14. https://tiles.arcgis.com/tiles/P3ePLMYs2RVChkJx/arcgis/rest/services/Earth_at_Night_2016/MapServer  夜晚灯光；<br>
15. https://tiles.arcgis.com/tiles/4yjifSiIG17X0gW4/arcgis/rest/services/Senior_Population_Global_Dataset/MapServer  全球人口；7-13<br>
16. https://tiles.arcgis.com/tiles/VAI453sU9tG9rSmh/arcgis/rest/services/WorldGeo_Physical_Climate_Mean_Temp_January/MapServer  气候温度；[January, July]
17. https://tiles.arcgis.com/tiles/VAI453sU9tG9rSmh/arcgis/rest/services/WorldGeo_Physical_Elevation_Zones_tiles/MapServer  着色海拔；
18. https://sedac.ciesin.columbia.edu/arcgis/rest/services/sedac/wildareas_v2_last_of_the_wild/MapServer  冰川荒地；
19. https://sedac.ciesin.columbia.edu/arcgis/rest/services/sedac/groads_global_roads_open_access_v1/MapServer  全球公路；
20. https://gis.ngdc.noaa.gov/arcgis/rest/services/web_mercator/etopo1_hillshade/MapServer  彩色底图；
</p>

Parameters:

Name Type Description

options

Object

此对象拥有以下属性：

Properties

Name	Type	Attributes	Default	Description
`id`	String	<optional>		该地图加载器的ID。
`name`	String	<optional>		该地图加载器的名称。
`url`	Cesium.Resource \| String			ArcGIS MapServer服务的URL。
`token`	String	<optional>		ArcGIS令牌用于使用ArcGIS MapServer服务进行身份验证。
`tileDiscardPolicy`	Cesium.TileDiscardPolicy	<optional>		确定某个瓦片是否无效并应被丢弃的策略。如果未指定此值，则默认的`Cesium.DiscardMissingTileImagePolicy`用于瓦片地图服务器，而`Cesium.NeverTileDiscardPolicy`用于非瓦片地图服务器。
`usePreCachedTilesIfAvailable`	Boolean	<optional>	`true`	如果为true，则使用服务器预先缓存的瓦片（如果它们可用）。如果为false，则忽略任何预先缓存的瓦片并使用'export'服务。
`layers`	String	<optional>		要显示图的层的逗号分隔列表，如果应该显示所有图层，则为未定义的列表。
`enablePickFeatures`	Boolean	<optional>	`true`	是否拾取要素。可以通过在对象上设置`MapLoaderArcGisMapServer#enablePickFeatures`属性来重写。
`rectangle`	Cesium.Rectangle	<optional>	`Cesium.Rectangle.MAX_VALUE`	图层矩形范围。访问瓦片图层时，将忽略此参数。
`tilingScheme`	Cesium.TilingScheme	<optional>	`new Cesium.GeographicTilingScheme()`	切片方案。访问切片服务器时，将忽略此参数。
`ellipsoid`	Cesium.Ellipsoid	<optional>		椭球。如果指定并使用了tilingScheme，则将忽略此参数，而是使用切片方案指定的的椭球。如果未指定任何参数，则使用WGS84椭球。
`credit`	Cesium.Credit \| String	<optional>		版权。访问切片服务器时，将忽略此参数。
`tileWidth`	Number	<optional>	`256`	瓦片宽度（以像素为单位）。访问切片服务器时，将忽略此参数。
`tileHeight`	Number	<optional>	`256`	瓦片高度（以像素为单位）。访问切片服务器时，将忽略此参数。
`maximumLevel`	Number	<optional>		要请求的最大图块级别，如果没有最大值，则未定义。访问切片服务器时，将忽略此参数。

Extends

MapLoader

Members

(readonly) credit :Cesium.Credit

Overrides:

MapLoader#credit

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

Type:

Cesium.Credit

enablePickFeatures :Boolean

Default Value:

true

指示是否启用要素拾取。如果为true，MapLoaderArcGisMapServer#pickFeatures将调用MapServer上的Identify服务并返回响应中包含的要素。如果为false， MapLoaderArcGisMapServer#pickFeatures将立即返回undefined（表示没有可拾取的要素），而不与服务器通信。

Type:

Boolean

(readonly) errorEvent :Cesium.Event

Overrides:

MapLoader#errorEvent

获取此加载器遇到异步错误时触发的事件。

Type:

Cesium.Event

(readonly) hasAlphaChannel :Boolean

Overrides:

MapLoader#hasAlphaChannel

获取影像是否有Alpha通道。

Type:

Boolean

(readonly) id :String

Overrides:

MapLoader#id

获取ID。

Type:

String

layers :String

要显示的图层ID。

Type:

String

(readonly) maximumLevel :Number

Overrides:

MapLoader#maximumLevel

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

Type:

Number

(readonly) minimumLevel :Number

Overrides:

MapLoader#minimumLevel

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

Type:

Number

(readonly) provider :Boolean

Overrides:

MapLoader#provider

获取此瓦片加载器包装的图形提供器。

Type:

Boolean

(readonly) proxy :Cesium.Proxy

Overrides:

MapLoader#proxy

获取此加载器使用的代理。

Type:

Cesium.Proxy

(readonly) ready :Boolean

Overrides:

MapLoader#ready

获取加载器是否已准备好。

Type:

Boolean

(readonly) readyPromise :Promise.<Boolean>

Overrides:

MapLoader#readyPromise

获取在加载器准备就绪时可以解析为true的Promise。

Type:

Promise.<Boolean>

(readonly) rectangle :Cesium.Rectangle

Overrides:

MapLoader#rectangle

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

Type:

Cesium.Rectangle

(readonly) tileDiscardPolicy :Cesium.TileDiscardPolicy

Overrides:

MapLoader#tileDiscardPolicy

获取瓦片丢弃策略。在 MapLoader#ready 返回true之前，不应调用此函数。

Type:

Cesium.TileDiscardPolicy

(readonly) tileHeight :Number

Overrides:

MapLoader#tileHeight

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

Type:

Number

(readonly) tileWidth :Number

Overrides:

MapLoader#tileWidth

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

Type:

Number

(readonly) tilingScheme :Cesium.TilingScheme

Overrides:

MapLoader#tilingScheme

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

Type:

Cesium.TilingScheme

(readonly) token :String

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

Type:

String

(readonly) url :String

ArcGIS MapServer 的URL。

Type:

String

(readonly) usingPrecachedTiles :Boolean

Default Value:

true

是否使用预缓存瓦片。

Type:

Boolean

Methods

getTileCredits(x, y, level) → {Array.<Cesium.Credit>}

Overrides:

MapLoader#getTileCredits

获取当请求的瓦片被显示出来时，要显示的版权信息。

Parameters:

Name	Type	Description
`x`	Number	瓦片的X坐标。
`y`	Number	瓦片的Y坐标。
`level`	Number	瓦片的层级。

Throws:

在图像提供器准备就绪之前，不得调用 getTileCredits 。
Type Cesium.DeveloperError

Returns:

返回的版权。

Type: Array.<Cesium.Credit>

pickFeatures(x, y, level, longitude, latitude) → {Promise.<Array.<Cesium.ImageryLayerFeatureInfo>>|undefined}

异步地确定哪些要素（如果有的话）位于瓦片中给定的经度和纬度。在MapLoaderArcGisMapServer#ready返回true之前，不应该调用此函数。这个函数是可选的，所以它可能不存在于所有的MapLoaders上。

Parameters:

Name	Type	Description
`x`	Number	瓦片的X坐标。
`y`	Number	瓦片的Y坐标。
`level`	Number	瓦片的级别。
`longitude`	Number	拾取要素的经度。
`latitude`	Number	拾取要素的纬度。

Throws:

pickFeatures在图像提供器准备好之前不能被调用。
Type Cesium.DeveloperError

Returns:

对所选要素的promise，它将在异步拾取完成时解析。解析后的值是Cesium.ImageryLayerFeatureInfo实例的数组。如果在给定位置没有发现任何要素，则该数组可能为空。如果不支持拾取，它也可能是未定义的。

Type: Promise.<Array.<Cesium.ImageryLayerFeatureInfo>> | undefined

requestImage(x, y, level, requestopt) → {Promise.<(Image|Canvas)>|undefined}

Overrides:

MapLoader#requestImage

请求给定块的瓦片。在MapLoaderArcGisMapServer#ready返回true之前，不应调用此函数。

Parameters:

Name	Type	Attributes	Description
`x`	Number		瓦片的X坐标。
`y`	Number		瓦片的Y坐标。
`level`	Number		瓦片的层级。
`request`	Cesium.Request	<optional>	Request对象（仅供内部使用）。

Throws:

准备好图像提供器之前，不得调用 requestImage 。
Type Cesium.DeveloperError

Returns:

返回值有以下3种情况： 1.当图像可用时，返回对图像的Promise。 2.如果有太多对服务器的活动请求，则返回未定义图像，并且应该稍后重新请求。 3.解析后的图像可以是图像，也可以是画布DOM对象。

Type: Promise.<(Image|Canvas)> | undefined