此对象通常不直接实例化,请使用
提供由 ArcGIS MapServer 托管的切片影像。 默认情况下,服务器的预缓存切片为
二手(如果有)。
ArcGisMapServerImageryProvider.fromBasemapType
或 ArcGisMapServerImageryProvider.fromUrl
。
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
readonly credit : Credit
获取此影像提供程序处于活动状态时要显示的点数。 通常,这用于贷记
图像的来源。
获取或设置一个值,该值指示是否启用功能选取。 如果为 true,则
ArcGisMapServerImageryProvider#pickFeatures
将
在 ArcGIS 服务器上调用 “identify” 操作并返回响应中包含的要素。 如果为 false,则
ArcGisMapServerImageryProvider#pickFeatures
将立即返回 undefined(表示没有可选取的要素)
而不与服务器通信。
-
Default Value:
true
readonly errorEvent : Event
获取在影像提供程序遇到异步错误时引发的事件。 通过订阅
时,您将收到错误通知,并可能从中恢复。 事件侦听器
将传递
TileProviderError
的实例。
获取一个值,该值指示此图像提供程序是否提供图像
包括 Alpha 通道。 如果此属性为 false,则 Alpha 通道(如果存在)将
被忽略。 如果此属性为 true,则将处理任何没有 Alpha 通道的图像
就好像它们的 alpha 在所有地方都是 1.0 一样。 当此属性为 false 时,内存使用情况
和纹理上传时间缩短。
-
Default Value:
true
获取要显示的图层 ID 的逗号分隔列表。
获取可请求的最大详细级别。
获取可请求的最小详细级别。
readonly proxy : Proxy
获取此提供程序使用的代理。
readonly rectangle : Rectangle
获取此实例提供的图像的矩形(以弧度为单位)。
readonly tileDiscardPolicy : TileDiscardPolicy
获取瓦片丢弃策略。 如果未 undefined,则 discard 策略负责
用于通过其 shouldDiscardImage 函数过滤掉“缺失”的瓦片。 如果此功能
返回 undefined,不过滤任何图块。
获取每个图块的高度(以像素为单位)。
获取每个图块的宽度(以像素为单位)。
readonly tilingScheme : TilingScheme
获取此提供程序使用的切片方案。
获取用于对 ArcGis MapServer 服务进行身份验证的 ArcGIS 令牌。
获取 ArcGIS MapServer 的 URL。
获取一个值,该值指示此影像提供商是否正在使用
ArcGIS 地图服务器。
-
Default Value:
true
Methods
static Cesium.ArcGisMapServerImageryProvider.fromBasemapType(样式, options) → Promise.<ArcGisMapServerImageryProvider>
创建一个
ImageryProvider
,用于提供来自 ArcGIS 底图的切片影像。
Name | Type | Description |
---|---|---|
样式 |
ArcGisBaseMapType |
ArcGIS 底图影像的样式。有效选项为 ArcGisBaseMapType.SATELLITE 、ArcGisBaseMapType.OCEANS 和 ArcGisBaseMapType.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
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。 访问 平铺服务器。 |