標(biāo)注
標(biāo)注表示地圖上的點(diǎn)。API提供了默認(rèn)圖標(biāo)樣式，您也可以通過(guò)Icon類(lèi)來(lái)指定自定義圖標(biāo)。Marker的構(gòu)造函數(shù)的參數(shù)為Point和MarkerOptions（可選）。注意：當(dāng)您使用自定義圖標(biāo)時(shí)，標(biāo)注的地理坐標(biāo)點(diǎn)將位于標(biāo)注所用圖標(biāo)的中心位置，您可通過(guò)Icon的offset屬性修改標(biāo)定位置。
下面的示例向地圖中心點(diǎn)添加了一個(gè)標(biāo)注，并使用默認(rèn)的標(biāo)注樣式。
var map = new BMap.Map("container");
var point = new BMap.Point(116.404, 39.915);
map.centerAndZoom(point, 15);
var marker = new BMap.Marker(point); // 創(chuàng)建標(biāo)注
map.addOverlay(marker); // 將標(biāo)注添加到地圖中
定義標(biāo)注圖標(biāo)
通過(guò)Icon類(lèi)可實(shí)現(xiàn)自定義標(biāo)注的圖標(biāo)，下面示例通過(guò)參數(shù)MarkerOptions的icon屬性進(jìn)行設(shè)置，您也可以使用marker.setIcon()方法。
var map = new BMap.Map("container");
var point = new BMap.Point(116.404, 39.915);
map.centerAndZoom(point, 15); // 編寫(xiě)自定義函數(shù)，創(chuàng)建標(biāo)注
function addMarker(point, index){ // 創(chuàng)建圖標(biāo)對(duì)象
var myIcon = new BMap.Icon("markers.png", new BMap.Size(23, 25), {
// 指定定位位置。
// 當(dāng)標(biāo)注顯示在地圖上時(shí)，其所指向的地理位置距離圖標(biāo)左上
// 角各偏移10像素和25像素。您可以看到在本例中該位置即是
// 圖標(biāo)中央下端的尖角位置。
offset: new BMap.Size(10, 25),
// 設(shè)置圖片偏移。
// 當(dāng)您需要從一幅較大的圖片中截取某部分作為標(biāo)注圖標(biāo)時(shí)，您
// 需要指定大圖的偏移位置，此做法與css sprites技術(shù)類(lèi)似。
imageOffset: new BMap.Size(0, 0 - index * 25) // 設(shè)置圖片偏移
});
// 創(chuàng)建標(biāo)注對(duì)象并添加到地圖
var marker = new BMap.Marker(point, {icon: myIcon});
map.addOverlay(marker);
}
// 隨機(jī)向地圖添加10個(gè)標(biāo)注
var bounds = map.getBounds();
var lngSpan = bounds.maxX - bounds.minX;
var latSpan = bounds.maxY - bounds.minY;
for (var i = 0; i < 10; i ++) {
var point = new BMap.Point(bounds.minX + lngSpan * (Math.random() * 0.7 + 0.15),
bounds.minY + latSpan * (Math.random() * 0.7 + 0.15));
addMarker(point, i);
}
監(jiān)聽(tīng)標(biāo)注事件
事件方法與Map事件機(jī)制相同。可參考事件部分。
marker.addEventListener("click", function(){
alert("您點(diǎn)擊了標(biāo)注");
});
可托拽的標(biāo)注
marker的enableDragging和disableDragging方法可用來(lái)開(kāi)啟和關(guān)閉標(biāo)注的拖拽功能。默認(rèn)情況下標(biāo)注不支持拖拽，您需要調(diào)用marker.enableDragging()方法來(lái)開(kāi)啟拖拽功能。在標(biāo)注開(kāi)啟拖拽功能后，您可以監(jiān)聽(tīng)標(biāo)注的dragend事件來(lái)捕獲拖拽后標(biāo)注的最新位置。
marker.enableDragging();
marker.addEventListener("dragend", function(e){
alert("當(dāng)前位置：" + e.point.lng + ", " + e.point.lat);
})
標(biāo)注彈跳動(dòng)畫(huà)
<script type="text/javascript">
// 百度地圖API功能
var map = new BMap.Map("allmap");
var point = new BMap.Point(116.404, 39.915);
map.centerAndZoom(point, 15);
var marker = new BMap.Marker(point); // 創(chuàng)建標(biāo)注
map.addOverlay(marker); // 將標(biāo)注添加到地圖中
marker.setAnimation(BMAP_ANIMATION_BOUNCE); //跳動(dòng)的動(dòng)畫(huà)
</script>
設(shè)置標(biāo)注是否可以拖拽
<script type="text/javascript">
// 百度地圖API功能
var map = new BMap.Map("allmap");
var point = new BMap.Point(116.404, 39.915);
map.centerAndZoom(point, 15);
var marker = new BMap.Marker(point); // 創(chuàng)建標(biāo)注
map.addOverlay(marker); // 將標(biāo)注添加到地圖中
marker.disableDragging(); // 默認(rèn)不可拖拽
// marker.enableDragging(); // 設(shè)置可拖拽
</script>
內(nèi)存釋放
在API 1.0版本中，如果您需要在地圖中反復(fù)添加大量的標(biāo)注，這可能會(huì)占用較多的內(nèi)存資源。如果您的標(biāo)注在移除后不再使用，可調(diào)用Overlay.dispose()方法來(lái)釋放內(nèi)存。注意在1.0版本中，調(diào)用此方法后標(biāo)注將不能再次添加到地圖上。自1.1版本開(kāi)始，您不在需要使用此方法來(lái)釋放內(nèi)存資源，API會(huì)自動(dòng)幫助您完成此工作。
例如，您可以在標(biāo)注被移除后調(diào)用此方法：
map.removeOverlay(marker);
marker.dispose(); // 1.1 版本不需要這樣調(diào)用