技术原理，讲清每一层

解析器接受直接经纬度、Apple Maps、Google Maps、高德和百度等常见链接。它从 URL、查询参数或页面响应中提取地点名称和坐标，并返回来源、置信度、原始坐标系与警告。

• 输入长度受限，坐标必须在纬度 ±90、经度 ±180 的合法范围内。
• 短链最多跟随有限次数跳转，并拒绝访问本机、内网和云元数据地址。
• 无法识别时返回明确错误，不会猜一个看似合理的地点。

输入  https://maps.google.com/.../@37.795490,-122.393700
输出  source=google_maps · system=WGS84 · confidence=0.94

不同地图可能展示 WGS84、GCJ-02 或 BD-09。WLOC 保留原始坐标和值，同时把内部目标统一到 WGS84，并将结果保留到小数点后 6 位，便于收藏、路线和回归测试复用。

• 高德及中国大陆语境下的部分地图输入按 GCJ-02 处理。
• 百度输入按 BD-09 处理，并经过 GCJ-02 转换到 WGS84。
• 中国大陆范围外跳过国内坐标偏移；转换结果会提示可能存在米级误差。

original  31.230416, 121.473701 · GCJ-02
canonical 31.xxxxxx, 121.xxxxxx · WGS84

WLOC 将当前目标、收藏、路线、设备配置、诊断事件和设置编码为 JSON，原子写入 App 的 Application Support 目录。重新打开 App 后会从该快照恢复，不需要创建云端账号。

• 收藏地点和路线不是默认上传到可搜索的坐标历史。
• 重置或卸载 App 会移除本机快照；导出由用户主动触发。
• 解析和转换请求只为实时响应服务，页面会明确区分本机数据与官网分析数据。

WLOC 根据当前目标和设备配置准备官方设置资源。在兼容且已获授权的环境中，保存的目标坐标优先于默认值；没有目标时，链路保持直通，不替换真实网络定位结果。

• 这是网络定位测试链路，不是对 GPS 接收器或 Core Location 的全局写入。
• 静态目标用于单点状态；路线会按节点、时间和暂停状态推进。
• 目标 App 是否采用该结果，仍取决于自身权限、缓存、账号和服务端判断。

mode=active  → 使用已保存测试目标
mode=route   → 使用当前路线节点
mode=passthrough → 保留真实网络定位结果

诊断先检查官方 Worker 是否可达，再检查设备设置是否启用、当前模式、目标坐标、路线状态，以及最近是否观察到定位请求和相应结果。这样可以区分服务、设置、请求、缓存和目标 App 表现。

• 服务健康检查会返回环境和版本，避免把服务不可用误判为定位失败。
• 设备状态区分 active、route 与 passthrough，并记录最近的保存、清除、请求和结果时间。
• 路线运行但尚未出现请求，或已观察请求但结果未确认时，会给出不同警告。

停止路线或清除目标后，WLOC 让测试链路回到 passthrough。随后需要重新打开目标 App，确认旧城市、旧围栏或附近列表没有继续来自缓存。

• WLOC 可以清除自身目标和路线状态，但不能强制关闭其他 App。
• 它不能替 iOS 清理系统级 locationd 缓存。
• 完整证据应同时包含测试状态和恢复后的真实状态。