KmlDataSource

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

处理Keyhole标记语言2.2（KML）的DataSource。

KML support in Cesium is incomplete, but a large amount of the standard, as well as Google's gx extension namespace, is supported. See Github issue #873 for a detailed list of what is and isn't support. Cesium will also write information to the console when it encounters most unsupported features.

Non visual feature data, such as atom:author and ExtendedData is exposed via an instance of KmlFeatureData, which is added to each Entity under the kml property.

Name Type Description
options Object 具有以下属性的对象：
Name Type Default Description
camera Camera 用于viewRefreshModes和将相机属性发送到网络链接的相机。
canvas HTMLCanvasElement 用于将查看器属性发送到网络链接的画布。
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 3515

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

clock : DataSourceClock
DataSources/KmlDataSource.js 3485

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

clustering : EntityCluster
DataSources/KmlDataSource.js 3580

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

credit : Credit
DataSources/KmlDataSource.js 3598

获取将为数据源显示的点数

entities : EntityCollection
DataSources/KmlDataSource.js 3495

获取Entity个实例的集合。

errorEvent : Event
DataSources/KmlDataSource.js 3525

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

isLoading : Boolean
DataSources/KmlDataSource.js 3505

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

loadingEvent : Event
DataSources/KmlDataSource.js 3535

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

name : String
DataSources/KmlDataSource.js 3467

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

refreshEvent : Event
DataSources/KmlDataSource.js 3545

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

show : Boolean
DataSources/KmlDataSource.js 3565

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

unsupportedNodeEvent : Event
DataSources/KmlDataSource.js 3555

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

Methods

static Cesium.KmlDataSource.load(data, options) → Promise.<KmlDataSource>
DataSources/KmlDataSource.js 3454

创建对加载了提供的KML数据的新实例的承诺。
Name Type Description
data Resource | String | Document | Blob 包含二进制KMZ数据或已解析KML文档的url、已解析KML文档或Blob。
options KmlDataSource.LoadOptions optional 指定配置选项的对象
Returns:
一个承诺，一旦KML被加载，它将解析为一个新的KmlDataSource实例。

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

异步加载提供的KML数据，替换任何现有数据。
Name Type Description
data Resource | String | Document | Blob 包含二进制KMZ数据或已解析KML文档的url、已解析KML文档或Blob。
options Object optional 具有以下属性的对象：
Name Type Default Description
sourceUri Resource | String optional 重写用于解析相对链接和其他KML网络功能的url。
clampToGround Boolean false optional 如果希望几何体特征（多边形、线串和线阵）固定在地面上，则为true。如果为true，则线将使用走廊，因此使用实体.走廊而不是实体.折线.
ellipsoid Ellipsoid Ellipsoid.WGS84 optional 用于地理计算的全局椭球体。
Returns:
一个承诺，一旦KML被加载，就会解决这个问题。

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

更新任何需要更新的网络链接。
Name Type Description
time JulianDate 模拟时间。
Returns:
如果此数据源已准备好在提供的时间显示，则为True，否则为false。

Type Definitions

Cesium.KmlDataSource.LoadOptions
DataSources/KmlDataSource.js 3341

“load”方法的初始化选项。
Properties:
Name Type Attributes Default Description
camera Camera 用于viewRefreshModes和将相机属性发送到网络链接的相机。
canvas HTMLCanvasElement 用于将查看器属性发送到网络链接的画布。
sourceUri String <optional>
 重写用于解析相对链接和其他KML网络功能的url。
clampToGround Boolean <optional>
 false 如果希望几何体特征（多边形、线串和线阵）固定在地面上，则为true。
ellipsoid Ellipsoid <optional>
 Ellipsoid.WGS84 用于地理计算的全局椭球体。
credit Credit | String <optional>
 显示在画布上的数据源的贷方。