本文以圖吧(Mapbar)地圖 API 為例,示範如何在網頁中嵌入地圖、讓使用者點擊放標記、拖动標記調整位置,最後把座標讀出來存回後端。整體流程包含初始化地圖、註冊事件、加入覆蓋物、以及資料提取四個部分。
Mapbar 地圖 API 讓你可以用 JavaScript 把地圖嵌入自己的網頁,並提供一系列與地圖互動的方法,也能在地圖上加入自訂內容,做出穩定的地圖應用。
線上說明文件:https://union.mapbar.com/apidoc/
離線 CHM 下載:https://union.mapbar.com/apidoc/chm/mapbarapi.rar
官方提供一組公共測試密鑰,省略申請流程即可在 https://localhost 環境下測試。
效果如下:

另外要注意相容性:Internet Explorer 8 存在已知問題,需在 <head> 之間加入 <meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7" />,否則折線等功能無法正確執行。
var maplet = null; // 地圖物件
var marker = null; // 標記物件
var le = null; // 縮放層級
var myEventListener = null;
function initMap() {
le = 10;
maplet = new Maplet("mapbar");
// 若座標來自資料庫,可在此直接輸出:
// maplet.centerAndZoom(new MPoint(<%=lat%>, <%=lon%>), <%=zoom%>);
maplet.centerAndZoom(new MPoint(116.38672, 39.90805), le);
maplet.addControl(new MStandardControl());
}
function setp() {
if (marker) { alert("已經添加過標記了"); return; }
maplet.setMode("bookmark"); // 切換成放標記模式
maplet.setCursorIcon("tb1.gif"); // 自訂游標圖示
myEventListener = MEvent.bind(maplet, "click", this, addp);
}
要提醒的是,事件回呼的參數務必寫完整,即使你沒有用到 event 物件也一樣:
function addp(event, point) {
if (!marker) {
marker = new MMarker(
point,
new MIcon("mark.gif", 24, 24),
new MInfoWindow("資訊視窗標題", "副標內容"),
new MLabel("小標籤")
);
marker.bEditable = true;
marker.dragAnimation = true;
maplet.addOverlay(marker);
marker.setEditable(true);
maplet.setMode("pan"); // 恢復成拖曳模式
le = maplet.getZoomLevel();
document.getElementById("findp").style.display = "block";
document.getElementById("delp").style.display = "block";
document.getElementById("savep").style.display = "block";
MEvent.removeListener(myEventListener); // 用完就註銷,避免重複觸發
}
}
function find() { maplet.centerAndZoom(marker.pt, le); }
function del() {
maplet.clearOverlays(true);
location.reload(); // 直接重設頁面,最省事
}
function savep() {
alert("目前座標點\n經度:" + marker.pt.lon
+ "\n維度:" + marker.pt.lat
+ "\n縮放級別:" + le);
}
<table width="501"> <tr> <td><input type="button" value="添加標注" onclick="setp()"/></td> <td><input type="button" id="findp" value="查看標記" style="display:none" onclick="find()"/></td> <td><input type="button" id="delp" value="刪除標記" style="display:none" onclick="del()"/></td> <td><input type="button" id="savep" value="保存" style="display:none" onclick="savep()"/></td> </tr> <tr><td colspan="4"> <div id="mapbar" style="width:500px;height:300px"></div> </td></tr> </table>
以上只是前端部分。真正要落地,你需要在自己的專案裡用 Ajax 把 savep() 取到的經緯度與縮放層級送回伺服器,下次進入時再从資料庫讀出來呼叫 centerAndZoom,座標才算真正保存下來。
原始碼下載:https://xiazai.jb51.net/201004/yuanma/mapbar.rar
地圖應用的骨架其實都類似:初始化 → 綁事件 → 加覆蓋物 → 取資料 → 存後端。換成其他地圖服務時,只要把對應的 API 名稱替換掉,整體結構幾乎可以照搬。