微信小程序开放能力—位置消息打开

微信小程序开放能力—位置消息打开

# 位置消息打开

微信客户端 7.0.9 及以上版本支持,iOS 暂不支持

为了让用户更便 捷地使用小程序的打车服务,我们在位置消息详情页的菜单中,新增了打车小程序入口。

  1. 打开聊天中的位置消息,点击详情页右下角绿色按钮,菜单中会展示符合条件的打车小程序,用户可以直接发起目的地为该位置的打车服务。
  2. 小程序的注册类目为“打车(网约车)”,且有用户最近使用的记录,才可以出现在该菜单中。
  3. 在此处点击打开小程序后,需要直接进入到发起打车页面。

# 1. 位置消息入口声明

开发者需要在全局配置app.json声明支持从位置消息入口进入小程序。

配置示例:

"entranceDeclare": {
    "locationMessage": {
        "path": "pages/index/index",
        "query": "foo=bar"
    }
}

配置项

属性 类型 必填 描述 最低版本
entranceDeclare Object 入口声明信息 7.0.9

entranceDeclare参数列表

属性 类型 必填 描述 最低版本
locationMessage Object 声明“位置消息”场景进入小程序的启动页面 7.0.9

locationMessage参数列表

属性 类型 必填 描述 最低版本
path string 启动页路径,必须是在pages中已经定义 7.0.9
query string 启动页参数 7.0.9

# 2. 从启动参数获取位置信息

示例代码:

//app.js
App({
  onLaunch: function (options){
    console.log(options)
    var scene = options.scene 
    if (scene == 1146) { // 位置消息场景值
      var location = options.locationInfo
      var x = location.latitude
      var y = location.longitude
      var name = location.name
    }
  },
})

Object 启动参数

属性 类型 描述
scene number 启动小程序的场景值,“位置消息”的启动场景值为1146
locationInfo Object 特殊场景的启动信息

locationInfo 的结构

属性 类型 描述
latitude number 纬度,范围为 -90~90,负数表示南纬
longtitude number 经度,范围为 -180~180,负数表示西经
name string POI名称

# 3. 工具调试

Nightly v1.02.1912062 版本已支持条件编译增加位置消息入口。选择场景值 1146: 位置消息中用小程序打车,传入POI点名称和经纬度信息后可用真机预览调试。