本文整理搜狗地圖 API 的常用用法,從地圖初始化、視角控制到描點與測距,可作為開發參考。
先引入 API 檔案:
<script src="https://xiazai.cnblogs.com/201409/other/api_v2.5.1.js" type="text/javascript"></script>
接著在 window.onload 中建立地圖物件,並準備一個 id 為 map_canvas 的 div 作為容器:
window.onload = function () {
var map = new sogou.maps.Map(document.getElementById("map_canvas"), {});
};
完整頁面:
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
<title></title>
<style type="text/css">
html { height: auto; }
body { height: auto; margin: 0; padding: 0; }
#map_canvas { width: 1000px; height: 500px; position: absolute; }
@media print { #map_canvas { height: 950px; } }
</style>
<script src="https://xiazai.cnblogs.com/201409/other/api_v2.5.1.js" type="text/javascript"></script>
<script>
window.onload = function () {
var map = new sogou.maps.Map(document.getElementById("map_canvas"), {});
};
</script>
</head>
<body>
<form id="form1" runat="server">
<div id="map_canvas"></div>
</form>
</body>
</html>
window.onload = function () {
var myOptions = {
zoom: 10,
center: new sogou.maps.Point(12956000, 4824875) // 此座標為北京
};
var map = new sogou.maps.Map(document.getElementById("map_canvas"), myOptions);
};
var map; // 建立全域變數
window.onload = function () {
var myOptions = {
zoom: 10,
center: new sogou.maps.Point(12956000, 4824875)
};
map = new sogou.maps.Map(document.getElementById("map_canvas"), myOptions);
};
// 切換地圖類型
function setMapTypeId(num) {
// sogou.maps.MapTypeId.ROADMAP 普通地圖
// sogou.maps.MapTypeId.SATELLITE 衛星地圖
// sogou.maps.MapTypeId.HYBRID 衛星與路網混合
switch (num) {
case 1: map.setMapTypeId(sogou.maps.MapTypeId.ROADMAP); break;
case 2: map.setMapTypeId(sogou.maps.MapTypeId.SATELLITE); break;
case 3: map.setMapTypeId(sogou.maps.MapTypeId.HYBRID); break;
}
}
// 手動平移地圖
function panBy(a, b) {
map.panBy(a, b);
}
// 一次設定中心、層級與類型
function setOptions() {
map.setOptions({
center: new sogou.maps.Point(13522000, 3641093),
zoom: 12,
mapTypeId: sogou.maps.MapTypeId.ROADMAP
});
}
// 設定中心與層級
function setCenter(a, b, c) {
map.setCenter(new sogou.maps.Point(a, b), c);
}
// 縮放到能完整顯示指定範圍
function fitBounds() {
var bounds = new sogou.maps.Bounds(12955101, 4824738, 12958355, 4827449);
// 注意:不是把 bounds 設成這個值,而是讓視角調整到合適位置
map.fitBounds(bounds);
}
對應的按鈕只要用 onclick 呼叫這些函數即可,例如 onclick="setMapTypeId(1)"、onclick="panBy(200,0)"。
搜狗 API 提供兩種描點方式。靜態描點在初始化時一併建立:
var location = new sogou.maps.Point(12956000, 4824875);
var map = new sogou.maps.Map(document.getElementById("map_canvas"), {});
var marker = new sogou.maps.Marker({
position: location, // 描點座標
title: "描點", // 描點名稱
label: { visible: true, align: "BOTTOM" }, // 顯示形式
map: map
});
動態描點則是監聽地圖點擊事件,在點擊處落點:
window.onload = function () {
map = new sogou.maps.Map(document.getElementById("map_canvas"), {});
sogou.maps.event.addListener(map, 'click', function (event) {
var marker1 = new sogou.maps.Marker({
position: event.point,
map: map
});
});
};
// 取得類別的唯一執行個體
function getInstance(a) {
a.hasOwnProperty("_instance") || (a._instance = new a);
return a._instance;
}
// 兩點連線並標註距離
function Lines(myLatlng, myPoint) {
var convertor = getInstance(sogou.maps.Convertor);
var distance = convertor.distance(myLatlng, myPoint);
var line = new sogou.maps.Polyline({
path: [myLatlng, myPoint],
strokeColor: "#FF0000",
strokeOpacity: 1.0,
strokeWeight: 1,
title: parseInt(distance) + "米",
map: map
});
}
把它包成一個可互動的小模組,就得到能連續點擊量測的功能:
<html xmlns="https://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title></title>
<style type="text/css">
html { height: auto; }
body { height: auto; margin: 0; padding: 0; }
#map_canvas { width: 1000px; height: 500px; position: absolute; }
@media print { #map_canvas { height: 950px; } }
</style>
<script src="https://xiazai.cnblogs.com/201409/other/api_v2.5.1.js" type="text/javascript"></script>
<script>
var map;
var num;
var Listener;
function getInstance(a) {
a.hasOwnProperty("_instance") || (a._instance = new a);
return a._instance;
}
window.onload = function () {
map = new sogou.maps.Map(document.getElementById("map_canvas"), {});
};
function AddCj() {
var mypointh;
var myPoint;
num = 0;
// 點擊後顯示座標並描點
Listener = sogou.maps.event.addListener(map, 'click', function (event) {
if (num == 0) {
mypointh = myPoint = event.point;
} else {
myPoint = mypointh;
mypointh = event.point;
}
Lines(mypointh, myPoint);
num++;
});
}
function DelCj() {
sogou.maps.event.removeListener(Listener);
}
function Lines(myLatlng, myPoint) {
var convertor = getInstance(sogou.maps.Convertor);
var distance = convertor.distance(myLatlng, myPoint);
var line = new sogou.maps.Polyline({
path: [myLatlng, myPoint],
strokeColor: "#FF0000",
strokeOpacity: 1.0,
strokeWeight: 1,
title: parseInt(distance) + "米",
map: map
});
placeMarker(myLatlng, parseInt(distance));
}
// 依指定座標動態描點
function placeMarker(location, jl) {
var marker1 = new sogou.maps.Marker({
position: location,
title: jl + "米",
label: { visible: true, align: "BOTTOM" },
map: map
});
}
function Mapclear() {
num = 0;
map.clearAll();
}
</script>
</head>
<body>
<form id="form1" runat="server">
<input type="button" value="測距" onclick="AddCj()" />
<input type="button" value="取消測距" onclick="DelCj()" />
<input type="button" value="清空" onclick="Mapclear()" />
<div id="map_canvas"></div>
</form>
</body>
</html>
以上即搜狗地圖 API 的常用操作。若你在維護新專案,建議先確認該服務是否仍在提供——這類第三方地圖服務的可用性會隨時間變動,選型時值得留意替代方案。