通常不直接实例化此对象,应使用
从 Google 2D Tiles 提供 2D 图像瓦片。
Google 2D Tiles 只能与 Google 地理编码器一起使用。
Google2DImageryProvider.fromIonAssetId 或 Google2DImageryProvider.fromUrl。
| Name | Type | Description |
|---|---|---|
options |
Google2DImageryProvider.ConstructorOptions | 描述初始化选项的对象 |
Examples:
// Google 2D 影像提供器
const googleTilesProvider = Cesium.Google2DImageryProvider.fromIonAssetId({
assetId: 3830184
});
// 使用您自己的 Google API 密钥
Cesium.GoogleMaps.defaultApiKey = "your-api-key";
const googleTilesProvider = Cesium.Google2DImageryProvider.fromUrl({
mapType: "SATELLITE"
});
See:
Members
readonly credit : Credit
获取此影像提供器处于活动状态时应显示的信用信息。通常用于显示
影像的来源。
Gets an event that is raised when the imagery provider encounters an asynchronous error. By subscribing
对于该事件,您将收到错误通知并有可能从中恢复。事件监听器
会传递一个
TileProviderError 的实例。
获取一个值,指示该影像提供器提供的图像是否包含 alpha 通道。如果此属性为 false,则存在的 alpha 通道将被忽略。
如果此属性为 true,则任何没有 alpha 通道的图像将被视为其 alpha 为 1.0。当此属性为 false 时,内存使用和纹理上传时间都会减少。
创建一个
ImageryProvider,该提供器使用 Cesium ion REST API 从 Google 2D Tiles 提供 2D 全局瓦片影像。
具有以下属性的对象:
Cesium ion 资产 ID。
获取可请求的最大细节级别。
获取可请求的最小细节级别。通常,
只有当影像的矩形区域足够小,使得最小级别的瓦片数量较少时,才应使用最小级别。如果
影像提供器在最小级别下包含大量瓦片,则会导致
渲染问题。
获取提供器使用的瓦片方案。
readonly proxy : Proxy
获取该提供器使用的代理对象。
获取该实例所提供影像的矩形区域,以弧度为单位。
readonly tileDiscardPolicy : TileDiscardPolicy
返回 undefined,则不会过滤任何瓦片。
获取影像提供器遇到异步错误时引发的事件。通过订阅即可接收该事件。
returns undefined, no tiles are filtered.
获取每个瓦片的像素高度。
获取每个瓦片的像素宽度。
readonly tilingScheme : TilingScheme
获取瓦片丢弃策略。如果未未定义,该策略负责通过 shouldDiscardImage 函数过滤掉“缺失”的瓦片。如果该函数
获取 Google 2D 影像服务器的 URL。
Methods
static Cesium.Google2DImageryProvider.fromIonAssetId(options) → Promise.<Google2DImageryProvider>
Creates an
ImageryProvider which provides 2D global tiled imagery from Google 2D Tiles, streamed using the Cesium ion REST API.
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
指定在瓦片上显示信息的语言使用的 IETF 语言标签。
|
Returns:
A 承诺,最终结果为创建的 Google2DImageryProvider。
Examples:
// Google 2D 影像提供器
const googleTilesProvider = Cesium.Google2DImageryProvider.fromIonAssetId({
assetId: 3830184
});
// 具有自定义样式的 Google 2D 路线图覆盖层
const googleTilesProvider = Cesium.Google2DImageryProvider.fromIonAssetId({
assetId: 3830184,
overlayLayerType: "layerRoadmap",
styles: [
{
stylers: [{ hue: "#00ffe6" }, { saturation: -20 }],
},
{
featureType: "road",
elementType: "geometry",
stylers: [{ lightness: 100 }, { visibility: "simplified" }],
},
],
});
static Cesium.Google2DImageryProvider.fromUrl(options) → Promise.<Google2DImageryProvider>
创建一个
ImageryProvider,提供来自 Google 2D Tiles的2D全球瓦片影像。
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
具有以下属性的对象:
|
Returns:
A resolve 后的 promise,指向创建的 Google2DImageryProvider。
Examples:
// 使用您自己的 Google api 密钥
Cesium.GoogleMaps.defaultApiKey = "your-api-key";
const googleTilesProvider = Cesium.Google2DImageryProvider.fromUrl({
mapType: "satellite"
});
// 带有自定义样式的 Google 2D 路线图覆盖层
Cesium.GoogleMaps.defaultApiKey = "your-api-key";
const googleTilesProvider = Cesium.Google2DImageryProvider.fromUrl({
overlayLayerType: "layerRoadmap",
styles: [
{
stylers: [{ hue: "#00ffe6" }, { saturation: -20 }],
},
{
featureType: "road",
elementType: "geometry",
stylers: [{ lightness: 100 }, { visibility: "simplified" }],
},
],
});
getTileCredits(x, y, level) → Array.<Credit>|undefined
获取在显示特定瓦片时显示的标签。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片的 X 坐标。 |
y |
number | 瓦片的 Y 坐标。 |
level |
number | 瓦片级别; |
Returns:
The 在显示瓦片时显示的标签。
该影像提供器目前不支持选择要素,因此此函数直接返回
undefined。
| 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:
A 图像 resolve 后的 promise,当图像可用时解析,或者
如果对服务器的活动请求过多,则为 undefined,请求将在之后重试。
Type Definitions
Google2DImageryProvider 构造函数的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
key |
string | 用于发送瓦片请求的 Google API 密钥。 | ||
session |
string | 跟踪地图和视口当前状态的 Google 会话令牌。 | ||
url |
string | Resource | IonResource | Google 2D 地图端点。 | ||
tileWidth |
string | 每个瓦片的像素宽度。 | ||
tileHeight |
string | 每个瓦片的像素高度。 | ||
ellipsoid |
Ellipsoid |
<optional> |
Ellipsoid.default | 椭球体。如果未指定,则使用默认椭球体。 |
minimumLevel |
number |
<optional> |
0 | 影像提供器支持的最小细节级别。注意,当指定 最小级别下的瓦片数量较少时,例如四块或更少,需谨慎处理。较大的数量 可能会导致渲染问题。 |
maximumLevel |
number |
<optional> |
22 | 影像提供器支持的最大细节级别。 |
rectangle |
Rectangle |
<optional> |
Rectangle.MAX_VALUE | 图像所覆盖的矩形区域,以弧度为单位。 |
