处理 Keyhole 标记语言 2.2 (KML) 的
DataSource
。
Cesium 中的 KML 支持不完整，但支持大量标准以及 Google 的
gx
扩展命名空间。有关支持和不支持的详细列表，请参阅 Github 问题
#873
。 Cesium 在遇到大多数不支持的功能时也会将信息写入控制台。
非视觉特征数据，例如
atom:author
和
ExtendedData
通过
KmlFeatureData
的实例公开，该实例添加到
kml
属性下的每个
Entity
。
| Name | Type | Description |
|---|---|---|
options
|
KmlDataSource.ConstructorOptions | 描述初始化选项的 可选 对象 |
Example:
const 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
camera : Camera |undefined
此画布的当前大小将用于填充客户端高度和宽度的链接参数。
changedEvent : Event
获取将在基础数据更改时引发的事件。
获取加载的 KML 定义的时钟设置。这表示所有时间动态数据的总可用性间隔。如果 KML 不包含时间动态数据，则该值未定义。
clustering : EntityCluster
获取或设置此数据源的聚类选项。该对象可以在多个数据源之间共享。
credit : Credit
获取将为数据源显示的信用
获取
Entity
实例的集合。
errorEvent : Event
获取在处理过程中遇到错误时将引发的事件。
获取一个值，该值指示数据源当前是否正在加载数据。
kmlTours : Array.< KmlTour >
获取用于在给定时间间隔内将相机引导至指定目的地的 KML Tours。
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 | 包含二进制 KMZ 数据或已解析 KML 文档的 url、已解析 KML 文档或 Blob。 |
options
|
KmlDataSource.ConstructorOptions | 可选 指定配置选项的对象 |
Returns:
加载 KML 后将解析为新 KmlDataSource 实例的承诺。
清除数据源创建的任何非实体元素。目前这只影响 ScreenOverlay 元素。
load (data, options ) → Promise.< KmlDataSource >
异步加载提供的 KML 数据，替换任何现有数据。
| Name | Type | Description |
|---|---|---|
data
|
Resource | String | Document | Blob | 包含二进制 KMZ 数据或已解析 KML 文档的 url、已解析 KML 文档或 Blob。 |
options
|
KmlDataSource.LoadOptions | 可选 指定配置选项的对象 |
Returns:
加载 KML 后将解析为此实例的承诺。
更新任何需要更新的 NetworkLink。
| Name | Type | Description |
|---|---|---|
time
|
JulianDate | 模拟时间。 |
Returns:
如果此数据源已准备好在提供的时间显示，则为 true，否则为 false。
Type Definitions
用于构造新 KmlDataSource 或调用静态 `load` 方法的选项。
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
camera
|
Camera |
<optional>
|
用于 viewRefreshModes 并将相机属性发送到网络链接的相机。 | |
canvas
|
HTMLCanvasElement |
<optional>
|
用于将查看器属性发送到网络链接的画布。 | |
credit
|
Credit | String |
<optional>
|
数据源的功劳，显示在画布上。 | |
sourceUri
|
String |
<optional>
|
覆盖用于解析相对链接和其他 KML 网络功能的 url。 | |
clampToGround
|
Boolean |
<optional>
|
false | 如果我们想要将几何特征（多边形、线串和线性环）固定在地面上，则为 true。 |
ellipsoid
|
Ellipsoid |
<optional>
|
Ellipsoid.WGS84 | 用于地理计算的全球椭球体。 |
screenOverlayContainer
|
Element | String |
<optional>
|
ScreenOverlay 图像的容器。 |
`load` 方法的初始化选项。
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
sourceUri
|
String |
<optional>
|
覆盖用于解析相对链接和其他 KML 网络功能的 url。 | |
clampToGround
|
Boolean |
<optional>
|
false | 如果我们想要将几何特征（多边形、线串和线性环）固定在地面上，则为 true。 |
ellipsoid
|
Ellipsoid |
<optional>
|
Ellipsoid.WGS84 | 用于地理计算的全球椭球体。 |
screenOverlayContainer
|
Element | String |
<optional>
|
ScreenOverlay 图像的容器。 |