微信小程序 消息·位置消息
位置消息
微信客户端 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点名称和经纬度信息后可用真机预览调试。