ArcGisMapServerImageryProvider

new Cesium.ArcGisMapServerImageryProvider(options)

此对象通常不直接实例化,请使用 ArcGisMapServerImageryProvider.fromBasemapTypeArcGisMapServerImageryProvider.fromUrl
提供由 ArcGIS MapServer 托管的切片影像。 默认情况下,服务器的预缓存切片为 二手(如果有)。
ArcGIS Access Token 需要对 ArcGIS Image Tile 服务的请求进行身份验证。 要访问安全的 ArcGIS 资源,需要创建 ArcGIS 开发人员 帐户或 ArcGIS Online 帐户,然后实施身份验证方法以获取访问令牌。
Name Type Description
options ArcGisMapServerImageryProvider.ConstructorOptions optional 描述初始化选项的对象
Examples:
// Set the default access token for accessing ArcGIS Image Tile service
Cesium.ArcGisMapService.defaultAccessToken = "<ArcGIS Access Token>";

// Add a base layer from a default ArcGIS basemap
const viewer = new Cesium.Viewer("cesiumContainer", {
  baseLayer: Cesium.ImageryLayer.fromProviderAsync(
    Cesium.ArcGisMapServerImageryProvider.fromBasemapType(
      Cesium.ArcGisBaseMapType.SATELLITE
    )
  ),
});
// Create an imagery provider from the url directly
const esri = await Cesium.ArcGisMapServerImageryProvider.fromUrl(
  "https://ibasemaps-api.arcgis.com/arcgis/rest/services/World_Imagery/MapServer", {
    token: "<ArcGIS Access Token>"
});
See:

Members

获取此影像提供程序处于活动状态时要显示的点数。 通常,这用于贷记 图像的来源。
获取或设置一个值,该值指示是否启用功能选取。 如果为 true,则 ArcGisMapServerImageryProvider#pickFeatures 将 在 ArcGIS 服务器上调用 “identify” 操作并返回响应中包含的要素。 如果为 false,则 ArcGisMapServerImageryProvider#pickFeatures 将立即返回 undefined(表示没有可选取的要素) 而不与服务器通信。
Default Value: true
获取在影像提供程序遇到异步错误时引发的事件。 通过订阅 时,您将收到错误通知,并可能从中恢复。 事件侦听器 将传递 TileProviderError 的实例。
获取一个值,该值指示此图像提供程序是否提供图像 包括 Alpha 通道。 如果此属性为 false,则 Alpha 通道(如果存在)将 被忽略。 如果此属性为 true,则将处理任何没有 Alpha 通道的图像 就好像它们的 alpha 在所有地方都是 1.0 一样。 当此属性为 false 时,内存使用情况 和纹理上传时间缩短。
Default Value: true
获取要显示的图层 ID 的逗号分隔列表。

readonly maximumLevel : number|undefined

获取可请求的最大详细级别。
获取可请求的最小详细级别。
获取此提供程序使用的代理。
获取此实例提供的图像的矩形(以弧度为单位)。
获取瓦片丢弃策略。 如果未 undefined,则 discard 策略负责 用于通过其 shouldDiscardImage 函数过滤掉“缺失”的瓦片。 如果此功能 返回 undefined,不过滤任何图块。
获取每个图块的高度(以像素为单位)。
获取每个图块的宽度(以像素为单位)。
获取此提供程序使用的切片方案。
获取用于对 ArcGis MapServer 服务进行身份验证的 ArcGIS 令牌。
获取 ArcGIS MapServer 的 URL。

readonly usingPrecachedTiles : boolean

获取一个值,该值指示此影像提供商是否正在使用 ArcGIS 地图服务器。
Default Value: true

Methods

static Cesium.ArcGisMapServerImageryProvider.fromBasemapType(样式, options)Promise.<ArcGisMapServerImageryProvider>

创建一个 ImageryProvider,用于提供来自 ArcGIS 底图的切片影像。
Name Type Description
样式 ArcGisBaseMapType ArcGIS 底图影像的样式。有效选项为 ArcGisBaseMapType.SATELLITEArcGisBaseMapType.OCEANSArcGisBaseMapType.HILLSHADE
options ArcGisMapServerImageryProvider.ConstructorOptions optional 描述初始化选项的对象.
Returns:
解析为创建的 ArcGisMapServerImageryProvider 的 Promise。
Examples:
// Set the default access token for accessing ArcGIS Image Tile service
Cesium.ArcGisMapService.defaultAccessToken = "<ArcGIS Access Token>";

// Add a base layer from a default ArcGIS basemap
const provider = await Cesium.ArcGisMapServerImageryProvider.fromBasemapType(
  Cesium.ArcGisBaseMapType.SATELLITE);
// Add a base layer from a default ArcGIS Basemap
const viewer = new Cesium.Viewer("cesiumContainer", {
  baseLayer: Cesium.ImageryLayer.fromProviderAsync(
    Cesium.ArcGisMapServerImageryProvider.fromBasemapType(
      Cesium.ArcGisBaseMapType.HILLSHADE, {
        token: "<ArcGIS Access Token>"
      }
    )
  ),
});

static Cesium.ArcGisMapServerImageryProvider.fromUrl(url, options)Promise.<ArcGisMapServerImageryProvider>

创建一个 ImageryProvider,该提供商由 ArcGIS MapServer 托管的切片影像。 默认情况下,服务器的预缓存切片为 二手(如果有)。
Name Type Description
url Resource | String ArcGIS MapServer 服务的 URL。
options ArcGisMapServerImageryProvider.ConstructorOptions optional 描述初始化选项的对象.
Returns:
解析为创建的 ArcGisMapServerImageryProvider 的 Promise。
Throws:
  • RuntimeError : metadata spatial reference specifies an unknown WKID
  • RuntimeError : metadata fullExtent.spatialReference specifies an unknown WKID
Example:
const esri = await Cesium.ArcGisMapServerImageryProvider.fromUrl(
    "https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer"
);

getTileCredits(x, y, level)Array.<Credit>

获取在显示给定磁贴时要显示的制作者名单。
Name Type Description
x number 瓦片 X 坐标。
y number 瓦片 Y 坐标。
level number 瓦片级别;
Returns:
显示磁贴时要显示的制作者名单。

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

异步确定哪些要素(如果有)位于给定的经度和纬度 一个图块。
Name Type Description
x number 瓦片 X 坐标。
y number 瓦片 Y 坐标。
level number 瓦片级别。
longitude number 选取特征的经度。
latitude number 选取特征的纬度。
Returns:
对所选特征的 Promise,当异步 拣选完成。 解析的值是 ImageryLayerFeatureInfo 的数组 实例。 如果在给定位置未找到要素,则数组可能为空。

requestImage(x, y, level, request)Promise.<ImageryTypes>|undefined

请求给定磁贴的图像。
Name Type Description
x number 瓦片 X 坐标。
y number 瓦片 Y 坐标。
level number 瓦片级别。
request Request optional 请求对象。仅供内部使用。
Returns:
映像的 Promise,该 Promise 将在映像可用时解析,或者 undefined 如果对服务器的活动请求过多,则应稍后重试该请求。

Type Definitions

Cesium.ArcGisMapServerImageryProvider.ConstructorOptions

ArcGisMapServerImageryProvider 构造函数的初始化选项
Properties:
Name Type Attributes Default Description
tileDiscardPolicy TileDiscardPolicy <optional>
确定瓦片是否 无效,应丢弃。 如果未指定此值,则默认为 DiscardMissingTileImagePolicy 用于平铺地图服务器,而 NeverTileDiscardPolicy 用于非平铺地图服务器。 在前一种情况下, 我们在最大瓦片级别请求瓦片 0,0 并检查像素 (0,0)、(200,20)、(20,200)、 (80,110) 和 (160, 130)。 如果所有这些像素都是透明的,则丢弃校验为 禁用且不会丢弃任何牌。 如果其中任何一个具有不透明的颜色,则任何 在这些像素位置具有相同值的瓦片将被丢弃。 的最终结果 对于标准 ArcGIS Server,这些默认值应该是正确的切片丢弃。 为了确保 没有丢弃任何图块,为此构造并传递一个 NeverTileDiscardPolicy 参数。
usePreCachedTilesIfAvailable boolean <optional>
true 如果为 true,则服务器的预缓存 如果有瓦片,则使用瓦片。只有已弃用的 API 才支持导出切片。
layers string <optional>
要显示的图层的逗号分隔列表,如果应显示所有图层,则为 undefined。
enablePickFeatures boolean <optional>
true 如果为 true,则 ArcGisMapServerImageryProvider#pickFeatures 将调用 MapServer 上的 Identify 服务并返回响应中包含的要素。 如果为 false,则 ArcGisMapServerImageryProvider#pickFeatures 将立即返回 undefined(表示没有可选取的要素) 而不与服务器通信。 如果不希望此提供程序的功能 是可挑选的。可以通过在对象上设置 ArcGisMapServerImageryProvider#enablePickFeatures 属性来覆盖。
rectangle Rectangle <optional>
Rectangle.MAX_VALUE 图层的矩形。 访问 平铺层。
tilingScheme TilingScheme <optional>
new GeographicTilingScheme() 用于将世界划分为多个图块的平铺方案。 访问平铺服务器时,将忽略此参数。
ellipsoid Ellipsoid <optional>
Ellipsoid.default 椭球体。 如果指定并使用了 tilingScheme,则 此参数将被忽略,而使用切片方案的椭球体。如果两者都不是 参数,则使用默认椭球。
credit Credit | string <optional>
数据源的积分,显示在画布上。 访问平铺服务器时,将忽略此参数。
tileWidth number <optional>
256 每个图块的宽度(以像素为单位)。 访问平铺服务器时,将忽略此参数。
tileHeight number <optional>
256 每个图块的高度(以像素为单位)。 访问平铺服务器时,将忽略此参数。
maximumLevel number <optional>
要请求的最大图块级别,如果没有最大值,则为 undefined。 访问 平铺服务器。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.