Function explainGeoError

frontend/src/App.tsx:764–788

(err: GeolocationPositionError)

  }, [tracking]);

  function explainGeoError(err: GeolocationPositionError) {
    if (err.code === err.PERMISSION_DENIED) {
      return {
        message: "定位权限被 Safari 或系统拒绝，页面无法开始记录。",
        hint:
          "如果没有看到弹窗，通常是之前拒绝过本站或 Safari 定位被关闭。请到 iPhone 设置 > 隐私与安全性 > 定位服务，确认 Safari 网站允许定位；也可以在 Safari 地址栏左侧的 aA/网站设置里把 map.suishouai.cn 的位置权限改为允许，然后刷新页面再点开始。",
      };
    }
    if (err.code === err.POSITION_UNAVAILABLE) {
      return {
        message: "暂时拿不到当前位置。",
        hint: "请确认手机定位服务已开启，Safari 可以访问位置，并尽量到室外或网络信号更好的位置重试。",
      };
    }
    if (err.code === err.TIMEOUT) {
      return {
        message: "定位请求超时。",
        hint: "请保持页面在前台，等待几秒后重试；如果一直超时，检查 Safari 的定位权限和手机网络。",
      };
    }
    return {
      message: `定位失败：${err.message}`,
      hint: "请检查 Safari 和系统定位权限后重试。",
    };
  }

  async function checkLocationPermission() {
    const permissionsApi = (navigator as any).permissions;