要构造 GoogleEarthEnterpriseMapsProvider,请调用
使用 Google Earth 影像 API 提供瓦片影像。
注意:此影像提供程序不适用于公共 Google Earth 服务器。它适用于
Google Earth Enterprise Server。
默认情况下,Google Earth Enterprise 服务器不设置
跨域资源共享 标头。您可以
使用添加这些标头的代理服务器,或者在 /opt/google/gehttpd/conf/gehttpd.conf 中
将 'Header set Access-Control-Allow-Origin "*"' 选项添加到 '<Directory />' 和
'<Directory "/opt/google/gehttpd/htdocs">' 指令中。
此提供程序用于 Google Earth Enterprise 的 2D 地图 API。对于 3D Earth API 使用,
需要使用 GoogleEarthEnterpriseImageryProvider.fromUrl。不要直接调用构造函数。
GoogleEarthEnterpriseImageryProvider
| Name | Type | Description |
|---|---|---|
options |
GoogleEarthEnterpriseMapsProvider.ConstructorOptions | 描述初始化选项的对象 |
Throws:
-
RuntimeError : 找不到频道(id)为
options.channel的图层。 -
RuntimeError : 在频道(id)
options.channel中找不到版本。 -
RuntimeError : 不支持的投影
data.projection。
Example:
const google = await Cesium.GoogleEarthEnterpriseMapsProvider.fromUrl("https://earth.localdomain", 1008);
See:
Members
获取或设置用于显示在版权信息中的 Google Earth 徽标 URL。
获取当前正在使用的影像频道(id)。
readonly credit : Credit
获取当此影像提供程序处于活动状态时要显示的版权信息。通常用于注明
影像的来源。
readonly errorEvent : Event
获取当影像提供程序遇到异步错误时引发的事件。通过订阅
该事件,您将收到错误通知并可能从中恢复。事件监听器
会接收到
TileProviderError 的实例。
获取一个值,指示此影像提供程序提供的图像
是否包含 Alpha 通道。如果此属性为 false,则 Alpha 通道(如果存在)将
被忽略。如果此属性为 true,则任何没有 Alpha 通道的图像将被视为
其 Alpha 值在所有地方都为 1.0。当此属性为 false 时,内存使用量
和纹理上传时间会减少。
获取可请求的最大细节级别。
获取可请求的最小细节级别。
获取 Google Earth 服务器上数据的 URL 路径。
readonly proxy : Proxy
获取此提供程序使用的代理。
readonly rectangle : Rectangle
获取此实例提供的影像范围(以弧度为单位)。
获取从提供程序请求的数据类型。
readonly tileDiscardPolicy : TileDiscardPolicy
获取瓦片丢弃策略。如果未定义,则丢弃策略负责
通过其 shouldDiscardImage 函数过滤掉"缺失"的瓦片。如果该函数
返回 undefined,则不会过滤任何瓦片。
获取每个瓦片的高度(以像素为单位)。
获取每个瓦片的宽度(以像素为单位)。
readonly tilingScheme : TilingScheme
获取此提供程序使用的瓦片方案。
获取 Google Earth MapServer 的 URL。
获取此提供程序使用的数据版本。
Methods
static Cesium.GoogleEarthEnterpriseMapsProvider.fromUrl(url, options) → Promise.<GoogleEarthEnterpriseMapsProvider>
使用 Google Earth 影像 API 创建瓦片影像提供程序。
| Name | Type | Description |
|---|---|---|
url |
Resource | string | 托管影像的 Google Earth 服务器的 URL。 |
options |
GoogleEarthEnterpriseMapsProvider.ConstructorOptions | optional 描述初始化选项的对象 |
Returns:
已创建的 GoogleEarthEnterpriseMapsProvider。
Throws:
-
RuntimeError : 找不到频道(id)为
options.channel的图层。 -
RuntimeError : 在频道(id)
options.channel中找不到版本。 -
RuntimeError : 不支持的投影
data.projection。
Example:
const google = await Cesium.GoogleEarthEnterpriseMapsProvider.fromUrl("https://earth.localdomain", 1008);
getTileCredits(x, y, level) → Array.<Credit>
获取当显示给定瓦片时要显示的版权信息。
| 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:
图像的承诺,当图像可用时解析,或者
如果服务器有太多活动请求而返回 undefined,则应稍后重试请求。
Type Definitions
GoogleEarthEnterpriseMapsProvider 构造函数的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
channel |
number | 从服务器请求数据时要使用的频道(id)。 频道编号可以通过查看位于以下位置的 json 文件找到: earth.localdomain/default_map/query?request=Json&vars=geeServerDefs /default_map 路径可能 因您的 Google Earth Enterprise 服务器配置而异。查找与 "ImageryMaps" requestType 关联的 "id"。可能有多个可用的 id。 示例: { layers: [ { id: 1002, requestType: "ImageryMaps" }, { id: 1007, requestType: "VectorMapsRaster" } ] } | ||
path |
string |
<optional> |
"/default_map" | 托管影像的 Google Earth 服务器的路径。 |
maximumLevel |
number |
<optional> |
Google Earth Enterprise 服务器支持的最大细节级别,如果没有限制则为 undefined。 | |
tileDiscardPolicy |
TileDiscardPolicy |
<optional> |
确定瓦片是否
无效并应被丢弃的策略。为确保不丢弃任何瓦片,请构造并传递
NeverTileDiscardPolicy 作为此参数。 |
|
ellipsoid |
Ellipsoid |
<optional> |
Ellipsoid.default | 椭球体。如果未指定,则使用默认椭球体。 |
