麻辣GIS微信平台

更多 GIS 干货

微信关注不错过

Cesium API - GoogleEarthEnterpriseMapsProvider 中文文档

本文介绍下Cesium中 GoogleEarthEnterpriseMapsProvider API的详细使用说明。

GoogleEarthEnterpriseMapsProvider API 调用方法

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 此对象拥有以下属性:
Name Type Default Description
url Resource | String 托管图像的Google Earth服务器的url。
channel Number 向服务器请求数据时要使用的通道(id)。 可以通过查看位于以下位置的json文件找到通道号: earth.localdomain/default_map/query?request=Json&vars=geeServerDefs, 根据您的Google Earth Enterprise服务器配置,/default_map路径可能不同。 寻找与“ImageryMaps”requestType相关联的“id”。可能有多个ID可用。 例如: { layers: [ { id: 1002, requestType: "ImageryMaps" }, { id: 1007, requestType: "VectorMapsRaster" } ] }
path String "/default_map" optional 托管图像的Google Earth服务器的路径。
maximumLevel Number optional Google Earth Enterprise服务器支持的最大详细级别,如果没有限制,则为未定义。
tileDiscardPolicy TileDiscardPolicy optional 确定某个瓦片是否无效并应被丢弃的策略。 为了确保没有瓦片被丢弃,构造并为该参数传递一个NeverTileDiscardPolicy
ellipsoid Ellipsoid optional 椭球。如果未指定,则使用WGS84椭球。
异常情况:
  • 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之前,不应调用此函数。
为该提供器创建的图像图层使用的默认ImageryLayer#gamma。 默认设置为1.9。在为这个提供器创建ImageryLayer之后更改这个值将没有任何效果。 相反,设置图层的ImageryLayer#gamma属性。
Default Value: 1.9
获取在图像提供器遇到异步错误时引发的事件。通过订阅事件,您将收到错误通知,并可能从中恢复。 事件监听器传递一个TileProviderError的实例。
readonlyhasAlphaChannel : Boolean
获取影像是否有Alpha通道。
readonlymaximumLevel : Number
获取最大级别。在GoogleEarthEnterpriseMapsProvider#ready返回true之前,不应调用此函数。
readonlyminimumLevel : Number
获取最小级别。在GoogleEarthEnterpriseMapsProvider#ready返回true之前,不应调用此函数。
获取Google Earth服务器上数据的url路径。
获取代理。
获取此提供器是否已经准备好。
readonlyreadyPromise : Promise.<Boolean>
获取一个在提供器准备就绪时可以解析为true的Promise。
获取要显示的地图范围(以弧度表示)。在GoogleEarthEnterpriseMapsProvider#ready返回true之前,不应调用此函数。
readonlyrequestType : String
获取从提供器请求的数据类型。 在GoogleEarthEnterpriseMapsProvider#ready返回true之前,不应调用此函数。
获取瓦片忽略策略。如果未定义,则忽略策略负责通过其shouldDiscardImage函数过滤掉“丢失”的瓦片。 如果此函数返回未定义,则不过滤任何切片。在GoogleEarthEnterpriseMapsProvider#ready返回true之前,不应调用此函数。
获取瓦片高。在GoogleEarthEnterpriseMapsProvider#ready返回true之前,不应调用此函数。
获取瓦片宽。在GoogleEarthEnterpriseMapsProvider#ready返回true之前,不应调用此函数。
获取切片方案。 在GoogleEarthEnterpriseMapsProvider#ready返回true之前,不应调用此函数。
获取服务器url。
获取此提供器使用的数据的版本。 在GoogleEarthEnterpriseMapsProvider#ready返回true之前,不应调用此函数。

内置方法

getTileCredits(x, y, level)Array.<Credit>
获取当请求的瓦片被显示出来时,要显示的版权信息。
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

其他API

Cesium中文API文档手册(v1.63.1版本)参考:《Cesium中文API文档手册(v1.63.1版本)

相关阅读

麻辣GIS-Sailor

作者:

GIS爱好者,学GIS,更爱玩GIS。

声明

1.本文所分享的所有需要用户下载使用的内容(包括但不限于软件、数据、图片)来自于网络或者麻辣GIS粉丝自行分享,版权归该下载资源的合法拥有者所有,如有侵权请第一时间联系本站删除。

2.下载内容仅限个人学习使用,请切勿用作商用等其他用途,否则后果自负。

手机阅读
公众号关注
知识星球
手机阅读
麻辣GIS微信公众号关注
最新GIS干货
关注麻辣GIS知识星球
私享圈子

留言板(小编看到第一时间回复)