腾讯位置服务路线规划插件

版本号：v2.2.0

插件介绍

腾讯位置服务路线规划插件提供驾车、公交、步行、骑行路线规划功能。开发者可以将路线规划插件嵌入到自建小程序里，提供给用户路线规划信息。

接入指引

1、插件申请接入：

在腾讯公众平台中， “微信小程序官方后台-设置-第三方服务-插件管理” 里点击 “添加插件”，搜索 “腾讯位置服务路线规划” 申请，审核通过后，小程序开发者可在小程序内使用该插件。

2、引入插件包：

路线规划 appId： wx50b5593e81dd937a

// app.json
{
  "plugins": {
    "route-plan": {
      "version": "2.2.0",
      "provider": "wx50b5593e81dd937a"
    }
  }
}

3、设置定位授权：

路线规划插件需要小程序提供定位授权才能够正常使用定位功能：

// app.json
{
  "permission": {
    "scope.userLocation": {
      "desc": "你的位置信息将用于小程序定位"
    }
  }
}

4、使用插件：

插件页面调用示例：

// 使用在腾讯位置服务申请的key
const key = '';
// 调用插件的app的名称
const referer = '';
// 用户openId
const openId = 'w0svdvqwrggda';
// 是否启用智能规划
const enableAI = true;
// 是否开启导航功能
const navigation = 1;
// 终点
const endPoint = JSON.stringify({
  name: '北京西站',
  latitude: 39.894806,
  longitude: 116.321592,
});
// 个性化图层
const layerStyle = 1;

wx.navigateTo({
  url: `plugin://route-plan/index?key=${key}&referer=${referer}&openId=${openId}&endPoint=${endPoint}&enableAI=${enableAI}&navigation=${navigation}&layerStyle=${layerStyle}`,
});

相关参数说明

插件页面参数

属性	类型	说明	是否必须传入
key	string	调用路线规划插件需要申请腾讯位置服务的服务账号，key 是开发者的唯一标识。申请 key	是
referer	string	调用来源，一般为您的应用名称，请务必填写！	是
openId	string	用户唯一标识，用于标识用户	否
endPoint	Point	终点	否
startPoint	Point	起点, 如果不传起点参数，则起点默认当前用户的真实定位	否
mode	string	默认出行规划方式，目前支持多种方式：driving（驾车）、transit（公交）、walking（步行）、riding（骑行 2.0.0 版本开始支持），不传则默认发起驾车规划	否
navigation	number	值为 1 时，开启驾车导航功能；默认不开启此功能	否
themeColor	string	插件主题色，16 进制色值，默认是#07c160（2.0.0 版本后不支持）	否
enableAI	boolean	驾车规划是否支持智能规划（2.0.0 版本开始支持）	否
layerStyle	number	地图能力【个性化地图】配置的 style, 默认值: 1	否

Point 类型说明

属性	类型	说明	是否必须传入
name	string	位置名称	是
latitude	number	纬度	是
longitude	number	经度	是

腾讯位置服务调用说明

插件内部使用到了如下腾讯位置服务，需在 LBS 控制台中对小程序的 key 配置相关服务的配额，保证插件的稳定使用。点击直通 Key 额度配置页

服务名	说明	官方文档
城市/区域搜索	根据所在区域 region 和关键字获取区域内的相关 poi 信息	文档链接
关键词输入提示	根据用户输入的关键词联想附近的 poi 数据	文档链接
逆地址解析（坐标位置描述）	根据用户的经纬度信息获取到当前的城市信息	文档链接
驾车（driving）路线规划	根据传入的起点和终点计算可行的驾车路，支持一次返回多条方案以供用户选择线	文档链接
步行（walking）路线规划	根据传入的起点和终点计算可行的步行路，支持一次返回多条方案以供用户选择线	文档链接
公交（transit）路线规划	基于公共汽车、地铁、火车等公共交通工具，计算起到终点的路线换乘方案，同时提供少换乘、少步行等偏好设置，支持一次返回多条方案以供用户选择	文档链接

效果图