要构造 BingMapsImageryProvider,请调用
使用 Bing 地图图像 REST API 提供平铺图像。
BingMapsImageryProvider.fromUrl
. 不要直接调用构造函数。
Name | Type | Description |
---|---|---|
options |
BingMapsImageryProvider.ConstructorOptions | 描述初始化选项的对象 |
- BingMapsImageryProvider.fromUrl
- ArcGisMapServerImageryProvider
- GoogleEarthEnterpriseMapsProvider
- OpenStreetMapImageryProvider
- SingleTileImageryProvider
- TileMapServiceImageryProvider
- WebMapServiceImageryProvider
- WebMapTileServiceImageryProvider
- UrlTemplateImageryProvider
- Bing Maps REST Services
- Cross-Origin Resource Sharing
Example:
const bing = await Cesium.BingMapsImageryProvider.fromUrl(
"https://dev.virtualearth.net", {
key: "get-yours-at-https://www.bingmapsportal.com/",
mapStyle: Cesium.BingMapsStyle.AERIAL
});
See:
Members
获取或设置用于在制作人员名单中显示的 Bing 徽标的 URL。
readonly credit : Credit
获取此影像提供程序处于活动状态时要显示的点数。 通常,这用于贷记
图像的来源。
请求 Bing 地图图像时要使用的区域性。不
支持所有区域性。参见 http://msdn.microsoft.com/en-us/library/hh441729.aspx
以获取有关受支持区域性的信息。
readonly errorEvent : Event
获取在影像提供程序遇到异步错误时引发的事件。 通过订阅
时,您将收到错误通知,并可能从中恢复。 事件侦听器
将传递
TileProviderError
的实例。
获取一个值,该值指示此图像提供程序是否提供图像
包括 Alpha 通道。 如果此属性为 false,则 Alpha 通道(如果存在)将
被忽略。 如果此属性为 true,则将处理任何没有 Alpha 通道的图像
就好像它们的 alpha 在所有地方都是 1.0 一样。 将此属性设置为 false 可减少内存使用量
和纹理上传时间。
获取 Bing Maps 键。
获取 中定义的其他地图层选项 https://learn.microsoft.com/en-us/bingmaps/rest-services/imagery/get-imagery-metadata#template-parameters/
readonly mapStyle : BingMapsStyle
获取要加载的 Bing 地图图像的类型。
获取可请求的最大详细级别。
获取可请求的最小详细级别。
readonly proxy : Proxy
获取此提供程序使用的代理。
readonly rectangle : Rectangle
获取此实例提供的图像的矩形(以弧度为单位)。
readonly tileDiscardPolicy : TileDiscardPolicy
获取瓦片丢弃策略。 如果未 undefined,则 discard 策略负责
用于通过其 shouldDiscardImage 函数过滤掉“缺失”的瓦片。 如果此功能
返回 undefined,不过滤任何图块。
获取每个图块的高度(以像素为单位)。
获取每个图块的宽度(以像素为单位)。
readonly tilingScheme : TilingScheme
获取此提供程序使用的切片方案。
获取托管图像的 BingMaps 服务器 URL 的名称。
Methods
static Cesium.BingMapsImageryProvider.fromUrl(url, options) → Promise.<BingMapsImageryProvider>
创建一个
ImageryProvider
,它使用 Bing 地图图像 REST API 提供平铺图像。
Name | Type | Description |
---|---|---|
url |
Resource | String | 托管图像的 Bing 地图服务器的 URL。 |
options |
BingMapsImageryProvider.ConstructorOptions | 描述初始化选项的对象 |
Returns:
解析为创建的 BingMapsImageryProvider 的 Promise
Throws:
-
RuntimeError : metadata does not specify one resource in resourceSets
Example:
const bing = await Cesium.BingMapsImageryProvider.fromUrl(
"https://dev.virtualearth.net", {
key: "get-yours-at-https://www.bingmapsportal.com/",
mapStyle: Cesium.BingMapsStyle.AERIAL
});
将用于从 Bing Maps 服务器请求图像的瓦片的 quad 键转换为
(x, y, level) 位置。
Name | Type | Description |
---|---|---|
quadkey |
string | 瓦片的四键 |
- Bing Maps Tile System
- BingMapsImageryProvider#tileXYToQuadKey
See:
将图块 (x, y, level) 位置转换为用于请求图像的四边形键
从 Bing 地图服务器。
Name | Type | Description |
---|---|---|
x |
number | 瓦片的 x 坐标。 |
y |
number | 瓦片的 y 坐标。 |
level |
number | 磁贴的缩放级别。 |
- Bing Maps Tile System
- BingMapsImageryProvider#quadKeyToTileXY
See:
getTileCredits(x, y, level) → Array.<Credit>
获取在显示给定磁贴时要显示的制作者名单。
Name | Type | Description |
---|---|---|
x |
number | 瓦片 X 坐标。 |
y |
number | 瓦片 Y 坐标。 |
level |
number | 瓦片级别; |
Returns:
显示磁贴时要显示的制作者名单。
此图像提供程序目前不支持选取功能,因此此函数仅返回
定义。
Name | Type | Description |
---|---|---|
x |
number | 瓦片 X 坐标。 |
y |
number | 瓦片 Y 坐标。 |
level |
number | 瓦片级别。 |
longitude |
number | 选取特征的经度。 |
latitude |
number | 选取特征的纬度。 |
Returns:
Undefined,因为不支持拣选。
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
BingMapsImageryProvider 构造函数的初始化选项
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
key |
string |
<optional> |
应用程序的 Bing Maps 键,可以是 创建于 https://www.bingmapsportal.com/。 | |
tileProtocol |
string |
<optional> |
加载瓦片时使用的协议,例如 'http' 或 'https'。 默认情况下,磁贴使用与页面相同的协议加载。 | |
mapStyle |
BingMapsStyle |
<optional> |
BingMapsStyle.AERIAL | 要加载的 Bing 地图图像的类型。 |
mapLayer |
string |
<optional> |
在 https://learn.microsoft.com/en-us/bingmaps/rest-services/imagery/get-imagery-metadata#template-parameters 上定义的其他显示图层选项 | |
culture |
string |
<optional> |
'' | 请求 Bing 地图图像时要使用的区域性。不 支持所有区域性。参见 http://msdn.microsoft.com/en-us/library/hh441729.aspx 以获取有关受支持区域性的信息。 |
ellipsoid |
Ellipsoid |
<optional> |
Ellipsoid.default | 椭球体。 如果未指定,则使用默认椭球体。 |
tileDiscardPolicy |
TileDiscardPolicy |
<optional> |
确定瓦片是否
无效,应丢弃。 默认情况下,DiscardEmptyTileImagePolicy
,预期 Bing 地图服务器将针对缺失的图块发送零长度响应。
为确保不丢弃任何图块,请为此参数构造并传递 NeverTileDiscardPolicy 。 |