要构造 GoogleEarthEnterpriseMapsProvider,请调用
使用 Google Earth Imagery API 提供分块影像。
注意:此影像提供程序不适用于公共 Google Earth 服务器。它适用于
Google Earth Enterprise 服务器。
默认情况下,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 地球 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 通道。
如果此属性为假,则如果存在,alpha 通道将被忽略。
如果此属性为真,则任何没有 alpha 通道的图像将被视为
其 alpha 到处为 1.0。将此属性设置为假将减少内存使用
和纹理上传时间。
获取可以请求的最大细节层级。
获取可以请求的最小细节层级。
获取 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 Imagery 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:
返回一个图像的 Promise,当图像可用时将解析;或者如果服务器上有太多的活跃请求,则为 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 | 椭球体。如果未指定,则使用默认椭球体。 |
