GoogleEarthEnterpriseMapsProvider

new SuperMap3D.GoogleEarthEnterpriseMapsProvider(options)

使用谷歌地球影像API提供切图影像。 Notes: 此影像提供程序不能与公共Google Earth服务器一起工作。它与谷歌地球企业服务器一起工作。 默认情况下，Google Earth Enterprise服务器不设置跨域资源共享标头。你可以使用一个代理服务器来添加这些头文件，或者在/opt/google/gehttpd/conf/gehttpd.conf中添加'Header set Access-Control-Allow-Origin "*"选项到'<Directory />'和'<Directory "/opt/google/gehttpd/htdocs">'指令中。 该提供程序用于2D地图API，作为Google Earth Enterprise的一部分。对于3D Earth API的使用，必须使用GoogleEarthEnterpriseImageryProvider
Name Type Description
options Object 具有以下属性的对象:
Name Type Default Description
url String 存放影像的谷歌地球服务器的url。
channel Number 从服务器请求数据时要使用的通道(id)。通道号可以通过查看位于earth.localdomain/default_map/query?request=Json&vars=geeServerDefs /default_map路径可能因您的Google Earth Enterprise服务器配置而异。查找与“ImageryMaps”请求类型相关联的“id”。可用的id可能不止一个。 Example: { layers: [ { id: 1002, requestType: "ImageryMaps" }, { id: 1007, requestType: "VectorMapsRaster" } ] }
path String "/default_map" optional 承载影像的谷歌地球服务器的路径。
maximumLevel Number optional Google Earth Enterprise服务器支持的最大详细级别，如果没有限制，则未定义。
tileDiscardPolicy TileDiscardPolicy optional 确定瓦片是否无效并应该被丢弃的策略。为确保没有瓦片被丢弃，构建并传递一个NeverTileDiscardPolicy作为此参数。
ellipsoid Ellipsoid optional 椭球。如果未指定，则使用 WGS84 椭球。
proxy Proxy optional 用于请求的代理。该对象将有一个 getURL 函数，用于在需要时返回代理 URL。
Throws:
  • RuntimeError : 无法找到具有通道（id）的图层 options.channel。
  • RuntimeError : 无法在通道（id）options.channel中找到版本。
  • RuntimeError : 不支持的投影 data.projection。
Example:
var google = new SuperMap3D.GoogleEarthEnterpriseMapsProvider({
    url : 'https://earth.localdomain',
    channel : 1008
});
See:

Members

readonlychannel : Number

获取当前使用的影像通道（id）。

readonlycredit : Credit

获取此影像提供程序处于活动状态时要显示的凭证。这通常是用来证明影像的来源。这个函数不应该在GoogleEarthEnterpriseMapsProvider#ready返回true之前被调用。

defaultGamma : Number

为这个提供者创建的影像层使用的默认ImageryLayer#gamma。默认情况下，这个值设置为1.9。在为这个提供者创建了ImageryLayer之后更改此值将没有效果。相反，设置层的ImageryLayer#gamma属性。
Default Value: 1.9

readonlyerrorEvent : Event

获取当影像提供程序遇到异步错误时引发的事件。通过订阅事件，您将收到错误通知，并有可能从中恢复。事件监听器被传递一个TileProviderError的实例。

readonlyhasAlphaChannel : Boolean

获取一个值，该值指示此影像提供程序提供的影像是否包含alpha通道。如果此属性为false，则alpha通道(如果存在)将被忽略。如果此属性为true，则任何没有alpha通道的影像都将被处理。

readonlymaximumLevel : Number

获取可请求的最大精细级别。在 GoogleEarthEnterpriseMapsProvider#ready 返回 true 之前 在 GoogleEarthEnterpriseMapsProvider#ready 返回 true 之前不应调用。

readonlyminimumLevel : Number

获取可请求的最小精细级别。此函数不应在 GoogleEarthEnterpriseMapsProvider#ready 返回 true 之前调用。

readonlypath : String

获取 Google 地球服务器上数据的 url 路径。

readonlyproxy : Proxy

获取该提供程序使用的代理。

readonlyready : Boolean

获取一个值，该值指示提供程序是否已准备好使用。

readonlyreadyPromise : Promise.<Boolean>

获取一个Promise，该Promise在提供程序准备好使用时解析为true。

readonlyrectangle : Rectangle

获取此实例所提供影像的矩形（以弧度为单位）。此函数不应在 GoogleEarthEnterpriseMapsProvider#ready 返回 true 之前调用。

readonlyrequestType : String

获取向提供程序请求的数据类型。此函数不应在 GoogleEarthEnterpriseMapsProvider#ready 返回 true 之前调用。

readonlytileDiscardPolicy : TileDiscardPolicy

获取瓦片丢弃策略。如果不是undefined，丢弃策略负责通过shouldDiscardImage函数过滤掉“丢失的”贴图。如果此函数返回undefined，则不过滤任何tile。这个函数不应该在GoogleEarthEnterpriseMapsProvider#ready返回true之前被调用。

readonlytileHeight : Number

获取每个瓦片的高度（以像素为单位）。此函数不应在 GoogleEarthEnterpriseMapsProvider#ready 返回 true 之前调用。

readonlytileWidth : Number

获取每个瓦片的宽度，以像素为单位。在GoogleEarthEnterpriseMapsProvider#ready返回真之前，不应调用此函数。

readonlytilingScheme : TilingScheme

获取此提供程序使用的切图方案。此函数不应在 GoogleEarthEnterpriseMapsProvider#ready 返回 true 之前调用。

readonlyurl : String

获取 Google 地球地图服务器的 URL。

readonlyversion : Number

获取该提供程序使用的数据版本。在 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 不得在影像提供程序准备就绪前调用。

pickFeatures(x, y, level, longitude, latitude) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined

该影像提供程序目前不支持选择特征，因此该函数返回未定义。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的级别。
longitude Number 选取特征的经度。
latitude Number 选取特征的纬度。
Returns:
当异步采集完成时，将解析所采集特征的Promise。 解析值是一个由 ImageryLayerFeatureInfo 实例组成的数组。 如果在给定位置没有找到特征，数组可能为空。如果不支持提取，该数组也可能是未定义的。

requestImage(x, y, level, request) → Promise.<(Image|Canvas)>|undefined

请求指定瓦片的影像。此函数应在GoogleEarthEnterpriseMapsProvider#ready 返回true之前不应调用。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的级别。
request Request optional 请求对象。仅供内部使用。
Returns:
对影像的一个Promise，当影像可用时将进行解析，如果对服务器的活动请求太多，则未定义，并且应该稍后重试请求。解析后的影像可以是image对象，也可以是Canvas DOM对象。
Throws:
  • DeveloperError : requestImage 不得在影像提供程序准备就绪前调用。