使用 Google Earth Imagery API 提供平铺图像。注意:此图像提供程序不适用于公共 Google 地球服务器。它适用于 Google 地球企业服务器。默认情况下，Google 地球企业服务器不设置
跨域资源共享
标头。您可以使用添加这些标头的代理服务器，也可以在/opt/google/gehttpd/conf/gehttpd.conf 中将 'Header set Access-Control-Allow-Origin "*"' 选项添加到 '<Directory/>' 和 '<Directory "/opt/google/gehttpd/htdocs">' 指令。此提供程序用于 2D Maps API 作为 Google Earth Enterprise 的一部分。对于 3D Earth API 使用，必须使用
GoogleEarthEnterpriseImageryProvider
| Name | Type | Description |
|---|---|---|
options
|
GoogleEarthEnterpriseMapsProvider.ConstructorOptions | 描述初始化选项的对象 |
Throws:
-
RuntimeError : 找不到具有
options.channel的通道 (id) 的层。 -
RuntimeError : 在频道 (id)
options.channel中找不到版本。 -
RuntimeError :不支持的投影
data.projection。
Example:
const google = new Cesium.GoogleEarthEnterpriseMapsProvider({
url : 'https://earth.localdomain',
channel : 1008
});See:
Members
获取或设置 Google 地球徽标的 URL 以显示在致谢名单中。
获取当前正在使用的图像通道 (id)。
readonly credit : Credit
当此图像提供程序处于活动状态时，获得要显示的功劳。通常，这用于说明图像的来源。在
GoogleEarthEnterpriseMapsProvider#ready
返回 true 之前，不应调用此函数。
此提供程序的默认 alpha 混合值，0.0 表示完全透明，1.0 表示完全不透明。
-
Default Value:
undefined
此提供程序的默认亮度。 1.0 使用未修改的图像颜色。小于 1.0 会使图像更暗，而大于 1.0 会使图像更亮。
-
Default Value:
undefined
此提供程序的默认对比度。 1.0 使用未修改的图像颜色。小于 1.0 会降低对比度，而大于 1.0 会增加对比度。
-
Default Value:
undefined
此提供程序的地球日侧的默认 alpha 混合值，0.0 表示完全透明，1.0 表示完全不透明。
-
Default Value:
undefined
应用于此提供程序的默认伽马校正。 1.0 使用未修改的图像颜色。
-
Default Value:
1.9
此提供程序的默认色调（以弧度为单位）。 0.0 使用未修改的图像颜色。
-
Default Value:
undefined
defaultMagnificationFilter : TextureMagnificationFilter
应用于此提供程序的默认纹理放大过滤器。
-
Default Value:
undefined
defaultMinificationFilter : TextureMinificationFilter
应用于此提供程序的默认纹理缩小过滤器。
-
Default Value:
undefined
此提供程序的地球夜晚的默认 alpha 混合值，0.0 表示完全透明，1.0 表示完全不透明。
-
Default Value:
undefined
此提供程序的默认饱和度。 1.0 使用未修改的图像颜色。小于 1.0 会降低饱和度，而大于 1.0 会增加饱和度。
-
Default Value:
undefined
readonly errorEvent : Event
获取图像提供程序遇到异步错误时引发的事件。通过订阅该事件，您将收到错误通知，并有可能从中恢复。事件侦听器被传递一个
TileProviderError
实例。
获取一个值，该值指示此图像提供程序提供的图像是否包含 Alpha 通道。如果此属性为 false，则 Alpha 通道（如果存在）将被忽略。如果此属性为真，则任何没有 alpha 通道的图像都将被视为其 alpha 在任何地方都是 1.0。当此属性为 false 时，内存使用量和纹理上传时间会减少。
获取可以请求的最大细节级别。在
GoogleEarthEnterpriseMapsProvider#ready
返回 true 之前，不应调用此函数。
获取可以请求的最低详细级别。在
GoogleEarthEnterpriseMapsProvider#ready
返回 true 之前，不应调用此函数。
获取 Google 地球服务器上数据的 url 路径。
readonly proxy : Proxy
获取此提供程序使用的代理。
获取一个值，该值指示提供程序是否已准备好使用。
当提供者准备好使用时，获取一个解析为 true 的承诺。
readonly rectangle : Rectangle
获取此实例提供的图像的矩形（以弧度为单位）。在
GoogleEarthEnterpriseMapsProvider#ready
返回 true 之前，不应调用此函数。
获取从提供程序请求的数据类型。在
GoogleEarthEnterpriseMapsProvider#ready
返回 true 之前，不应调用此函数。
readonly tileDiscardPolicy : TileDiscardPolicy
获取瓦片丢弃策略。如果未定义，丢弃策略负责通过其 shouldDiscardImage 函数过滤掉'丢失的'图块。如果此函数返回未定义，则不过滤任何图块。在
GoogleEarthEnterpriseMapsProvider#ready
返回 true 之前，不应调用此函数。
获取每个图块的高度，以像素为单位。在
GoogleEarthEnterpriseMapsProvider#ready
返回 true 之前，不应调用此函数。
获取每个图块的宽度，以像素为单位。在
GoogleEarthEnterpriseMapsProvider#ready
返回 true 之前，不应调用此函数。
readonly tilingScheme : TilingScheme
获取此提供程序使用的切片方案。在
GoogleEarthEnterpriseMapsProvider#ready
返回 true 之前，不应调用此函数。
获取 Google 地球地图服务器的 URL。
获取此提供程序使用的数据的版本。在
GoogleEarthEnterpriseMapsProvider#ready
返回 true 之前，不应调用此函数。
Methods
getTileCredits (x, y, level) → Array.< Credit >
获取显示给定磁贴时要显示的积分。
| Name | Type | Description |
|---|---|---|
x
|
Number | 平铺 X 坐标。 |
y
|
Number | 瓦片 Y 坐标。 |
level
|
Number | 瓷砖级别； |
Returns:
显示磁贴时要显示的学分。
Throws:
-
DeveloperError : 在图像提供程序准备好之前，不得调用
getTileCredits。
此图像提供程序当前不支持选择要素，因此此函数仅返回未定义。
| Name | Type | Description |
|---|---|---|
x
|
Number | 平铺 X 坐标。 |
y
|
Number | 瓦片 Y 坐标。 |
level
|
Number | 瓷砖级别。 |
longitude
|
Number | 选择要素的经度。 |
latitude
|
Number | 选择要素的纬度。 |
Returns:
未定义，因为不支持拾取。
requestImage (x, y, level, request ) → Promise.< ImageryTypes >|undefined
请求给定图块的图像。在
GoogleEarthEnterpriseMapsProvider#ready
返回 true 之前，不应调用此函数。
| Name | Type | Description |
|---|---|---|
x
|
Number | 平铺 X 坐标。 |
y
|
Number | 瓦片 Y 坐标。 |
level
|
Number | 瓷砖级别。 |
request
|
Request | 可选 请求对象。仅供内部使用。 |
Returns:
对图像的承诺，当图像可用时将解析，或者如果对服务器的活动请求过多，则未定义，并且应稍后重试请求。
Throws:
-
DeveloperError :在图像提供程序准备好之前，不得调用
requestImage。
Type Definitions
GoogleEarthEnterpriseMapsProvider 构造函数的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
url
|
Resource | String | 托管图像的 Google 地球服务器的网址。 | ||
channel
|
Number | 从服务器请求数据时要使用的通道 (id)。频道号可以通过查看位于以下位置的 json 文件找到:earth.localdomain/default_map/query?request=Json&vars=geeServerDefs/default_map 路径可能因您的 Google 地球企业服务器配置而异。查找与'ImageryMaps'requestType 关联的'id'。可能有多个 id 可用。示例:{图层:[{id:1002，requestType:'ImageryMaps'}，{id:1007，requestType:'VectorMapsRaster'}]} | ||
path
|
String |
<optional>
|
"/default_map" | 托管图像的 Google 地球服务器的路径。 |
maximumLevel
|
Number |
<optional>
|
Google 地球企业服务器支持的最大详细程度，如果没有限制，则未定义。 | |
tileDiscardPolicy
|
TileDiscardPolicy |
<optional>
|
确定图块是否无效并应丢弃的策略。为确保不丢弃任何切片，请为此参数构造并传递
NeverTileDiscardPolicy
。
|
|
ellipsoid
|
Ellipsoid |
<optional>
|
椭球体。如果未指定，则使用 WGS84 椭球。 |