Google2DImageryProvider
Cesium v1.147 · 中文

new Cesium.Google2DImageryProvider(options)

通常不直接实例化此对象,应使用 Google2DImageryProvider.fromIonAssetId 或 Google2DImageryProvider.fromUrl。
从 Google 2D Tiles 提供 2D 图像瓦片。 Google 2D Tiles 只能与 Google 地理编码器一起使用。
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

获取此影像提供器处于活动状态时应显示的信用信息。通常用于显示 影像的来源。
Gets an event that is raised when the imagery provider encounters an asynchronous error. By subscribing 对于该事件,您将收到错误通知并有可能从中恢复。事件监听器 会传递一个 TileProviderError 的实例。

readonly hasAlphaChannel : boolean

获取一个值,指示该影像提供器提供的图像是否包含 alpha 通道。如果此属性为 false,则存在的 alpha 通道将被忽略。 如果此属性为 true,则任何没有 alpha 通道的图像将被视为其 alpha 为 1.0。当此属性为 false 时,内存使用和纹理上传时间都会减少。 创建一个 ImageryProvider,该提供器使用 Cesium ion REST API 从 Google 2D Tiles 提供 2D 全局瓦片影像。 具有以下属性的对象: Cesium ion 资产 ID。

readonly maximumLevel : number|undefined

获取可请求的最大细节级别。
获取可请求的最小细节级别。通常, 只有当影像的矩形区域足够小,使得最小级别的瓦片数量较少时,才应使用最小级别。如果 影像提供器在最小级别下包含大量瓦片,则会导致 渲染问题。 获取提供器使用的瓦片方案。
获取该提供器使用的代理对象。
获取该实例所提供影像的矩形区域,以弧度为单位。
返回 undefined,则不会过滤任何瓦片。 获取影像提供器遇到异步错误时引发的事件。通过订阅即可接收该事件。 returns undefined, no tiles are filtered.
获取每个瓦片的像素高度。
获取每个瓦片的像素宽度。
获取瓦片丢弃策略。如果未未定义,该策略负责通过 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 语言标签。
Name Type Default Description
assetId string 一个 Common Locale Data Repository 区域标识符(两个大写字母),表示用户的物理位置。
mapType "satellite" | "terrain" | "roadmap" "satellite" optional 返回具有指定 layerType 的透明覆盖层地图。如果未提供值,则返回 mapType 的基础地图。使用多个 Google2DImageryProvider 可以在场景中添加多个 Google 地图覆盖层。layerRoadmap 包含在地形和路线图地图类型中,因此将其作为地形或路线图的覆盖层添加没有效果。
language string "en_US" optional 一个 JSON 风格对象数组,用于指定道路、公园和建成区等地图特征的外观和细节级别。样式用于自定义标准 Google 基础地图。仅当 mapType 为路线图时,styles 参数才有效。有关完整的样式语法,请参阅 (Google Style Reference)。
region string "US" optional A Common Locale Data Repository region identifier (two uppercase letters) that represents the physical location of the user.
overlayLayerType "layerRoadmap" | "layerStreetview" | "layerTraffic" optional Returns a transparent overlay map with the specified layerType. If no value is provided, a basemap of mapType is returned. Use multiple instances of Google2DImageryProvider to add multiple Google Maps overlays to a scene. layerRoadmap is included in terrain and roadmap mapTypes, so adding as overlay to terrain or roadmap has no effect.
styles object optional An array of JSON style objects that specify the appearance and detail level of map features such as roads, parks, and built-up areas. Styling is used to customize the standard Google base map. The styles parameter is valid only if the mapType is roadmap. For the complete style syntax, see the (Google Style Reference).
ellipsoid Ellipsoid Ellipsoid.default optional 椭球体。如果未指定,则使用默认椭球体。
minimumLevel number 0 optional 影像提供器支持的最小细节级别。在指定时需注意 最小级别下的瓦片数量应较小,例如四片或更少。数量过大可能会导致渲染问题。 影像提供器支持的最大细节级别。
maximumLevel number 22 optional 影像提供器支持的最大细节级别。
rectangle Rectangle Rectangle.MAX_VALUE optional 图像所覆盖的矩形区域,以弧度为单位。
credit Credit | string optional 数据源的信用标识,显示在画布上。
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 具有以下属性的对象:
Name Type Default Description
key string GoogleMaps.defaultApiKey optional 用于访问 Google 2D Tiles 的 API 密钥。有关如何生成自己密钥的说明,请参阅 https://developers.google.com/maps/documentation/javascript/get-api-key。
mapType "satellite" | "terrain" | "roadmap" "satellite" optional Google 地图影像的地图类型。有效选项包括卫星、地形和路线图。如果设置了 overlayLayerType,则忽略 mapType,返回透明覆盖层。如果未定义 overlayMapType,则返回 mapType 的基础地图。layerRoadmap overlayLayerType 包含在地形和路线图地图类型中。
language string "en_US" optional 指定在瓦片上显示信息的语言使用的 IETF 语言标签。
region string "US" optional 代表用户物理位置的 Common Locale Data Repository 区域标识符(两个大写字母)。
overlayLayerType "layerRoadmap" | "layerStreetview" | "layerTraffic" optional 返回具有指定 layerType 的透明覆盖地图。如果未提供值,则返回 mapType 的基础地图。使用多个 Google2DImageryProvider 可以在场景中添加多个 Google 地图覆盖层。layerRoadmap 包含在地形和路线图地图类型中,因此将其作为覆盖层添加到地形或路线图上无效。
styles object optional 一个 JSON 格式对象的数组,用于指定道路、公园和建成区等地图要素的外观和细节级别。样式设置用于自定义标准 Google 基础地图。仅当 mapType 为 roadmap 时,styles 参数才有效。完整的样式语法请参见 (Google Style Reference)。
ellipsoid Ellipsoid Ellipsoid.default optional 椭球体。如果未指定,则使用默认椭球体。
minimumLevel number 0 optional 影像提供器支持的最小细节级别。在指定时请注意,最小级别下的瓦片数量应较少,例如四片或更少。数量过多可能会导致渲染问题。 当最小级别的瓦片数量较少时,如四片或更少,可能会出现问题。数量较多则可能导致渲染问题。 影像提供器支持的最大细节级别。
maximumLevel number 22 optional 影像提供器支持的最大细节级别。
rectangle Rectangle Rectangle.MAX_VALUE optional 图像所覆盖的矩形区域,以弧度为单位。
credit Credit | string optional 在画布上显示的数据源标签。
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 在显示瓦片时显示的标签。

pickFeatures(x, y, level, longitude, latitude) → undefined

该影像提供器目前不支持选择要素,因此此函数直接返回 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

Cesium.Google2DImageryProvider.ConstructorOptions

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 图像所覆盖的矩形区域,以弧度为单位。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.