位置消息
微信客户端 7.0.9 及以上版本支持,iOS 暂不支持
为了让用户更便 捷地使用小程序的打车服务,我们在位置消息详情页的菜单中,新增了打车小程序入口。
- 打开聊天中的位置消息,点击详情页右下角绿色按钮,菜单中会展示符合条件的打车小程序,用户可以直接发起目的地为该位置的打车服务。
- 小程序的注册类目为“打车(网约车)”,且有用户最近使用的记录,才可以出现在该菜单中。
- 在此处点击打开小程序后,需要直接进入到发起打车页面。
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点名称和经纬度信息后可用真机预览调试。