KmlDataSource

new SuperMap3D.KmlDataSource()

处理KML标记语言（Keyhole Markup Language）的数据源。KML支持加载S3M、glTF格式的三维模型。
Example:
var viewer = new SuperMap3D.Viewer('Container');
viewer.dataSources.add(SuperMap3D.KmlDataSource.load('../../SampleData/facilities.kmz'),
     {
         camera: viewer.scene.camera,
         canvas: viewer.scene.canvas
     });
See:

Members

changedEvent : Event

获取基础数据更改时即将引发的事件。

clock : DataSourceClock

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

clustering : EntityCluster

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

credit : Credit

获取数据源凭证

entities : EntityCollection

获取Entity实例集合。

errorEvent : Event

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

isLoading : Boolean

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

loadingEvent : Event

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

name : String

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

refreshEvent : Event

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

show : Boolean

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

unsupportedNodeEvent : Event

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

Methods

staticSuperMap3D.KmlDataSource.importFile(data, options) → Promise.<KmlDataSource>

导入本地KML文件。
Name Type Description
data String KML文件存放路径。
options Object optional 对象具有以下属性:
Name Type Description
camera Camera 相机对象。
canvas Canvas canvas对象。
Returns:
导入完成返回一个KmlDataSource实例。

staticSuperMap3D.KmlDataSource.load(data, options) → Promise.<KmlDataSource>

异步加载提供的 KML 数据，替换任何现有数据。
Name Type Description
data String | Document | Blob 图层URL或者包含KML解析文档的BLOB。
options Object optional 对象具有以下属性:
Name Type Default Description
camera Camera 相机对象。
canvas Canvas 画布对象。
sourceUri String optional 覆盖用于解析相对链接和其他 KML 网络功能的url。
clampToGround Boolean false optional 如果我们想要将几何特征（多边形、线串和线性环）固定在地面上，则为 true。
ellipsoid Ellipsoid Ellipsoid.WGS84 optional 用于地理计算的全球椭球体。
credit Credit | String optional 数据源的凭证，显示在画布上。
Returns:
当KML加载完成返回一个KmlDataSource实例。

getVisibleInViewport(index) → Boolean

获取图层对应视口的可见性。
Name Type Description
index Number 索引。
Returns:
visible 可见性。
Throws:

load(data, options) → Promise.<KmlDataSource>

以URL形式加载KML图层。
Name Type Description
data String | Document | Blob 图层URL或者包含KML解析文档的BLOB。
options Object optional 对象具有以下属性:
Name Type Description
camera Camera 相机对象。
canvas Canvas 画布对象。
Returns:
当KML加载完成返回一个KmlDataSource实例。

setVisibleInViewport(index, visible)

设置图层对应视口的可见性。
Name Type Description
index Number 索引。
visible Boolean 可见性。
Throws:

update(time)

更新所有需要更新的网络链接。
Name Type Description
time JulianDate 模拟时间。 如果数据源在规定的时间内显示则为true，否则为false。