此天体通常不直接即时化,使用
提供由ArcGIS地图服务器主机的平面图像。 默认情况下,服务器的预留牌是
使用,如果有的话.
ArcGisMapServerImageryProvider.fromBasemapType 或 ArcGisMapServerImageryProvider.fromUrl .
An ArcGIS Access Token is required to authenticate requests to an ArcGIS Image Tile service. 要访问安全的ArcGIS资源,需要创建ArcGIS开发器 账户或ArcGIS在线账户,然后执行认证方法以获取访问令牌.
| 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
当图像提供者活动时, 获得信用值以显示 。 通常,这是用来信用的
图像的来源.
Gets or sets a value indicating whether feature picking is enabled. If true,
ArcGisMapServerImageryProvider#pickFeatures will
引用ArcGIS服务器上的"识别"操作并返回响应中包含的特性. 如果说错了,
ArcGisMapServerImageryProvider#pickFeatures will immediately return undefined (indicating no pickable features)
不与服务器通信.
-
Default Value:
true
readonly errorEvent : Event
获得一个在图像提供者遇到同步错误时上升的事件 。 通过签名
对事件,您将被通知错误,并有可能从中恢复。 活动听众
are passed an instance of
TileProviderError.
获得一个表示图像提供者是否提供的图像的值
包括一个α通道。 如果这个属性是虚假的, 一个 alpha 通道, 如果存在, 将会
将被忽略。 如果此属性属实, 任何没有 alpha 通道的图像都会被处理
好像他们的α是1.0 到处都是。 当此属性为虚假时, 内存使用
并缩短纹理上传时间.
-
Default Value:
true
获取图层ID的逗号分隔列表以显示.
获取可以请求的最多详细级别.
获取可以请求的最小详细级别.
readonly proxy : Proxy
获取此提供者使用的代理 .
readonly rectangle : Rectangle
用弧度表示这个例子提供的图像的矩形.
readonly tileDiscardPolicy : TileDiscardPolicy
获取瓷砖丢弃策略 。 如果未定义, 丢弃策略负责
用于通过它应当的DiscardImage函数过滤出“缺少”牌。 如果此函数
返回未定义,不过滤牌.
获得每个瓦片的高度,以像素为单位.
获得每个瓦片的宽度,以像素为单位.
readonly tilingScheme : TilingScheme
获得此提供者使用的平板方案 .
获取用于认证ArcGis MapServer服务的ArcGIS令牌.
获得ArcGIS地图服务器的 URL .
获得一个值,表明图像提供者是否使用来自
ArcGIS MapServer.
-
Default Value:
true
Methods
static Cesium.ArcGisMapServerImageryProvider.fromBasemapType(style, options) → Promise.<ArcGisMapServerImageryProvider>
Creates an
ImageryProvider which provides tiled imagery from an ArcGIS base map.
| Name | Type | Description |
|---|---|---|
style |
ArcGisBaseMapType |
The style of the ArcGIS base map imagery. Valid options are ArcGisBaseMapType.SATELLITE, ArcGisBaseMapType.OCEANS, and ArcGisBaseMapType.HILLSHADE. |
options |
ArcGisMapServerImageryProvider.ConstructorOptions | optional 描述初始化选项的对象 . |
Returns:
向创建的 ArcGisMapServerImagery 提供解答的承诺 .
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>
Creates an
ImageryProvider which provides tiled imagery hosted by an ArcGIS MapServer. By default, the server's pre-cached tiles are
使用,如果有的话.
| Name | Type | Description |
|---|---|---|
url |
Resource | string | ArcGIS地图服务器服务的 NT 0 . |
options |
ArcGisMapServerImageryProvider.ConstructorOptions | optional 描述初始化选项的对象 . |
Returns:
向创建的 ArcGisMapServerImagery 提供解答的承诺 .
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
/**
Asynchronously determines what features, if any, are located at a given longitude and latitude within
a tile.
| Name | Type | Description |
|---|---|---|
x |
number | 瓷砖X坐标. |
y |
number | 瓦片Y坐标. |
level |
number | 瓦片级. |
longitude |
number | 选择特征的经度 . |
latitude |
number | 选择特征的纬度. |
Returns:
承诺在同步时解决
picking completes. The resolved value is an array of
ImageryLayerFeatureInfo
实例。 如果在指定位置找不到任何特性, 阵列可能为空 .
requestImage(x, y, level, request) → Promise.<ImageryTypes>|undefined
请求给定的瓦片的图像 .
| Name | Type | Description |
|---|---|---|
x |
number | 瓷砖X坐标. |
y |
number | 瓦片Y坐标. |
level |
number | 瓦片级. |
request |
Request | optional 请求对象 。 仅供内部使用. |
Returns:
承诺在图像可用时解决图像,或
如果服务器的主动请求过多, 未定义, 请求应在稍后重审 .
Type Definitions
ArcGisMapServerImagery 创建器的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
tileDiscardPolicy |
TileDiscardPolicy |
<optional> |
确定是否为瓦片的策略
无效,应当丢弃。 如果未指定此值, 则默认值
DiscardMissingTileImagePolicy is used for tiled map servers, and a
NeverTileDiscardPolicy 用于非平面映射服务器. 在前一种情况下,
we request tile 0,0 at the maximum tile level and check pixels (0,0), (200,20), (20,200),
(80,110)和(160,130)。 如果所有这些像素都是透明的,则丢弃检查是
已禁用,没有瓦片被丢弃。 如果其中任何一种颜色不透明,任何
在这些像素位置具有相同值的瓦被丢弃 。 最终结果
这些默认值应该是标准ArcGIS服务器的正确瓦片丢弃。 确保
that no tiles are discarded, construct and pass a NeverTileDiscardPolicy for this
parameter. |
|
usePreCachedTilesIfAvailable |
boolean |
<optional> |
true | If true, the server's pre-cached 瓷砖可供使用。 导出图案只支持被贬值的API. |
layers |
string |
<optional> |
要显示的图层的逗号分隔列表, 或者如果显示所有图层则未定义 . | |
enablePickFeatures |
boolean |
<optional> |
true | If true, ArcGisMapServerImageryProvider#pickFeatures will invoke
地图服务器上的识别服务,并返回响应中包含的特性。 如果说错了,
ArcGisMapServerImageryProvider#pickFeatures will immediately return undefined (indicating no pickable features)
不与服务器通信。 如果您不希望此提供者的特性存在, 设置此属性为虚假
be pickable. Can be overridden by setting the ArcGisMapServerImageryProvider#enablePickFeatures property on the object. |
rectangle |
Rectangle |
<optional> |
Rectangle.MAX_VALUE | The rectangle of the layer. This parameter is ignored when accessing 一层砖. |
tilingScheme |
TilingScheme |
<optional> |
new GeographicTilingScheme() | The tiling scheme to use to divide the world into tiles. 访问平板服务器时忽略了此参数 . |
ellipsoid |
Ellipsoid |
<optional> |
Ellipsoid.default | The ellipsoid. If the tilingScheme is specified and used, 此参数被忽略, 并使用平面图的椭圆形 。 如果没有 指定参数,使用默认椭圆. |
credit |
Credit | string |
<optional> |
数据源的信用,在画布上显示。 访问平板服务器时忽略了此参数 . | |
tileWidth |
number |
<optional> |
256 | 每个瓦片的宽度以像素表示. 访问平板服务器时忽略了此参数 . |
tileHeight |
number |
<optional> |
256 | 每个瓦片的高度以像素表示. 访问平板服务器时忽略了此参数 . |
maximumLevel |
number |
<optional> |
请求的最大瓦片级别, 如果没有最大瓦片则未定义 。 此参数在访问时被忽略 一个平板服务器. |