KmlDataSource - Cesium Documentation

new LSGlobe.KmlDataSource(options)

处理KML标记语言(Keyhole Markup Language)的数据源。

LSGlobe中的KML支持不完整，但支持大量的标准以及Google的gx扩展名请参阅Github问题 #873以获取有关和不支持的详细列表。当LSGlobe遇到大多数不支持的功能时，LSGlobe也会向控制台写入信息。

非视觉特征数据（例如atom：author和ExtendedData）通过添加到kml属性下的每个Entity的KmlFeatureData实例公开

Name Type Description

options

Object

对象具有以下属性:

Name	Type	Default	Description
`camera`	Camera		viewRefreshModes将camera的属性发送到网络链接的camera
`canvas`	Canvas		canvas将viewer属性发送到网络链接的cancas
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 用于地理计算的椭球体

Example:

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

Demo:

KML Demo

Members

changedEvent : Event

基础数据更改时将引发的事件

clock : DataSourceClock

获取由加载的KML定义的clock设置。这表示所有时间动态数据的总可用时间间隔。如果KML不包含时间动态数据，则此值undefined

clustering : EntityCluster

获取或设置此数据源的集群选项。该对象可以在多个数据源之间共享

entities : EntityCollection

获取Entity实例的集合

errorEvent : Event

获取在处理期间遇到错误时将引发的事件

isLoading : Boolean

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

loadingEvent : Event

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

name : String

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

refreshEvent : Event

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

show : Boolean

获取是否应显示此数据源

unsupportedNodeEvent : Event

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

Methods

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

以URL形式加载KML图层

Name Type Description

data String | Document | Blob 图层URL或者包含KML解析文档的BLOB

options

Object

optional 对象具有以下属性:

Name	Type	Default	Description
`camera`	Camera		相机对象
`canvas`	Canvas		canvas对象
`proxy`	DefaultProxy		optional 用来加载外部数据的代理服务器
`sourceUri`	String		optional 覆盖用于解析相关链接和其他KML网络功能的url
`clampToGround`	Boolean	`false`	optional 如果我们想让几何体贴地，则设置为true。如果为true，lines将会采用entity.corridor对象而不是entity的polygon对象
`query`	Object		optional 给CZML中的所有URI附加Key-value对

Returns:

当KML加载完成返回一个KmlDataSource实例

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

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

Name Type Description

data Resource | String | Document | Blob 图层URL或者包含KML解析文档的BLOB

options

Object

optional 对象具有以下属性:

Name	Type	Default	Description
`sourceUri`	Resource \| String		optional 覆盖用于解析相关链接和其他KML网络功能的url
`clampToGround`	Boolean	`false`	optional 如果我们希望几何特征（多边形，线条和线性环）固定在地面，则为true。如果为true，则线条将使用corridors，因此请使用Entity.corridor而不是Entity.polyline
`query`	Object		optional 给CZML中的所有URI附加Key-value对.
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 用于地理计算的椭球体

Returns:

KML加载完成返回一个KmlDataSource实例

update(time) → Boolean

更新任何需要更新的NetworkLink

Name	Type	Description
`time`	JulianDate	The simulation time.