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，終點名稱和座標信息

怎麼樣？看了上面的使用方法是否是以爲很簡單呢？騰訊位置服務開發路線規劃插件的目的就是爲了減小開發者開發成本，解放開發者生產力，因此才把這些複雜的路線規劃業務封裝成了插件，方便小程序開發者使用。

那麼還猶豫什麼呢？當即點擊這裏去體驗使用吧！

另外，騰訊位置服務還推出了地鐵圖小程序插件，爲用戶提供查看各城市地鐵線路的功能，還能幫用戶檢索到最優勢地鐵出行線路及每一個站隊的詳情信息。

後續，騰訊位置服務還會開發更多的關於地圖相關的小程序插件，還請各位開發者持續關注咱們的服務商主頁！