之前的文章已經成功在 Vue 專案中引入高德地圖,這次因為需求,要再加上「周邊」的功能。完整專案程式碼可以在我的 GitHub 上找到。
整體參考鏈家的周邊頁設計,如下圖。

1、引入高德 API,這部分在先前文章已說明過。
2、使用周邊查詢外掛。高德提供了 PlaceSearch 服務:
AMap.PlaceSearch // 地點搜索服務插件,提供某一特定地區的位置查詢服務
其中我們採用 searchNearBy 方法:
searchNearBy(keyword: String,
center: LngLat,
radius: Number,
callback: function(status: String, result: info/SearchResult))
// 根據中心點經緯度、半徑以及關鍵字進行周邊查詢
// radius 取值範圍:0 - 50000
3、建立查詢方法。一次把幾種類別的 marker 全部抓回來,後續切換就不必重新載入地圖與外掛:
searchData: function (callback) {
let keyWords = ['地鐵線路', '大型購物廣場', '三甲醫院', '學校']; // 自選關鍵詞
let distance = [1000, 3000, 3000, 3000]; // 各分類對應的半徑
let placeSearchOptions = {
// 構造地點查詢類
pageSize: 10,
pageIndex: 1,
city: '021',
map: map,
visible: false
};
AMap.service('AMap.PlaceSearch', function () {
map.clearMap(); // 清除地圖覆蓋物
placeSearch = new AMap.PlaceSearch(placeSearchOptions);
for (let i = 0; i < keyWords.length; i++) {
placeSearch.searchNearBy(
keyWords[i],
[121.44343879031237, 31.207570983863118],
distance[i],
callback
);
}
});
return callback;
},
這裡刻意把 visible 設為 false,讓外掛只負責取資料、不自行畫 marker,畫面才不會出現兩套點位。若你發現有更好的做法,也歡迎指教。
4、把切換事件綁在 footer 的分類按鈕上。預設顯示第 0 組(交通),實際上所有資料在初始化時就已經抓好了,點擊按鈕只是切換要畫哪一組 marker:
/* 注册每项的点击事件,默认显示 num0(交通),
实际上所有的数据已经请求到了,点击按钮只是用来切换 marker */
clickItem: function (index, buttons) {
map.clearMap(); // 清除地圖覆蓋物
buttons.forEach(function (e, index) {
e.isActive = false;
});
buttons[index].isActive = true;
self.listCount = self.num[index].length;
self.listText = self.num[index];
function onClick(e) {
console.log(e);
}
for (let i = 0; i < self.num[index].length; i++) {
marker = new AMap.Marker({
icon: 'https://webapi.amap.com/theme/v1.3/markers/n/mark_b' + (i + 1) + '.png',
position: [self.num[index][i].location.lng, self.num[index][i].location.lat],
offset: new AMap.Pixel(-24, 5),
zIndex: 1,
map: map,
clickable: true
});
AMap.event.addListener(marker, 'click', onClick);
}
return marker;
}

為方便展示效果,專案中使用了個人開發者的高德密鑰,請自行替換成自己申請的 key,否則會遇到配額或權限上的問題。
另外,中心點座標目前寫死在程式碼裡。實務上應該由使用者的定位或搜尋結果帶入,並把城市行政區編碼(city)一併換成對應值,否則跨城市查詢會取不到資料。若需要更完整的結果,別忘了串接 pageIndex 做分頁,單次 searchNearBy 只會回傳 pageSize 指定的筆數。
完整的專案程式碼請見我的 GitHub。