路线导入异常排查——GPX 导入失败、Google Maps 链接解析不了

问题一：GPX 文件导入报错或崩溃

症状：选择 GPX 文件后 TravelBoast 闪退、提示"无法导入"或导入后路线显示异常。

文件格式不兼容：虽然 TravelBoast 支持标准 GPX 格式，但极少数 APP 导出的是非标准格式（GPX 1.0 vs 1.1 版本差异、缺失必填字段、扩展字段导致解析器崩溃）。

解决：用免费的 GPX 转换工具（比如 GPS Visualizer、GPX Viewer）把原始 GPX 转成标准格式后再导入。转换时确保只保留基础的航点数据（经纬度、时间戳），去掉扩展字段。

文件过大：超过 10 MB 的 GPX 文件可能导致移动设备内存不足而崩溃。一次长时间的骑行/徒步可能产生几万个 GPS 点。

解决：在源追踪 APP 里先简化轨迹——大多数 APP 有"简化轨迹"或"精简数据"选项，可以把几万点压缩到几千点。简化后再导出 GPX，文件大小会大幅减小。

路径太深：GPX 文件如果存在多级嵌套目录下，某些机型的文件浏览器选择时可能有问题。

解决：把 GPX 文件移动到设备根目录（比如 /download 或 /documents），文件名改短一点（避免特殊字符）。

路线不在道路上：GPX 数据本身有漂移（GPS 信号不好时常见）。可以用路线调整功能手动把偏掉的航点拖回道路上。

航点数量过多：导入后可能有几千个航点，播放动画会非常慢。解决方法是在导入后批量删除不重要的中间航点——保留关键转弯点和停靠点即可。

症状：把 Google Maps 的路线分享链接粘进 TravelBoast，点确认后没任何反应或提示无法解析。

链接不完整：复制时没把整条 URL 复制全。Google Maps 路线链接很长，尤其是经纬度参数部分。解决：重新完整复制一遍，确保从 https://www.google.com/maps/dir/ 一直到末尾都复制到。

链接设为私密：如果 Google Maps 路线设置了只有特定人可查看（不是公开的），TravelBoast 无法访问解析。解决：在 Google Maps 里把路线分享权限改为"知道链接的任何人"或"公开"。

网络问题：TravelBoast 需要联网解析链接。确认手机网络正常（Wi-Fi 或 4G/5G 均可），然后重试。

链接类型不匹配：Google Maps 有多种链接（搜索结果、地点详情、导航路线），TravelBoast 只支持导航路线链接（包含 dir/ 的那类）。如果粘贴的是其他类型的链接，会解析失败。

症状：输入地名后搜索结果为空或严重偏离。

拼写错误：中英文混输、特殊字符、多音字都可能导致搜索失败。先确认拼写正确。

名称太通用：比如输入"西湖"会返回好几个同名地点。解决：加上限定词（"杭州西湖""中国西湖"）。

地图源数据缺失：TravelBoast 接入多家地图源，不同地区的数据完整度不同。如果某个地名搜不到，试试直接在地图上点击大概位置手动定位，然后微调。

网络问题：搜索功能需要联网。确认网络正常。