new Cesium.GoogleEarthEnterpriseMapsProvider(options)
提供使用Google Earth Imagery API的瓦片图像。
注意:该图像提供器不适用于公共Google Earth服务器。它可与Google Earth Enterprise Server一起使用。
默认情况下,Google Earth Enterprise Server不设置Cross-Origin Resource Sharing标头。
你可以使用添加这些头文件的代理服务器或者在”/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 |
Object |
此对象拥有以下属性:
|
异常情况:
-
RuntimeError : 找不到通道(id)为
options.channel
的图层。 -
RuntimeError : 找不到通道(id)为
options.channel
中版本。 -
RuntimeError : 不支持的投影
data.projection
。
示例:
var google = new Cesium.GoogleEarthEnterpriseMapsProvider({
url : 'https://earth.localdomain',
channel : 1008
});
参考:
成员变量
staticCesium.GoogleEarthEnterpriseMapsProvider.logoUrl : String
获取或设置用于在版权中显示的谷歌地球logo的URL。
获取当前正在使用的图像通道(ID)。
获取版权信息。在
GoogleEarthEnterpriseMapsProvider#ready
返回true之前,不应调用此函数。
defaultGamma : Number
为该提供器创建的图像图层使用的默认
ImageryLayer#gamma
。
默认设置为1.9。在为这个提供器创建ImageryLayer
之后更改这个值将没有任何效果。
相反,设置图层的ImageryLayer#gamma
属性。
-
Default Value:
1.9
获取在图像提供器遇到异步错误时引发的事件。通过订阅事件,您将收到错误通知,并可能从中恢复。
事件监听器传递一个
TileProviderError
的实例。
获取影像是否有Alpha通道。
获取最大级别。在
GoogleEarthEnterpriseMapsProvider#ready
返回true之前,不应调用此函数。
获取最小级别。在
GoogleEarthEnterpriseMapsProvider#ready
返回true之前,不应调用此函数。
获取Google Earth服务器上数据的url路径。
获取代理。
获取此提供器是否已经准备好。
获取一个在提供器准备就绪时可以解析为true的Promise。
获取要显示的地图范围(以弧度表示)。在
GoogleEarthEnterpriseMapsProvider#ready
返回true之前,不应调用此函数。
获取从提供器请求的数据类型。 在
GoogleEarthEnterpriseMapsProvider#ready
返回true之前,不应调用此函数。
获取瓦片忽略策略。如果未定义,则忽略策略负责通过其shouldDiscardImage函数过滤掉“丢失”的瓦片。
如果此函数返回未定义,则不过滤任何切片。在
GoogleEarthEnterpriseMapsProvider#ready
返回true之前,不应调用此函数。
获取瓦片高。在
GoogleEarthEnterpriseMapsProvider#ready
返回true之前,不应调用此函数。
获取瓦片宽。在
GoogleEarthEnterpriseMapsProvider#ready
返回true之前,不应调用此函数。
获取切片方案。 在
GoogleEarthEnterpriseMapsProvider#ready
返回true之前,不应调用此函数。
获取服务器url。
获取此提供器使用的数据的版本。 在
GoogleEarthEnterpriseMapsProvider#ready
返回true之前,不应调用此函数。
内置方法
获取当请求的瓦片被显示出来时,要显示的版权信息。
Name | Type | Description |
---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的层级。 |
返回值:
返回的版权。
异常情况:
-
DeveloperError : 在图像提供器准备就绪之前,不得调用
getTileCredits
。
pickFeatures(x, y, level, longitude, latitude) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined
这个图像提供器目前不支持拾取要素,所以这个函数只是返回undefined。
Name | Type | Description |
---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的层级。 |
longitude |
Number | 选择要素的经度。 |
latitude |
Number | 选择要素的纬度。 |
返回值:
对拾取要素的promise,它将在异步选择完成时解析。
解析后的值是
ImageryLayerFeatureInfo
实例的数组。如果在给定位置没有发现任何要素,则该数组可能为空。
如果不支持拾取,它也可能是未定义的。
requestImage(x, y, level, request) → Promise.<(Image|Canvas)>|undefined
请求给定块的瓦片。
Name | Type | Description |
---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的层级。 |
request |
Request | optional Request对象(仅供内部使用)。 |
返回值:
返回值有以下3种情况:
1.当图像可用时,返回对图像的Promise。
2.如果有太多对服务器的活动请求,则返回未定义图像,并且应该稍后重新请求。
3.解析后的图像可以是图像,也可以是画布DOM对象。
异常情况:
-
DeveloperError : 准备好图像提供器之前,不得调用
requestImage
。