纯 MoonBit 的 KML/KMZ 读写库:文档模型、XML 解析、点/线/面几何与样式
moon add cp15695540483/moonkmlimport {
"cp15695540483/moonkml" @kml,
}| 能力 | 状态 |
|---|---|
| KML 解析(XML 子集:元素、属性、文本、CDATA、注释、PI、实体引用) | ✅ |
| 几何:Point / LineString / Polygon(外环 + 内环)/ MultiGeometry / gx:Track | ✅ |
| Placemark name / description / styleUrl / Folder 路径 / TimeStamp·TimeSpan | ✅ |
| Style(LineStyle / PolyStyle / IconStyle / LabelStyle)与 StyleMap | ✅ |
| ExtendedData(Data name/value) | ✅ |
| KML 序列化(模型 → KML 文本) | ✅ |
| KMZ 读写(ZIP + DEFLATE + CRC32);多条目/资源提取 | ✅ |
| GeoJSON 导入与导出(RFC 7946)、GPX 1.1 导入与导出 | ✅ |
| 数据校验(坐标越界、环闭合、样式悬空、gx:Track 一致性) | ✅ |
| 命令行:摘要 / GeoJSON / GPX 输出 / 校验 | ✅ |
| Camera / LookAt / NetworkLink / 三维模型与叠置图层 | 未实现(明确不做,见覆盖矩阵) |
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")
}
}let doc = try! @kml.kmz_parse(kmz_bytes) // 支持 DEFLATE 压缩的标准 KMZ
let bytes = @kml.kmz_pack(doc) // 打包为 KMZlet kml_text = @kml.serialize(doc) // KML
let kmz = @kml.kmz_pack(doc) // KMZ
let geojson = @kml.to_geojson(doc) // GeoJSON
let gpx = @kml.to_gpx(doc) // GPX
let doc2 = try! @kml.from_geojson(geojson_text)
let doc3 = try! @kml.from_gpx(gpx_text)
let doc4 = try! @kml.kmz_parse(kmz_bytes)# 输入可以是 .kml / .kmz / .geojson / .gpx
moon run cmd/main -- examples/sample.kml --summary
moon run cmd/main -- examples/oracle.kmz --kml
moon run cmd/main -- examples/sample.gpx --geojson
moon run cmd/main -- examples/sample.geojson --gpx
moon run cmd/main -- examples/negative/broken.kml --validate # 退出码 1moon fmt --check
moon check --target wasm-gc --deny-warn
moon test --target wasm-gc && moon test --target js && moon test --target nativepython tools/roundtrip_check.py # 双后端输出逐字节一致 + 往返守恒
python tools/gen_oracle.py # 用 simplekml 生成独立实现产物| 用例 | 平均耗时 |
|---|---|
| 解析 1000 个点 Placemark | 5.15 ms |
| 序列化 1000 个点 Placemark | 1.24 ms |
| KMZ 打包(200 点) | 2.28 ms |
| KMZ 解包(200 点) | 1.04 ms |
python tools/record_demo.py --ffmpeg <ffmpeg 路径>| 包 | 职责 |
|---|---|
| src/core | 文档模型、XML 子集解析、文本与数值基元、字节输出基元 |
| src/kml | KML 读写:几何解析、文档解析、序列化 |
| src/formats | GeoJSON 与 GPX 互转 |
| src/kmz | ZIP 容器与 KMZ 打包解包 |
| src/check | 文档校验 |
| facade.mbt | 用 pub using 重导出,调用方仍是 @kml.xxx |