KmlDataSource

new Cesium.KmlDataSource(options)
DataSources/KmlDataSource.js 2564

DataSource，用于加载KML。

Cesium中的KML支持是不完整的，但是支持大量的标准，以及谷歌的gx扩展密码空间。 请参见Github发布的#873，以获取支持与不支持的详细列表。 当遇到大多数不受支持的特性时，Cesium也会将信息写入控制台。

非可视要素（visual feature）数据，如atom:author和ExtendedData通过一个KmlFeatureData的实例公开， 该实例在kml属性下添加到每个Entity。

Name Type Description
options Object 此对象拥有以下属性：
Name Type Default Description
camera Camera 用于viewRefreshModes并将相机属性发送到网络链接的相机。
canvas Canvas 用于向网络链接发送查看器属性的画布。
ellipsoid Ellipsoid Ellipsoid.WGS84 optional 椭球。
credit Credit | String optional 版权信息。
Example:
var viewer = new Cesium.Viewer('cesiumContainer');
viewer.dataSources.add(Cesium.KmlDataSource.load('../../SampleData/facilities.kmz',
     {
          camera: viewer.scene.camera,
          canvas: viewer.scene.canvas
     })
);
Demo:
See:

Members

changedEvent : Event
DataSources/KmlDataSource.js 2688

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

clock : DataSourceClock
DataSources/KmlDataSource.js 2658

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

clustering : EntityCluster
DataSources/KmlDataSource.js 2753

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

credit : Credit
DataSources/KmlDataSource.js 2771

获取将显示为数据源的版权。

entities : EntityCollection
DataSources/KmlDataSource.js 2668

获取Entity实例集合。

errorEvent : Event
DataSources/KmlDataSource.js 2698

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

isLoading : Boolean
DataSources/KmlDataSource.js 2678

获取数据源当前是否正在加载数据。

loadingEvent : Event
DataSources/KmlDataSource.js 2708

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

name : String
DataSources/KmlDataSource.js 2641

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

refreshEvent : Event
DataSources/KmlDataSource.js 2718

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

show : Boolean
DataSources/KmlDataSource.js 2738

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

unsupportedNodeEvent : Event
DataSources/KmlDataSource.js 2728

当读取到不支持的节点类型时引发该事件。

Methods

staticCesium.KmlDataSource.load(data, options) → Promise.<KmlDataSource>
DataSources/KmlDataSource.js 2628

根据提供的KML数据，创建加载数据的新实例。
Name Type Description
data Resource | String | Document | Blob URL，包含二进制KMZ数据的URL，已解析的KML文档或Blob或已解析的KML文档。
options Object 此对象拥有以下属性：
Name Type Default Description
camera Camera 用于viewRefreshModes并将相机属性发送到网络链接的相机。
canvas Canvas 用于向网络链接发送查看器属性的画布。
sourceUri String optional 覆盖用于解析相对链接和其他KML网络要素的url。
clampToGround Boolean false optional 决定几何要素（Polygons, LineStrings 和 LinearRings）是否贴地。
ellipsoid Ellipsoid Ellipsoid.WGS84 optional 椭球。
credit Credit | String optional 版权信息。
Returns:
一旦KML加载完成，将解析到一个新的KmlDataSource实例的一个promise。

load(data, options) → Promise.<KmlDataSource>
DataSources/KmlDataSource.js 2788

异步加载提供的KML数据，替换任何现有数据。
Name Type Description
data Resource | String | Document | Blob URL，解析KML文档或包含二进制KMZ数据Blob或已解析的KML文档。
options Object optional 此对象拥有以下属性：
Name Type Default Description
sourceUri Resource | String optional 覆盖用于解析相对链接和其他KML网络要素的url。
clampToGround Boolean false optional 决定几何要素（Polygons, LineStrings 和 LinearRings）是否贴地。
ellipsoid Ellipsoid Ellipsoid.WGS84 optional 椭球。
Returns:
一个promise，它将在KML加载后解析到这个实例。

update(time) → Boolean
DataSources/KmlDataSource.js 3006

更新所有需要更新的网络连接。
Name Type Description
time JulianDate 时间。
Returns:
如果此数据源准备在提供的时间显示，则为true，否则为false。