3分钟教你学会使用路线规划小程序插件

以下内容转载自微信开放社区腾讯位置服务官方文章《3分钟教你学会使用路线规划小程序插件》
作者：腾讯位置服务
链接： https://developers.weixin.qq....
来源：微信开放社区
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

路线规划小程序插件是腾讯位置服务开发的一款为用户规划驾车、公交、步行路线方案的插件。开发者可以直接在小程序内使用这个插件，从而为自己的用户提供多种出行方案选择。

路线规划插件的功能

路线规划插件能为用户规划驾车出行路线（如下图1所示），并且当行车起点和行车终点之间可以规划出多个方案时会展示多个方案及方案耗时。这些不同方案体现了不同的策略，例如根据实时路况时间最短、红绿灯数较少、少收费等策略。

同时驾车路线在地图中会通过不同路线的颜色直观反映道路的拥堵情况，例如红色路线表示那段道路拥堵，这就能够让用户提前规避拥堵路段。

路线规划插件也能为用户规划步行出行路线（如下图2所示），不仅显示了步行路线距离和耗时信息，还显示了用户步行过程中，走过的天桥、人行横道数量，更人性化的显示了步行消耗了多少卡路里。

3分钟教你学会使用路线规划小程序插件

路线规划插件还能为用户规划公交出行路线（如下图所示），提供多种公交和地铁出行方案，并且用户可以根据自己的实际情况进行方案排序，例如时间短优先排序、少步行优先排序、少换乘优先排序。出行方案上也会有时间短这样的标志信息说明方案特点。

3分钟教你学会使用路线规划小程序插件

路线规划插件的应用场景

路线规划插件应用场景非常丰富，可以直接接入到餐饮、电影等各种类型的小程序中，让消费者在小程序中就能获得到达门店的路线规划方案，方便去门店消费。

设想一个场景，小王周末想要吃一顿大餐，于是打开了某家餐厅小程序，当小王决定去这家餐厅时，不需要再打开地图软件去规划出行路线，通过我们的路线规划插件，在这家餐厅的小程序中就能直接规划小王目前的位置到餐厅的出行路线。小王可以选择开车去餐厅，如果今天车牌号限行，那么小王也可以选择公共交通出行，如果到餐厅的距离很近，那么小王可以选择步行方式到达餐厅。

小程序只需要使用路线规划插件就能拥有这些全面精准规划路线能力。看了这些功能，是不是想马上体验呢？别急！接下来就介绍路线规划插件的使用方法。

路线规划插件的使用方法

1、申请路线规划插件

在微信公众平台中， “微信小程序官方后台-设置-第三方设置-插件管理” 里点击 “添加插件”（如下图所示），搜索 “腾讯位置服务路线规划” ，选择添加插件，小程序开发者就可以在小程序内使用该插件了。

3分钟教你学会使用路线规划小程序插件

2、申请key

调用路线规划插件需要申请腾讯位置服务的服务账号，key是开发者的唯一标识，申请key请点击这里。申请key的具体步骤如下：

2.1 填写申请信息

3分钟教你学会使用路线规划小程序插件

2.2 创建key成功

3分钟教你学会使用路线规划小程序插件

2.3 授权小程序appid

开通微信小程序服务：控制台 -> key管理 -> 设置（使用该功能的key）-> 勾选“微信小程序” -> 填写“授权 APP ID” ->保存。

3分钟教你学会使用路线规划小程序插件

2.4 勾选“WebService API”及“白名单”

微信小程序插件需要使用WebService API的部分服务，所以使用该功能的key需要具备相应的权限。

3分钟教你学会使用路线规划小程序插件

如果开发者之前是腾讯位置服务的用户并申请过key，则可以跳过上面2.1、2.2的步骤，直接进行2.3、2.4步骤的设置。

3、在小程序中引入路线规划插件

只需要在小程序的app.json文件做如下配置就可以在小程序中引入路线规划插件：

// app.json
{
  "plugins": {
    "routePlan": {
      "version": "1.0.0",
      "provider": "wx50b5593e81dd937a"
    }
  },
  "permission": {
    "scope.userLocation": {
      "desc": "你的位置信息将用于小程序定位"
    }
  }
}

4、在小程序中调用路线规划插件

在小程序中调用路线规划插件也非常简单：

let plugin = requirePlugin('routePlan');
let key = '';  //使用在腾讯位置服务申请的key
let referer = '';   //调用插件的小程序的名称
let startPoint = JSON.stringify({  //起点
  'name': '中国技术交易大厦',
  'latitude': 39.984154,
  'longitude': 116.30749
});
let endPoint = JSON.stringify({  //终点
  'name': '北京西站',
  'latitude': 39.894806,
  'longitude': 116.321592
});
wx.navigateTo({
  url: 'plugin://routePlan/route-plan?key=' + key + '&referer=' + referer + '&endPoint=' + endPoint
});

如以上示例代码所示，只需要传4个参数，就能为小程序用户提供驾车、公交、步行路线规划信息了。这4个参数含义如下：