exportKml

exportKml (options) Promise.<Object>

将EntityCollection导出为KML文档。仅点,广告牌,模型,路径,多边形,折线几何将被导出。请注意,实体属性到KML要素属性没有一对一的映射。对于例如,时间动态但在KML中不能动态的实体属性将其值导出为options.time或EntityCollection时间间隔的开始(如果未指定)。对于时间动态特性KML支持的代码,如果它是 SampledProperty ,我们将使用样本,否则我们将使用options.sampleDuration。具有时间动态位置的点,广告牌,模型和路径几何将被导出如gx:跟踪功能。并非所有材料都可以用KML表示,因此对于更高级的材料,主要使用颜色。画布对象将导出为PNG图像。
Name Type Description
options Object 具有以下属性的对象:
名称 类型 默认 说明
实体 EntityCollection EntityCollection导出为KML。
椭球 椭球 Ellipsoid.WGS84 可选 输出文件的椭圆体。
modelCallback exportKml〜ModelCallback 可选 将使用 ModelGraphics 实例调用的回调,该回调应返回要在KML中使用的URI。如果实体集合中存在模型,则为必需。
时间 JulianDate entities.computeAvailability()。start 可选 用于获取在KML中不随时间变化的属性的时间值。
defaultAvailability TimeInterval entities.computeAvailability() 可选 如果实体没有可用性,将采样的间隔。
sampleDuration 数字 60 可选 在KML中对属性进行采样的秒数。
kmz 布尔值 错误 可选 如果为true,则KML和外部文件将被压缩为kmz文件。
Returns:
承诺已解析为包含KML字符串和外部文件Blob字典的对象,或者如果options.kmz为true,则将kmz文件作为Blob解析。
Example:
Cesium.exportKml({
     entities: entityCollection
 })
  .then(function(result) {
    // The XML string is in result.kml

    var externalFiles = result.externalFiles
    for(var file in externalFiles) {
      // file is the name of the file used in the KML document as the href
      // externalFiles[file] is a blob with the contents of the file
    }
  });
Demo:

Type Definitions

ModelCallback (model, time, externalFiles) String

由于KML不支持glTF模型,因此需要此回调来在KML文档中指定用于该模型的URL。它还可以用于将其他文件添加到 externalFiles 对象,该对象是嵌入在导出的KMZ中的文件列表,否则在导出时随KML字符串一起返回。
Name Type Description
model ModelGraphics 实体的ModelGraphics实例。
time JulianDate 任何属性应用于获取值的时间。
externalFiles Object 将文件名映射到Blob或解析为Blob的Promise的对象。
Returns:
KML文档中用于href的URL。