UD5工具箱
Geolocation API
浏览器提供的 Web API，允许网页在用户授权后获取设备的地理位置。通过 navigator.geolocation 对象访问，支持单次获取和持续追踪两种模式。位置数据来源于 GPS、Wi-Fi 三角定位、蜂窝基站定位或 IP 地址定位。精度因来源而异。是本工具的核心技术基础，所有定位功能均基于此 API 实现。工具使用了该 API 的两个主要方法：getCurrentPosition 和 watchPosition。
getCurrentPosition()
Geolocation API 的单次获取方法，调用后浏览器弹出权限请求，用户允许后返回一个 PositionPosition 对象。该方法接收两个回调函数参数：成功回调返回坐标数据，失败回调返回错误信息。适合签到、定位检测等一次性场景。本工具的「获取当前位置」按钮即调用此方法。方法执行后更新时间戳自动刷新。
watchPosition()
Geolocation API 的持续监听方法，当设备位置发生变化时自动触发回调函数。返回一个 watchId，可通过 clearWatch() 方法停止监听。每次位置发生显著变化时自动回调回调函数。适合导航、运动追踪等需要持续监听位置变化的场景。注意持续追踪会显著增加电量消耗，建议在不需要时及时关闭。本工具开启追踪后页面会显示指示器。
纬度（Latitude）
地理坐标的纬度值，范围为 -90 到 90 度。赤道为 0 度，北极为 90 度，南极为 -90 度。在 WGS84 坐标系中用于表示单位置的南北方向。这是本工具显示的核心数据之一，与经度共同构成完整的地理坐标。十进制格式直接显示度数值，度分秒格式将其分解为度、分、秒三部分。两种格式均在工具中同时显示。
经度（Longitude）
地理坐标的经度值，范围为 -180 到 180 度。本子午线为 0 度，东经为正值，西经为负值。与纬度共同构成完整的地理坐标，是地图定位的基础数据。本工具中经度值以十进制格式直接显示，方便用户理解和使用。度分秒格式中经度值作为度数部分显示。经度值的精确度取决于定位方式和设备精度。GPS 定位的经度精度通常在数位小数点后五位。
精度（Accuracy）
定位结果的误差半径，单位为米，置信度 95%。精度值越小表示定位越准确。GPS 定位通常在 3-10 米，Wi-Fi 定位在 10-50 米，IP 定位可能达数公里。本工具在定位结果中直接显示精度值，帮助用户评估定位结果的可靠性。精度属性与地图上的半透明圆形可视化区域对应，圆形半径即为精度值。建议用户在不同环境中测试以了解精度变化。
海拔（Altitude）
设备当前位置的海拔高度，单位为米。仅在 GPS 硬件可用时才能获取，桌面设备通常显示不可用。海拔的精度通常低于水平精度，误差可能达数十米。本工具在海拔数据不可用时显示「不可用」提示。智能手机在户外开启 GPS 时可以获取海拔信息。海拔数据对户外运动和地形分析场景有重要价值。
WGS84 坐标系
World Geodetic System 1984，全球最广泛使用的地理坐标系。GPS 设备和浏览器 Geolocation API 返回的坐标均基于此坐标系。支持十进制和度分秒两种格式：十进制格式将纬度和经度分别表示为小数，度分秒格式将其分解为度、分、秒三部分。本工具同时显示两种格式方便对比和使用。转换方法为取整数部分为度，小数部分乘以 60 取整数为分，余下小数乘以 60 为秒。
速度（Speed）
设备当前移动速度，单位为米每秒。仅在具备 GPS 硬件且开启定位服务时可获取。通过 Wi-Fi 或 IP 定位无法提供速度信息。本工具在速度数据不可用时显示提示文本。速度数据对运动追踪场景特别有用，可以实时反映用户的移动速度。在持续追踪模式下，速度数据会随每次位置更新自动刷新。速度的准确性取决于设备的 GPS 精度。