「騰訊地圖」小程式外掛

微信極客WeGeek發表於2018-11-13

地圖

上期，我們在《「騰訊視訊」小程式外掛》一文中介紹了「騰訊視訊」小程式外掛的意義、使用場景以及使用方法。

今天我們會與大家分享一款同樣優秀的小程式外掛——「騰訊地圖」外掛，從使用場景到使用方法，都將作出詳細的介紹。

「騰訊地圖」外掛能做什麼？

顧名思義，「騰訊地圖」外掛由騰訊地圖官方出品，旨在為開發者提供簡單的路線多方案規劃服務，可在外掛中顯示指定位置間的路線方案，支援駕車、公交、步行的路線規劃能力及 ETA 等基礎路線資訊。

如果你想像「騰訊地圖+」小程式一樣實現地圖的基礎功能，使用「騰訊地圖」外掛是你的最佳選擇。

作為首批推出的小程式外掛，「騰訊地圖」外掛經過了多個版本的優化，從最初的顯示目標位置資訊以及提供附近地圖功能，到現在已經支援路線規劃等能力，地圖的功能幾乎已經全部配備齊全。

「騰訊地圖」外掛的使用場景

場景一：收到小程式的婚禮請柬，但是請柬上的地址找不到？怎麼辦？

如果你開發的是請柬邀請類的小程式，就會遇到上述場景。在傳統開發模式中，引入完整的地圖選點、路線規劃元件，開發成本非常高，更多開發者選擇讓使用者直接輸入文字地址進行展示，以此作為降低開發成本的妥協方案。這樣的設計不可點選，更沒有路線規劃的能力，使用者還需手動輸入去查詢地址和交通路線。

但如果開發者選擇使用騰訊地圖提供的同名小程式外掛，開發成本將大幅降低，使用者體驗也能直線上升。我們在這裡以婚慶請柬小程式為例進行說明：

使用者在編輯請柬小程式的過程中，提前設定好婚禮舉辦地點；

當婚禮賓客收到請柬，點選地點，「騰訊地圖」外掛就能根據其賓客當前位置和目的地座標，自動生成精準的導航路線。

場景二：會議服務小幫手——提前瞭解參會路線

與會者應該如何從高鐵站、機場、火車站前往會議地點，一直都是各類會議邀請的必備內容。但長期以來，此類資訊都習慣以純文字形式進行釋出，體驗上存在不便理解、記憶難的問題。

如果小程式能夠使用「騰訊地圖」外掛，這類場景的體驗將發生質的改變：會議組織方在小程式中提前設定多組起終點（如：機場 - 會議中心、高鐵站 - 會議中心），與會者收到會議邀請後點選指定線路，就能在地圖外掛中檢視到精確的參會路線。

這樣是不是比枯燥的文字多了幾分智慧呢？

如何接入「騰訊地圖」外掛？

「騰訊地圖」的功能強大，使用起來卻十分簡單：

**1.申請使用外掛。**在「小程式管理後臺 - 設定 - 第三方服務 - 外掛管理」中查詢外掛名稱「騰訊地圖」（目前最新版本：1.0.6，appid：wx5bc2ac602a747594），並申請使用。

2.引入外掛程式碼後修改配置檔案 JSON：

{
  "usingComponents": {
    "map-route": "plugin://myPlugin/mapRoute"
  }}
複製程式碼

3.使用地圖外掛。在相應的 WXML 檔案中新增以下標籤：

<map-route route-info="{{routeInfo}}"></map-route>
複製程式碼

4.最後，按需求在 JS 檔案中處理傳入外掛資料，資料包括：起點，終點經緯度及名稱，路線算路方式，封裝在 routeInfo 結構中：

let plugin = requirePlugin("myPlugin")let routeInfo = {
    startLat: 39.90469,    // 起點緯度 選填
    startLng: 116.40717,    // 起點經度 選填
    startName: "我的位置",   // 起點名稱 選填
    endLat: 39.94055,    // 終點緯度必傳
    endLng :116.43207,  // 終點經度 必傳
    endName:"來福士購物中心",  // 終點名稱 必傳
    mode:"car"  //算路方式 選填}

Page({
  data: {
    routeInfo: routeInfo
  }
})
複製程式碼

引數說明：

起點：不填寫或 startName="我的位置" 或 startName="當前位置" 或 startName="currentLocation" 則外掛會獲取當前的定位位置作為起點位置發起算路，若正確填寫起點資訊，則以傳入的起點資訊發起算路。

終點：必傳引數，不正確傳入則不會發起算路或者算路失敗。

算路方式：

mode，目前支援三種算路方式，分別是：駕車（car），公交（bus），步行（walk）；不傳則預設發起駕車算路。

注意：資料要在 data 中初始化，不要在 onLoad 中直接 setData，因為 onLoad 中直接 setData，properties 的 routeInfo 的 observer: function (newVal, oldVal)，newVal 接收不到引數，導致引數報錯，之後可以通過 bind 其他事件 setData 更新 routeInfo 達到變更起終點引數的效果。

「騰訊地圖」外掛使用效果圖