此对象通常不直接实例化，请使用
Provides 2D image tiles from Google 2D Tiles.
Google 2D Tiles can only be used with the Google geocoder.
Google2DImageryProvider.fromIonAssetId 或 Google2DImageryProvider.fromUrl。
| Name | Type | Description |
|---|---|---|
options |
Google2DImageryProvider.ConstructorOptions | 描述初始化选项的对象 |
Examples:
// Google 2D imagery provider
const googleTilesProvider = Cesium.Google2DImageryProvider.fromIonAssetId({
assetId: 3830184
});// Use your own Google api key
Cesium.GoogleMaps.defaultApiKey = "your-api-key";
const googleTilesProvider = Cesium.Google2DImageryProvider.fromUrl({
mapType: "SATELLITE"
});See:
Members
readonly credit : Credit
获取此影像提供方处于活动状态时要显示的版权信息。通常这用于标注影像的来源。
readonly errorEvent : Event
获取当影像提供方遇到异步错误时触发的事件。通过订阅该事件，您将收到错误通知，并可能从中恢复。事件监听器会接收到一个
TileProviderError 实例。
获取一个值，指示此影像提供方提供的图像是否包含 alpha 通道。如果此属性为 false，则存在的 alpha 通道将被忽略。如果此属性为 true，则任何没有 alpha 通道的图像将被视为其 alpha 在所有位置均为 1.0。当此属性为 false 时，内存占用和纹理上传时间会减少。
获取可以请求的最大细节级别。
获取可以请求的最小细节级别。通常，仅当影像的矩形范围足够小、使得最小级别上的瓦片数量较少时才应使用最小级别。在最小级别上有过多瓦片的影像提供方会导致渲染问题。
readonly proxy : Proxy
获取此提供方使用的代理。
readonly rectangle : Rectangle
获取此实例提供的影像的矩形范围（以弧度表示）。
readonly tileDiscardPolicy : TileDiscardPolicy
获取瓦片丢弃策略。如果不为 undefined，则该丢弃策略负责通过其 shouldDiscardImage 函数过滤掉 "missing" 瓦片。如果该函数返回 undefined，则不会过滤任何瓦片。
获取每个瓦片的高度（以像素为单位）。
获取每个瓦片的宽度（以像素为单位）。
readonly tilingScheme : TilingScheme
获取此提供方使用的瓦片方案。
获取 Google 2D 影像服务器的 URL。
Methods
static Cesium.Google2DImageryProvider.fromIonAssetId(options) → Promise.<Google2DImageryProvider>
创建一个
ImageryProvider，它提供来自 Google 2D Tiles 的 2D 全球分块影像，通过 Cesium ion REST API 流式传输。
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
包含以下属性的对象：
|
Returns:
resolve 为已创建的 Google2DImageryProvider 的 Promise。
Examples:
// Google 2D imagery provider
const googleTilesProvider = Cesium.Google2DImageryProvider.fromIonAssetId({
assetId: 3830184
});// Google 2D roadmap overlay with custom styles
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:
resolve 为已创建的 Google2DImageryProvider 的 Promise。
Examples:
// Use your own Google api key
Cesium.GoogleMaps.defaultApiKey = "your-api-key";
const googleTilesProvider = Cesium.Google2DImageryProvider.fromUrl({
mapType: "satellite"
});// Google 2D roadmap overlay with custom styles
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:
在显示瓦片时要显示的版权信息。
此影像提供方目前不支持拾取要素，因此此函数直接返回 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:
图像的 Promise，在图像可用时 resolve；如果到服务器的活动请求过多，则返回 undefined，稍后应重试该请求。
Type Definitions
Google2DImageryProvider 构造函数的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
key |
string | 随瓦片请求一起发送的 Google API key。 | ||
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 | 图像所覆盖的矩形范围（以弧度表示）。 |