3分鍾教你學會使用路線規划小程序插件

騰訊位置服務基於微信提供的小程序插件能力，專注於（圍繞）地圖功能，打造一系列小程序插件，可以幫助開發者簡單、快速的構建小程序，是您實現地圖功能的最佳伙伴。目前微信小程序插件提供路線規划、地鐵圖、地圖選點等服務，歡迎大家體驗！
我們將陸續推出更多功能的插件，敬請期待！

以下內容轉載自微信開放社區騰訊位置服務官方文章《3分鍾教你學會使用路線規划小程序插件》
作者：騰訊位置服務
鏈接: https://developers.weixin.qq.com/community/develop/article/doc/0006a6b6864fd06e52f8174e651013
來源：微信開放社區
著作權歸作者所有。商業轉載請聯系作者獲得授權，非商業轉載請注明出處。

 

路線規划小程序插件是騰訊位置服務開發的一款為用戶規划駕車、公交、步行路線方案的插件。開發者可以直接在小程序內使用這個插件，從而為自己的用戶提供多種出行方案選擇。

路線規划插件的功能

路線規划插件能為用戶規划駕車出行路線（如下圖1所示），並且當行車起點和行車終點之間可以規划出多個方案時會展示多個方案及方案耗時。這些不同方案體現了不同的策略，例如根據實時路況時間最短、紅綠燈數較少、少收費等策略。

同時駕車路線在地圖中會通過不同路線的顏色直觀反映道路的擁堵情況，例如紅色路線表示那段道路擁堵，這就能夠讓用戶提前規避擁堵路段。

路線規划插件也能為用戶規划步行出行路線（如下圖2所示），不僅顯示了步行路線距離和耗時信息，還顯示了用戶步行過程中，走過的天橋、人行橫道數量，更人性化的顯示了步行消耗了多少卡路里。

 

 

 

 

路線規划插件還能為用戶規划公交出行路線（如下圖所示），提供多種公交和地鐵出行方案，並且用戶可以根據自己的實際情況進行方案排序，例如時間短優先排序、少步行優先排序、少換乘優先排序。出行方案上也會有時間短這樣的標志信息說明方案特點。

 

 

路線規划插件的應用場景

路線規划插件應用場景非常豐富，可以直接接入到餐飲、電影等各種類型的小程序中，讓消費者在小程序中就能獲得到達門店的路線規划方案，方便去門店消費。

設想一個場景，小王周末想要吃一頓大餐，於是打開了某家餐廳小程序，當小王決定去這家餐廳時，不需要再打開地圖軟件去規划出行路線，通過我們的路線規划插件，在這家餐廳的小程序中就能直接規划小王目前的位置到餐廳的出行路線。小王可以選擇開車去餐廳，如果今天車牌號限行，那么小王也可以選擇公共交通出行，如果到餐廳的距離很近，那么小王可以選擇步行方式到達餐廳。

小程序只需要使用路線規划插件就能擁有這些全面精准規划路線能力。看了這些功能，是不是想馬上體驗呢？別急！接下來就介紹路線規划插件的使用方法。

路線規划插件的使用方法

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.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個參數含義如下：

• key，開發者的唯一標識，第2步申請的key

• referer，調用插件的小程序的名稱

• startPoint，起點名稱和坐標信息，如果不傳起點參數，則起點默認當前用戶的真實位置

• endPoint，終點名稱和坐標信息

怎么樣？看了上面的使用方法是不是覺得很簡單呢？騰訊位置服務開發路線規划插件的目的就是為了減少開發者開發成本，解放開發者生產力，所以才把這些復雜的路線規划業務封裝成了插件，方便小程序開發者使用。

那么還猶豫什么呢？立即點擊這里去體驗使用吧！

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

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