处理 Keyhole 标记语言 2.2 (KML) 的
DataSource。
Cesium 中的 KML 支持不完整，但大量标准，
以及 Google 的 gx 扩展命名空间。请参阅 Github 问题
#873 用于
支持和不支持的内容的详细列表。Cesium 还会将信息写入
控制台(当遇到大多数不受支持的功能时)。
非可视特征数据，例如 atom：author 和 ExtendedData
通过 KmlFeatureData 的实例公开，该实例将添加到每个 Entity
在 kml 属性下。
| Name | Type | Description |
|---|---|---|
options |
KmlDataSource.ConstructorOptions | optional 描述初始化选项的对象 |
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
此 Canvas 的当前大小将用于填充 Link 参数
表示客户端高度和宽度。
changedEvent : Event
获取将在基础数据更改时引发的事件。
获取由加载的 KML 定义的时钟设置。这表示总计
所有时间动态数据的可用性间隔。如果 KML 不包含
time-dynamic data，此值未定义。
获取或设置此数据源的聚类选项。此对象可以在多个数据源之间共享。
获取将为数据源显示的积分
获取
Entity 实例的集合。
errorEvent : Event
获取在处理过程中遇到错误时将引发的事件。
获取一个值，该值指示数据源当前是否正在加载数据。
kmlTours : Array.<KmlTour>
获取用于在给定时间间隔内将照相机引导至指定目的地的 KML 游览。
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 | url、解析的 KML 文档或包含二进制 KMZ 数据或解析的 KML 文档的 Blob。 |
options |
KmlDataSource.ConstructorOptions | optional 指定配置选项的对象 |
Returns:
加载 KML 后将解析为新 KmlDataSource 实例的 Promise。
清理数据源创建的任何非实体元素。目前，这仅影响 ScreenOverlay 元素。
load(data, options) → Promise.<KmlDataSource>
异步加载提供的 KML 数据，替换任何现有数据。
| Name | Type | Description |
|---|---|---|
data |
Resource | string | Document | Blob | url、解析的 KML 文档或包含二进制 KMZ 数据或解析的 KML 文档的 Blob。 |
options |
KmlDataSource.LoadOptions | optional 指定配置选项的对象 |
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 | 如果我们想将几何特征(多边形、LineString 和 LinearRings)固定到地面上，则为 true。 |
ellipsoid |
Ellipsoid |
<optional> |
Ellipsoid.default | 用于地理计算的全局椭球。 |
screenOverlayContainer |
Element | string |
<optional> |
ScreenOverlay 图片的容器。 |
'load' 方法的初始化选项。
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
sourceUri |
string |
<optional> |
覆盖用于解析相对链接和其他 KML 网络功能的 URL。 | |
clampToGround |
boolean |
<optional> |
false | 如果我们想将几何特征(多边形、LineString 和 LinearRings)固定到地面上，则为 true。 |
ellipsoid |
Ellipsoid |
<optional> |
Ellipsoid.default | 用于地理计算的全局椭球。 |
screenOverlayContainer |
Element | string |
<optional> |
ScreenOverlay 图片的容器。 |