DIV CSS 佈局教程網

Leaflet 開發入門:半小時做出你的第一張交互地圖
編輯:關於JavaScript     

Leaflet 是什麼

Leaflet 是一個現代化、開源的 JavaScript 地圖庫,專為構建交互性好、適配移動設備的在線地圖而設計。核心 JS 僅約 33KB,卻涵蓋了大多數地圖應用所需的能力。

它的設計哲學是簡潔、高性能、易用:在主流桌面與移動平台都能高效運行,現代瀏覽器上會充分利用 HTML5 與 CSS3 的優勢,同時兼顧舊瀏覽器。它支持插件擴展,擁有友好易用的 API 文檔與可讀性極高的源碼。目前社區插件已超過 140 個,覆蓋地圖服務、數據提供、數據格式、地理編碼、路徑規劃與檢索、控件與交互等各個方向。

2016 年 9 月 27 日,Leaflet 1.0 正式發布,更快、更穩定,也更嚴謹。

準備一個空白頁

第一步,在 head 中引入 CSS:

<link rel="stylesheet" href="https://unpkg.com/leaflet@1.0.1/dist/leaflet.css" />

第二步,引入 JS:

<script src="https://unpkg.com/leaflet@1.0.1/dist/leaflet.js"></script>

第三步,放一個帶 id 的容器作為地圖掛載點:

<div id="mapid"></div>

第四步,必須給容器指定高度,否則地圖不可見:

#mapid { height: 180px; }

Leaflet 不會替你設置高度(div 默認高度為 0),這是新手最常踩的坑。

初始化地圖

var mymap = L.map('mapid').setView([39.9788, 116.30226], 14);

這行代碼把地圖中心定位到北京某處,縮放級別設為 14(傳入的 mapid 必須與容器 id 一致)。默認情況下,鼠標與觸摸交互全部開啟,並自帶放大縮小控件與歸屬信息控件。

注意 setView 返回的是地圖對象本身——Leaflet 大多數方法都支持這種鏈式調用,風格類似 jQuery。

接著加一層瓦片。以 Mapbox 街道圖為例:

L.tileLayer('https://api.tiles.mapbox.com/v4/{id}/{z}/{x}/{y}.png?access_token={accessToken}', {
  attribution: 'Map data &copy; <a href="https://openstreetmap.org">OpenStreetMap</a> contributors, <a href="https://creativecommons.org/licenses/by-sa/2.0/">CC-BY-SA</a>, Imagery &copy; <a href="https://mapbox.com">Mapbox</a>',
  maxZoom: 18,
  id: 'your.mapbox.project.id',
  accessToken: 'your.mapbox.public.access.token'
}).addTo(mymap);

創建瓦片層的三要素:瓦片 URL 模板({z}/{x}/{y} 會被自動替換)、歸屬文本、最大縮放級別。至此,一張可用的地圖就完成了。

標記、圓與多邊形

// 標記 + 彈窗
L.marker([39.9788, 116.30226]).addTo(mymap)
  .bindPopup("北京大廈<br>").openPopup();

// 圓:第二個參數是半徑(米),最後一個參數控制外觀
L.circle([39.9908, 116.26625], 500, {
  color: 'red', fillColor: '#f03', fillOpacity: 0.5
}).addTo(mymap).bindPopup("頤和園歡迎你");

// 多邊形
L.polygon([
  [39.92096, 116.38591],
  [39.91079, 116.38676],
  [39.91118, 116.3962],
  [39.92014, 116.39482]
]).addTo(mymap).bindPopup("故宮");

彈窗的兩種用法:bindPopup 綁定後默認點擊才彈出,openPopup 則立即顯示。

marker.bindPopup("北京大廈").openPopup();
circle.bindPopup("頤和園");
polygon.bindPopup("故宮");

如果需要更靈活的控制,可以單獨創建彈窗層:

var popup = L.popup()
  .setLatLng([51.5, -0.09])
  .setContent("I am a standalone popup.")
  .openOn(mymap);

這裡用 openOn 而非 addTo,因為它會自動關閉之前打開的彈窗,避免同時彈出多個。

事件處理

地圖上每次交互——點擊標記、縮放變化——對應對象都會派發事件,訂閱即可:

function onMapClick(e) {
  alert("You clicked the map at " + e.latlng);
}
mymap.on('click', onMapClick);

監聽函數的第一個參數是事件對象,裡面攜帶着有用信息。比如地圖點擊事件的 e.latlng 就是點擊位置的經緯度。改成彈窗展示會更友好:

var popup = L.popup();
function onMapClick(e) {
  popup
    .setLatLng(e.latlng)
    .setContent("You clicked the map at " + e.latlng.toString())
    .openOn(mymap);
}
mymap.on('click', onMapClick);

接下來可以嘗試的事情還有很多:用 L.control.layers 加圖層切換、用 L.divIcon 自定義標記樣式、用 L.geoJSON 加載行政邊界數據,或者引入 Leaflet.markercluster 做海量點聚合。中文場景下還需注意瓦片源選擇與 GCJ-02 坐標偏移問題——高德、騰訊的瓦片使用國測局坐標,直接疊加 GPS 原始坐標會有幾百米偏移,需要引入 coordtransform 之類的庫做轉換。

以上就是這次 Leaflet 入門教程的分享,希望對大家有所幫助。有疑問歡迎留言,我會及時回復。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved