Class: KmlDataSource

KmlDataSource

new KmlDataSource()

用于加载和管理KML格式数据类。 KML支持加载S3M、glTF格式的三维模型。

See:
Example
var viewer = new SuperMap3D.Viewer('Container');
viewer.dataSources.add(SuperMap3D.KmlDataSource.load('../../SampleData/facilities.kmz'),
     {
         camera: viewer.scene.camera,
         canvas: viewer.scene.canvas
     });

Members

changedEventEvent

获取基础数据更改时即将抛出的事件。

获取通过加载的KML定义的时钟设置。表示所有时间动态数据的可用性区间。如果KML不包含时间动态数据,值为未定义。

clusteringEntityCluster

获取或设置数据源的类选项。可以在多个数据源之间共享。

creditCredit

获取数据源版权声明

creditCredit

获取数据源版权声明

获取Entity实例集合。

errorEventEvent

获取在处理过程中遇到错误时将抛出的事件。

isLoadingBoolean

获取一个值,显示当前的数据源是否正在加载数据。

loadingEventEvent

获取数据源启动或停止加载时将抛出的事件。

nameString

获取实例的可读名称。将自动设置为加载的KML文件名称。

refreshEventEvent

获取数据源刷新网络链接时抛出的事件。

showBoolean

获取是否应该显示数据源。

unsupportedNodeEventEvent

获取数据源找到不支持的节点类型时抛出的事件。

Methods

static importFile(data){Promise.<KmlDataSource>}

导入本地KML文件。

Name Type Description
data String

KML文件存放路径。

options.camera Camera

相机对象。

options.canvas Canvas

canvas对象。

Returns:
Type Description
Promise.<KmlDataSource> 导入完成返回一个KmlDataSource实例。

static load(data){Promise.<KmlDataSource>}

异步加载提供的 KML 数据,替换任何现有数据。

Name Type Default Description
data String | Document | Blob

图层URL或者包含KML解析文档的BLOB。

options.camera Camera

相机对象。

options.canvas Canvas

画布对象。

options.sourceUri String 可选

覆盖用于解析相对链接和其他 KML 网络功能的url。

options.clampToGround Boolean false 可选

如果我们想要将几何特征(多边形、线串和线性环)固定在地面上,则为 true。

options.ellipsoid Ellipsoid Ellipsoid.WGS84 可选

用于地理计算的全球椭球体。

options.credit Credit | String 可选

数据源的版权声明,显示在画布上。

Returns:
Type Description
Promise.<KmlDataSource> 当KML加载完成返回一个KmlDataSource实例。

getVisibleInViewport(index){Boolean}

获取数据源对应视口的可见性。

Name Type Description
index Number

索引。

Throws:

索引值范围为0~3。

Type
DeveloperError
Returns:
Type Description
Boolean visible 可见性。

load(data){Promise.<KmlDataSource>}

以URL形式加载KML图层。

Name Type Description
data String | Document | Blob

图层URL或者包含KML解析文档的BLOB。

options.camera Camera

相机对象。

options.canvas Canvas

画布对象。

Returns:
Type Description
Promise.<KmlDataSource> 当KML加载完成返回一个KmlDataSource实例。

setVisibleInViewport(index, visible)

设置数据源对应视口的可见性。

Name Type Description
index Number

索引。

visible Boolean

可见性。

Throws:

索引值范围为0~3。

Type
DeveloperError

update(time)

更新所有需要更新的网络链接。

Name Type Description
time JulianDate

模拟时间。 如果数据源在规定的时间内显示则为true,否则为false。