#moonkml

#安装

moon add cp15695540483/moonkml

import {
  "cp15695540483/moonkml" @kml,
}

#能力

#使用

#解析 KML 文本

let doc = try! @kml.parse(kml_text)
println(doc.name)
for pm in doc.placemarks {
  match pm.geometry {
    Some(@kml.Geometry::Point(p)) => println(pm.name + ": " + p.lon.to_string() + ", " + p.lat.to_string())
    Some(@kml.Geometry::LineString(ls)) => println(pm.name + ": " + ls.point_count().to_string() + " vertices")
    Some(@kml.Geometry::Polygon(poly)) => println(pm.name + ": " + poly.inner_count().to_string() + " holes")
    Some(@kml.Geometry::MultiGeometry(gs)) => println(pm.name + ": " + gs.length().to_string() + " parts")
    Some(@kml.Geometry::GxTrack(t)) => println(pm.name + ": " + t.point_count().to_string() + " track points")
    None => println(pm.name + ": no geometry")
  }
}

#读写 KMZ

let doc = try! @kml.kmz_parse(kmz_bytes)   // 支持 DEFLATE 压缩的标准 KMZ
let bytes = @kml.kmz_pack(doc)             // 打包为 KMZ

#导出

let geojson = @kml.to_geojson(doc)
let gpx = @kml.to_gpx(doc)
let kml_text = @kml.serialize(doc)

#命令行

moon run cmd/main -- examples/sample.kml --summary
moon run cmd/main -- examples/sample.kml --geojson
moon run cmd/main -- examples/sample.kml --gpx
moon run cmd/main -- examples/sample.kml --validate

#API 摘要

• parse(text : String) -> KmlDocument raise KmlError
• serialize(doc : KmlDocument) -> String
• kmz_parse(data : Bytes) -> KmlDocument / kmz_pack(doc) -> Bytes / kmz_pack_with(doc, extra)
• kmz_entry_names(data) -> Array[String] / kmz_extract(data, name) -> Bytes?
• to_geojson(doc) -> String / from_geojson(text) -> KmlDocument
• to_gpx(doc) -> String / from_gpx(text) -> KmlDocument
• validate(doc) -> Array[ValidationIssue]：文档质检
• parse_xml(text) -> XmlElement raise KmlError（通用 XML 子集）
• KmlDocument::{ name, placemarks, styles, style_maps, placemark_count(), style_count(), style_map_count(), find_style(id), find_style_map(id) }
• Placemark::{ name, description, geometry, style_url, extended_data, folder, timestamp, has_geometry(), has_point(), has_line_string(), has_multi_geometry(), has_gx_track(), has_time(), data_count(), find_data(name) }
• Placemark::new(name, geometry)：便捷构造
• Geometry::{ Point(KmlPoint), LineString(KmlLineString), Polygon(KmlPolygon), MultiGeometry(Array[Geometry]), GxTrack(KmlGxTrack) }
• KmlPolygon::{ outer, inner, inner_count() }、KmlStyle::{ id, line_color, line_width, fill_color }

#设计说明

• XML 子集：KML 只需要元素、属性、文本、CDATA、注释、处理指令与常见实体引用；不实现 DTD 实体展开与命名空间解析，未知元素直接忽略（KML 允许扩展元素）。
• 错误模型：KmlError 区分 XML 结构错误（带字节偏移）、KML 语义错误（缺 coordinates、坐标非法）与宿主 I/O 错误，便于调用方给出可定位的报错。
• 坐标解析：单次除法/乘法做十进制定标，避免逐位缩放带来的多次舍入；测试用 1e-9 容差断言。
• ZIP 策略：读取支持 Stored 与 DEFLATE（DEFLATE 解压复用 moonbit-community/flate，纯 MoonBit）；写入使用 DEFLATE + CRC32。

#性能

#覆盖范围

#构建与测试

moon check --target wasm-gc --deny-warn
moon test --target wasm-gc
moon test --target js
moon fmt --check

#许可证

#参考

• OGC KML 2.2 标准
• RFC 7946（GeoJSON）、GPX 1.1 Schema
• moonbit-community/flate（DEFLATE 引擎，Apache-2.0）