一个
DataSource
，用于处理Keyhole标记语言2.2（KML）。
Cesium对KML的支持还不完整，但是其中有大量的标准，以及Google的
gx
扩展名称空间。见Github问题
＃873
支持什么和不支持的详细列表。cesium也会将信息写入遇到最不支持的功能时进行控制台。
非视觉特征数据，例如
atom:author
和
ExtendedData
通过
KmlFeatureData
的实例公开，该实例被添加到每个
Entity 代码>
在
kml
属性下。
| Name | Type | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options
|
Object |
具有以下属性的对象:
|
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
获取一个事件，该事件将在基础数据更改时引发。
获取由加载的KML定义的时钟设置。这代表总数所有时间动态数据的可用性间隔。如果KML不包含时间动态数据，此值未定义。
clustering : EntityCluster
获取或设置此数据源的聚类选项。该对象可以在多个数据源之间共享。
credit : Credit
获取将为数据源显示的功劳
获取
Entity
实例的集合。
errorEvent : Event
获取一个在处理过程中遇到错误时将引发的事件。
获取一个值，该值指示数据源当前是否正在加载数据。
loadingEvent : Event
获取一个事件，该事件将在数据源开始或停止加载时引发。
获取或设置此实例的可读名称。加载时，该名称将自动设置为KML文档名称。
refreshEvent : Event
获取将在数据源刷新网络链接时引发的事件。
获取是否应显示此数据源。
unsupportedNodeEvent : Event
获取一个事件，该事件将在数据源找到不受支持的节点类型时引发。
Methods
static Cesium.KmlDataSource.load (data, options ) → Promise.< KmlDataSource >
创建一个对加载了所提供的KML数据的新实例的Promise。
| Name | Type | Description |
|---|---|---|
data
|
Resource | String | Document | Blob | 网址，已解析的KML文档或包含二进制KMZ数据或已解析的KML文档的Blob。 |
options
|
KmlDataSource.LoadOptions | 可选 指定配置选项的对象 |
Returns:
加载KML后，将解析为新的KmlDataSource实例的Promise。
load (data, options ) → Promise.< KmlDataSource >
异步加载提供的KML数据，替换所有现有数据。
| Name | Type | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
data
|
Resource | String | Document | Blob | 网址，已解析的KML文档或包含二进制KMZ数据或已解析的KML文档的Blob。 | ||||||||||||||||
options
|
Object |
可选
具有以下属性的对象:
|
Returns:
加载KML后，将对此实例解析的Promise。
更新所有需要更新的NetworkLink。
| Name | Type | Description |
|---|---|---|
time
|
JulianDate | 模拟时间。 |
Returns:
如果此数据源准备在提供的时间显示，则为true，否则为false。
Type Definitions
load方法的初始化选项。
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
camera
|
Camera | 用于viewRefreshModes并将摄像机属性发送到网络链接的摄像机。 | ||
canvas
|
HTMLCanvasElement | 用于将查看器属性发送到网络链接的画布。 | ||
sourceUri
|
String |
<optional>
|
覆盖用于解析相对链接和其他KML网络功能的网址。 | |
clampToGround
|
Boolean |
<optional>
|
false | 为真，如果我们希望将几何特征（多边形，线串和线性环）固定在地面上。 |
ellipsoid
|
Ellipsoid |
<optional>
|
Ellipsoid.WGS84 | 用于地理计算的全局椭球。 |
credit
|
Credit | String |
<optional>
|
数据源的信用，显示在画布上。 |