Class: GoogleEarthEnterpriseMapsProvider

GoogleEarthEnterpriseMapsProvider

new GoogleEarthEnterpriseMapsProvider()

使用谷歌地球影像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 Default Description
options.url String

存放影像的谷歌地球服务器的url。

options.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" } ] }

options.path String "/default_map" 可选

承载影像的谷歌地球服务器的路径。

options.maximumLevel Number 可选

Google Earth Enterprise服务器支持的最大详细级别,如果没有限制,则未定义。

options.tileDiscardPolicy TileDiscardPolicy 可选

确定瓦片是否无效并应该被丢弃的策略。为确保没有瓦片被丢弃,构建并传递一个NeverTileDiscardPolicy作为此参数。

options.ellipsoid Ellipsoid 可选

椭球。如果未指定,则使用 WGS84 椭球。

options.proxy Proxy 可选

用于请求的代理。该对象将有一个 getURL 函数,用于在需要时返回代理 URL。

See:
Throws:
  • 无法找到具有通道(id)的图层 options.channel

    Type
    RuntimeError
  • 无法在通道(id)options.channel中找到版本。

    Type
    RuntimeError
  • 不支持的投影 data.projection

    Type
    RuntimeError
Example
var google = new SuperMap3D.GoogleEarthEnterpriseMapsProvider({
    url : 'https://earth.localdomain',
    channel : 1008
});

Members

readonly channelNumber

获取当前使用的影像通道(id)。

readonly creditCredit

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

defaultGammaNumber

The default ImageryLayer#gamma to use for imagery layers created for this provider. By default, this is set to 1.9. Changing this value after creating an ImageryLayer for this provider will have no effect. Instead, set the layer's ImageryLayer#gamma property.

Default Value:
1.9

readonly errorEventEvent

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

readonly hasAlphaChannelBoolean

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

readonly maximumLevelNumber

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

readonly minimumLevelNumber

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

readonly pathString

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

readonly proxyProxy

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

readonly readyBoolean

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

readonly readyPromisePromise.<Boolean>

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

readonly rectangleRectangle

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

readonly requestTypeString

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

readonly tileDiscardPolicyTileDiscardPolicy

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

readonly tileHeightNumber

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

readonly tileWidthNumber

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

readonly tilingSchemeTilingScheme

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

readonly urlString

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

readonly versionNumber

获取该提供程序使用的数据版本。在 GoogleEarthEnterpriseMapsProvider#ready 返回 true 之前不应调用。

Methods

getTileCredits(x, y, level){Array.<Credit>}

获取显示给定瓦片时要显示的版权信息。

Name Type Description
x Number

瓦片的X坐标。

y Number

瓦片的Y坐标。

level Number

瓦片的级别。

Throws:

getTileCredits 不得在影像提供程序准备就绪前调用。

Type
DeveloperError
Returns:
Type Description
Array.<Credit> 显示瓦片时要显示的版权信息。

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:
Type Description
Promise.<Array.<ImageryLayerFeatureInfo>> | undefined 当异步采集完成时,将解析所采集特征的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 可选

请求对象。仅供内部使用。

Throws:

requestImage 不得在影像提供程序准备就绪前调用。

Type
DeveloperError
Returns:
Type Description
Promise.<(Image|Canvas)> | undefined 对影像的一个Promise,当影像可用时将进行解析,如果对服务器的活动请求太多,则未定义,并且应该稍后重试请求。解析后的影像可以是image对象,也可以是Canvas DOM对象。