DIV CSS 佈局教程網

搜狗地圖 API 入門實戰:初始化、控制與測距
編輯:關於JavaScript     

本文整理搜狗地圖 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 的常用操作。若你在維護新專案,建議先確認該服務是否仍在提供——這類第三方地圖服務的可用性會隨時間變動,選型時值得留意替代方案。

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