虚拟地球导出 | Virtual Globe Export
Exports spatiotemporal point data into formats readable by virtual globes (Google Earth / Cesium): KML (Placemark + TimeStamp + ExtendedData popup info, coordinates strictly in lon,lat,alt order) and CZML (document header + cartographicDegrees position + availability time interval).
The synthetic mode generates a diagonal flight track with timestamps, ideal for demonstrating temporal dynamics.
Core Algorithm / 核心算法
format_kml_coord(lon,lat,alt) strictly puts longitude first → build_kml(TimeStamp/ExtendedData/Point|LineString) → build_czml(document wrapper + position.cartographicDegrees + availability).
Dependencies / 依赖
pip install numpy rasterio scipy matplotlib geopandas shapely pillow
Usage / 使用方法
Example 1 (Synthetic Data, Offline)
python geoskill-virtual-globe-export.py --bbox 116.0 39.0 117.0 40.0 --synthetic --output-dir ./out
示例 2（仅导 KML）
python geoskill-virtual-globe-export.py --input track.geojson --format kml --name "flight route"
示例 3（仅导 CZML）
python geoskill-virtual-globe-export.py --input track.geojson --format czml
Example 4 (Synthetic 20-Point Flight Track)
python geoskill-virtual-globe-export.py --bbox 116 39 117 40 --synthetic --points 20
示例 5（CSV 点输入）
python geoskill-virtual-globe-export.py --input points.csv --format both
Output / 输出
| File | Format | Description |
|---|---|---|
export.kml |
KML | KML document (primary output) |
export.czml |
CZML | Cesium time-dynamic JSON |
export.json |
JSON | Structured features (verifiable output) |
track_density.tif |
GeoTIFF | Track density raster |
Each run also produces output-manifest.json (run manifest).
Data Source / 数据源 / Source
Local GeoTIFF / vector files; --synthetic mode generates physically consistent simulated data, fully offline.
Privacy / 隐私声明 / Privacy
- Runs offline by default;
--syntheticmode requires no network at all. - All processing is done locally; no user data is uploaded.
License / License
MIT
name: geoskill-virtual-globe-export description: 'Export data to KML or CZML with time attributes and popup info for virtual globes'
虚拟地球导出 | Virtual Globe Export
把时空点数据导出为虚拟地球（Google Earth / Cesium）可读格式：KML（Placemark+TimeStamp+ExtendedData 弹出信息，坐标严格 lon,lat,alt）与 CZML（document 包头 + cartographicDegrees position + availability 时间区间）。
合成模式生成带时间戳的对角线移动航迹，便于演示时间动态。
核心算法
format_kml_coord(lon,lat,alt) 严格经度在前 → build_kml(TimeStamp/ExtendedData/Point|LineString) → build_czml(document 包 + position.cartographicDegrees + availability)。
依赖
pip install numpy rasterio scipy matplotlib geopandas shapely pillow
使用方法
示例 1（合成数据，离线）
python geoskill-virtual-globe-export.py --bbox 116.0 39.0 117.0 40.0 --synthetic --output-dir ./out
示例 2（仅导 KML）
python geoskill-virtual-globe-export.py --input track.geojson --format kml --name "航线"
示例 3（仅导 CZML）
python geoskill-virtual-globe-export.py --input track.geojson --format czml
示例 4（合成 20 点航迹）
python geoskill-virtual-globe-export.py --bbox 116 39 117 40 --synthetic --points 20
示例 5（CSV 点输入）
python geoskill-virtual-globe-export.py --input points.csv --format both
输出
| 文件 | 格式 | 说明 |
|---|---|---|
export.kml |
KML | KML 文档（主产物） |
export.czml |
CZML | Cesium 时间动态 JSON |
export.json |
JSON | 结构化要素（可验证产物） |
track_density.tif |
GeoTIFF | 航迹密度栅格 |
每次运行还会产出 output-manifest.json（运行清单）。
数据源 / Source
本地 GeoTIFF / 矢量文件；--synthetic 模式生成物理一致的模拟数据，完全离线。
隐私声明 / Privacy
- 默认离线运行，
--synthetic模式完全无网络。 - 所有处理在本地完成，不上传用户数据。
License
MIT