by 运行时依赖
安装命令
点击复制技能文档
GPX / KML 路线可视化器概述 将 GPS 跟踪文件（KML/GPX）转换为专业的路线可视化输出： 静态 JPG：高分辨率图像，包含路线地图、海拔-profile 和统计面板 交互式 HTML：基于浏览器的 Leaflet 地图，具有缩放、图层切换和嵌入的海拔图表
工作流程 步骤 1：解析跟踪文件 运行解析脚本以提取坐标并计算统计数据： python scripts/parse_track.py -o track_data.json 这将生成一个 JSON 文件，包含： 解析的跟踪点（lat、lon、ele、累计距离） 路线统计数据（总距离、海拔增减、最大/最小/平均海拔）
步骤 2：生成可视化 根据用户请求选择输出格式： 选项 A：静态 JPG 图像 生成可打印的静态路线地图图像： python scripts/plot_static.py track_data.json -o route_map.jpg --dpi 150 输出布局： 顶部面板：路线轨迹，具有海拔基于的颜色渐变、起始/结束标记和海拔颜色条 底部面板：距离与海拔-profile，具有增减注释 页脚：关键统计文本条 选项 B：交互式 HTML 地图 生成基于浏览器的交互式地图： python scripts/plot_interactive.py track_data.json -o route_map.html 功能： Leaflet 地图，中心位于路线，具有 OSM、卫星和地形图层 路线根据海拔着色（viridis 渐变） 可点击的起始/结束标记，具有坐标和海拔 自动适应边界以显示整个路线 嵌入的海拔-profile 图像，位于地图下方 统计头部面板
合并的单行工作流程 对于快速生成，链式脚本： # 静态 JPG python scripts/parse_track.py input.gpx -o track_data.json && python scripts/plot_static.py track_data.json -o route_map.jpg # 交互式 HTML python scripts/parse_track.py input.gpx -o track_data.json && python scripts/plot_interactive.py track_data.json -o route_map.html
依赖项 所需的 Python 包： pip install matplotlib numpy folium Pillow matplotlib：静态绘图和图像生成 numpy：用于统计的数值操作 folium：交互式 Leaflet HTML 地图生成 Pillow：图像处理（通常与 matplotlib 一起安装） 所有脚本仅使用 Python 标准库加上上述包。
脚本参考 脚本目的 输入 输出 scripts/parse_track.py 解析 KML/GPX，计算统计数据 .kml 或 .gpx track_data.json scripts/plot_static.py 生成静态 JPG track_data.json .jpg 图像 scripts/plot_interactive.py 生成交互式 HTML track_data.json .html 页面
文件格式支持 KML：解析 元素，位于 内（支持 KML 2.1 和 2.2 命名空间） GPX：解析具有 lat/lon 属性和 子元素的 元素（GPX 1.1） 有关详细的格式规范，请参阅 references/formats.md。
注意事项 静态 JPG 的 DPI 可以增加（--dpi 300）以获得打印质量输出 交互式 HTML 是完全自包含的（生成后无外部依赖），除地图图块 CDN 请求外 解析器可以自动处理命名空间和非命名空间 XML 大型跟踪文件（>100k 点）可能需要几秒钟才能处理