arcgis api for js入门开发系列三地图工具栏

上一篇实现了demo的地图加载展示，在上篇实现的基础上，新增了地图工具栏以及通用地图控件功能，比如地图框选缩放、地图漫游、清空、量算工具、地图导航控件、地图比例尺控件、地图鹰眼图等等，总共分为5个部分，截图如下：

1.工具栏，在map.html页面引入工具栏实现需要的js文件
<pre><script type="text/javascript" src="js/main/map.map2dPanel.js"></script></pre>
然后在map.js文件中地图初始化函数load2DMap进行工具栏的js调用
<pre>//显示地图工具栏
DCI.map2dTool.InitTool(map);</pre>
map2dPanel.js实现了地图工具栏所有的功能，谈谈实现核心部分功能的代码：
（1）拉框放大：这个实现比较简单，利用拉框的矩形范围，直接设置地图的范围为拉框的范围即可
<pre>$("#zoomIn").click(function () {//地图拉框放大
map.setMapCursor("url('" + getRootPath() + "Content/images/index/cursor/zoomout.cur'),auto");//设置地图鼠标形状
DCI.map2dTool.drawtool.activate(esri.toolbars.Draw.EXTENT);//利用api的画工具draw来画矩形，获取矩形范围
DCI.map2dTool.drawExtent(null, function (geometry) {//draw工具画完的回调函数
DCI.map2dTool.zoomOutByExtent(geometry);//获取回调函数的geometry（extent）范围
});
});

  drawExtent: function (symbol, onDrawEnd) {
              DCI.map2dTool.onDrawEnd = onDrawEnd;
  },

//根据拉框范围放大
zoomInByExtent: function (geometry) {
DCI.map2dTool.map.setExtent(geometry.getExtent());//根据extent来进行地图缩放
}</pre>
（2）拉框缩小：这个跟拉框放大的原理是类似的，也是首先获取拉框的的矩形范围，但是不同的是，获取矩形范围之后跟地图当前的范围按一定的比例进行计算，构造一个新的范围extent，然后再进行地图的缩放
<pre>$("#zoomOut").click(function () {
map.setMapCursor("url('" + getRootPath() + "Content/images/index/cursor/zoomin.cur'),auto");
DCI.map2dTool.drawtool.activate(esri.toolbars.Draw.EXTENT);
DCI.map2dTool.drawExtent(null, function (geometry) {
DCI.map2dTool.zoomInByExtent(geometry);
});
});
drawExtent: function (symbol, onDrawEnd) {
DCI.map2dTool.onDrawEnd = onDrawEnd;
},
//根据拉框范围缩小
zoomOutByExtent: function (geometry) {
if (geometry.xmin != geometry.xmax && geometry.ymin != geometry.ymax) {//画矩形的范围没超出地图当前范围
var currExtent = DCI.map2dTool.map.extent;//获取地图的当前范围
var currWidth = Math.abs(currExtent.xmin - currExtent.xmax);//计算当前地图范围的宽度
var boxWidth = Math.abs(geometry.xmin - geometry.xmax);//计算拉框矩形的范围宽度
var widthFactor = currWidth / boxWidth;//计算两者的宽度的比率

        var currHeight = Math.abs(currExtent.ymin - currExtent.ymax);//计算当前地图范围的高度
        var boxHeight = Math.abs(geometry.ymin - geometry.ymax);//计算拉框矩形的范围高度
        var heightFactor = currHeight / boxHeight;//计算两者的高度比率

        if (widthFactor >= heightFactor) {
            currExtent = currExtent.expand(widthFactor);
        } else {
            currExtent = currExtent.expand(heightFactor);
        }
        DCI.map2dTool.map.setExtent(currExtent);
    } else {//超出地图当前范围时候，直接地图缩小一级
        if (parseInt(DCI.map2dTool.map.getLevel()) > 0) {
            DCI.map2dTool.map.setLevel(parseInt(DCI.map2dTool.map.getLevel()) - 1);
        }
    }
}</pre>

（3）量算工具，这个部分详细的参照：arcgis api for js共享干货系列之一自写算法实现地图量算工具

2.Navigation控件，这个部分详细的参照：arcgis api for js共享干货系列之二自定义Navigation控件样式风格
3.地图比例尺控件，这个实现比较简单，直接调用api封装好的Scalebar
<pre>//加载比例尺
var scalebar = new esri.dijit.Scalebar({
map: map,//地图对象
attachTo: "bottom-left",//控件的位置，左下角
scalebarStyle: "ruler",//line 比例尺样式类型
scalebarUnit: "metric"//显示地图的单位，这里是km
});</pre>
其他的具体属性请参照api：https://developers.arcgis.com/javascript/3/jsapi/scalebar-amd.html
4.地图显示坐标，这个实现利用地图移动onMouseMove以及拖拽onMouseDrag事件，通过监听事件动态获取地图当前的鼠标坐标值 <pre>//加载地图显示坐标
showCoordinates(map);

/**

• 显示地图坐标
  */
  function showCoordinates(map) {
  var coordinatesDiv = document.getElementById("map_coordinates");//js通过id获取div
  if (coordinatesDiv) {//div存在就显示
  coordinatesDiv.style.display = "block";
  }
  else {//不存在情况下，动态创建指定id的div
  var _divID_coordinates = "map_coordinates";//div的id
  coordinatesDiv = document.createElement("div");//动态创建div
  coordinatesDiv.id = _divID_coordinates;//id
  coordinatesDiv.className = "map-coordinates";//div的css样式
  coordinatesDiv.innerHTML = "";//默认div填充为空
  document.getElementById("map").appendChild(coordinatesDiv);//动态创建的div放在地图map容器div里面
  dojo.connect(map, "onMouseMove", showCoords);//监听地图的移动事件
  dojo.connect(map, "onMouseDrag", showCoords);
  function showCoords(evt) {
  evt = evt ? evt : (window.event ? window.event : null);
  var mp = evt.mapPoint;//获取鼠标当前位置的地图坐标值
  coordinatesDiv.innerHTML = "<span id='cd_label' style='font-size:13px;text-align:center;font-family:微软雅黑;'>" + "横坐标：" + mp.x.toFixed(3) + " 纵坐标：" + mp.y.toFixed(3) + "</span>";
  }
  }
  }</pre>5.地图鹰眼控件，这个实现比较简单，直接调用api封装好的OverviewMap
  <pre>//加载鹰眼
  var overviewMapDijit = new esri.dijit.OverviewMap({
  map: map,
  attachTo: "bottom-right",
  color: " #D84E13",
  opacity: .40
  });</pre>
  其他的具体属性请参照api：https://developers.arcgis.com/javascript/3/jsapi/overviewmap-amd.html

GIS之家作品：https://shop116521643.taobao.com/shop/view_shop.htm
GIS之家兴趣部落：http://buluo.qq.com/p/barindex.html?bid=327395
GIS项目交流群：238339408
GIS之家交流群一：432512093