如何使用 wx.getLocation 获取地理位置？

推荐答案

-- -------------------- ---- -------
----------------
  ----- --------
  ------------ -
    ----- -------- - ------------
    ----- --------- - -------------
    ------------------ ---------
    ------------------ ----------
  --
  --------- -
    -------------------------- ----
  -
--

本题详细解读

1. wx.getLocation 的基本用法

wx.getLocation 是微信小程序提供的一个 API，用于获取用户的地理位置信息。它返回的经纬度信息可以用于地图展示、位置服务等场景。

2. 参数说明

• type: 指定返回的坐标类型，默认为 wgs84，表示返回全球通用的经纬度坐标。还可以设置为 gcj02，表示返回国测局坐标系，适用于中国地图。

• success: 获取地理位置成功的回调函数。回调函数的参数 res 包含以下属性：

  • latitude: 纬度，浮点数，范围为 -90~90。
  • longitude: 经度，浮点数，范围为 -180~180。
  • speed: 速度，单位为米/秒（m/s）。
  • accuracy: 位置的精确度，单位为米（m）。

• fail: 获取地理位置失败的回调函数。回调函数的参数 err 包含错误信息。

3. 注意事项

• 使用 wx.getLocation 需要在小程序的 app.json 中配置 permission 字段，申请地理位置权限。

  {
    "permission": {
      "scope.userLocation": {
        "desc": "你的位置信息将用于小程序位置接口的效果展示"
      }
    }
  }

• 由于获取地理位置涉及用户隐私，建议在调用 wx.getLocation 前，先通过 wx.authorize 请求用户授权。

  -- -------------------- ---- -------
  --------------
    ------ ---------------------
    --------- -
      -- ---------------
      ----------------
        ----- --------
        ------------ -
          ------------------------ ----
        --
        --------- -
          -------------------------- ----
        -
      --
    --
    ------ -
      ---------------------------
    -
  --

4. 兼容性

wx.getLocation 在微信小程序基础库 1.0.0 及以上版本中支持，建议在使用前检查基础库版本，以确保兼容性。