ArcGisMapServerImageryProvider

new SuperMap3D.ArcGisMapServerImageryProvider(options)

提供由ArcGIS MapServer托管的切图影像。默认情况下，如果可用，使用服务器的预缓存瓦片。
Name Type Description
options Object 具有以下属性的对象:
Name Type Default Description
url String ArcGIS MapServer服务的URL。
token String optional 用于与ArcGIS MapServer服务进行身份验证的ArcGIS令牌。
tileDiscardPolicy TileDiscardPolicy optional 确定瓦片是否无效并应该被丢弃的策略。 如果这个值没有被指定，对于切图地图服务器，默认使用DiscardMissingTileImagePolicy，对于非切图地图服务器，默认使用NeverTileDiscardPolicy。 在前一种情况下，我们请求最高瓦片级别的0,0瓦片，然后检查像素点(0,0)，(200,20)，(20,200)，(80,110)和(160, 130)。 如果所有这些像素点都是透明的，则丢弃检查被禁用，没有瓦片被丢弃。 如果它们中任何一个有非透明颜色，任何在这些像素位置具有相同值的瓦片将被丢弃。 这些默认值的最终结果应该是对于标准ArcGIS服务器的正确瓦片丢弃。 为确保没有瓦片被丢弃，构建并传递一个NeverTileDiscardPolicy作为此参数。
proxy Proxy optional 用于请求的代理。如果需要，该对象应具有一个 getURL 函数，用于返回代理 URL。
usePreCachedTilesIfAvailable Boolean true optional 如果为true，将使用服务器的预缓存瓦片（如果可用）。如果为false，将忽略任何预缓存瓦片，并使用export服务。
layers String optional 使用逗号分隔要显示的图层列表，或者如果所有图层都应该显示，则为undefined。
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 椭球体。如果指定并使用了切图方案，该参数将被忽略，取而代之的是切图方案的椭球体。如果两个参数都未指定，则使用 WGS84 椭球。
tileWidth Number 256 optional 每个瓦片的像素宽度。在访问切图服务器时，此参数将被忽略。
tileHeight Number 256 optional 每个瓦片的像素高度。在访问切图服务器时，此参数将被忽略。
maximumLevel Number optional 要请求的最大瓦片级别，或者如果没有最大值则为undefined。在访问切图服务器时，此参数将被忽略。
Example:
var esri = new SuperMap3D.ArcGisMapServerImageryProvider({
    url : 'https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer'
});
See:

Members

readonlycredit : Credit

获取当此影像provider处于活动状态时显示的凭证。通常，这用于影像的来源。在ArcGisMapServerImageryProvider#ready返回true之前，不应调用此函数。

enablePickFeatures : Boolean

获取或设置指示是否启用特征选择的值。 如果为true，ArcGisMapServerImageryProvider#pickFeatures 将调用 ArcGIS 服务器上的识别操作，并返回响应中包含的特征。 如果为false，ArcGisMapServerImageryProvider#pickFeatures将立即返回undefined（表示没有可选取的特征），而不会与服务器通信。
Default Value: true

readonlyerrorEvent : Event

获取一个事件，当影像provider遇到异步错误时触发。通过订阅此事件，您将被通知错误，并有可能从中恢复。事件监听器将接收到一个TileProviderError实例。

readonlyhasAlphaChannel : Boolean

获取一个值，指示此影像provider提供的影像是否包含alpha通道。如果这个属性为false，即使存在alpha通道，也会被忽略。 如果这个属性为true，任何没有alpha通道的影像将被视为其alpha值在所有地方都是1.0。当这个属性为false时，内存使用量和纹理上传时间都会减少。
Default Value: true

layers : String

获取要显示的以逗号分隔的层id列表。

readonlymaximumLevel : Number

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

readonlyminimumLevel : Number

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

readonlyproxy : Proxy

获取该提供程序使用的代理。

readonlyready : Boolean

获取一个值，指示provider是否准备好供使用。

readonlyreadyPromise : Promise.<Boolean>

获取一个promise，当provider准备好供使用时为true。

readonlyrectangle : Rectangle

获取此实例提供的影像的矩形范围，以弧度为单位。在ArcGisMapServerImageryProvider#ready返回true之前，不应调用此函数。

readonlytileDiscardPolicy : TileDiscardPolicy

获取瓦片丢弃策略。如果没有定义，丢弃策略负责通过其shouldDiscardImage函数过滤掉缺失的瓦片。 如果这个函数返回undefined，则没有瓦片被过滤。在ArcGisMapServerImageryProvider#ready返回true之前，不应调用此函数。

readonlytileHeight : Number

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

readonlytileWidth : Number

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

readonlytilingScheme : TilingScheme

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

readonlytoken : String

获取用于验证 ArcGis MapServer 服务的 ArcGIS 令牌。

readonlyurl : String

获取 ArcGIS MapServer 的 URL。

readonlyusingPrecachedTiles : Boolean

获取一个值，指示此影像provider是否正在使用来自ArcGIS MapServer的预缓存瓦片。 如果影像 provider 尚未准备好（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 : 在影像Provider准备好之前，不能调用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:
一个对选中要素的Promise，当异步拾取完成时将解决。解决的值是一个ImageryLayerFeatureInfo实例数组。如果给定位置没有发现要素，则数组可能为空。
Throws:
  • DeveloperError : 在影像 provider准备好之前，不能调用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 optional 请求对象。仅供内部使用。
Returns:
一个影像的Promise，当影像可用时将解决，或者如果对服务器的活跃请求太多，并且请求应该稍后重试，则为undefined。 解决的影像可以是Image或Canvas DOM对象。
Throws:
  • DeveloperError : 在影像Provider准备好之前，不能调用 requesttimage 。