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

如下内容转载自微信开放社区腾讯位置服务官方文章《3分钟教你学会使用路线规划小程序插件》

做者：腾讯位置服务

连接： developers.weixin.qq.com/community/d…

来源：微信开放社区

著做权归做者全部。商业转载请联系做者得到受权，非商业转载请注明出处。

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

路线规划插件的功能

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

同时驾车路线在地图中会经过不一样路线的颜色直观反映道路的拥堵状况，例如红色路线表示那段道路拥堵，这就可以让用户提早规避拥堵路段。

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

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

路线规划插件的应用场景

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

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

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

路线规划插件的使用方法

一、申请路线规划插件

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

二、申请key

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

2.1 填写申请信息

2.2 建立key成功

2.3 受权小程序appid

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

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

微信小程序插件须要使用WebService API的部分服务，因此使用该功能的key须要具有相应的权限。

若是开发者以前是腾讯位置服务的用户并申请过key，则能够跳过上面2.一、2.2的步骤，直接进行2.三、2.4步骤的设置。

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

只须要在小程序的app.json文件作以下配置就能够在小程序中引入路线规划插件：

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

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

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

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个参数含义以下：

• key，开发者的惟一标识，第2步申请的key

• referer，调用插件的小程序的名称

• startPoint，起点名称和坐标信息，若是不传起点参数，则起点默认当前用户的真实位置

• endPoint，终点名称和坐标信息

怎么样？看了上面的使用方法是否是以为很简单呢？腾讯位置服务开发路线规划插件的目的就是为了减小开发者开发成本，解放开发者生产力，因此才把这些复杂的路线规划业务封装成了插件，方便小程序开发者使用。

那么还犹豫什么呢？当即点击这里去体验使用吧！

另外，腾讯位置服务还推出了地铁图小程序插件，为用户提供查看各城市地铁线路的功能，还能帮用户检索到最优势地铁出行线路及每一个站队的详情信息。

后续，腾讯位置服务还会开发更多的关于地图相关的小程序插件，还请各位开发者持续关注咱们的服务商主页！