目录

1 地图控件

地图控件指华为地图上负责与地图交互的UI控件。华为地图提供了丰富的UI控件,包括比例尺、缩放条、缩放按钮、指北针、平移按钮和版权,如下图:

图1:地图控件

1. 比例尺,可以使用scaleControl来控制是否显示比例尺,并通过scaleControlOptions设置比例尺的单位。默认为false,显示在地图的右下角。

  1. var mapOptions = {};
  2. mapOptions.center = {lat: 48.856613, lng: 2.352222};
  3. mapOptions.zoom = 10;
  4. mapOptions.scaleControl = true;    //设置显示比例尺
  5. mapOptions.scaleControlOptions = {
  6.    units: "imperial"             //设置比例尺单位为英制英寸
  7. };

2. 缩放条,可以使用zoomSlider来控制是否显示缩放拉条,默认为false,显示在地图的右下方。

  1. var mapOptions = {};
  2. mapOptions.center = {lat: 48.856613, lng: 2.352222};
  3. mapOptions.zoom = 10;
  4. mapOptions.zoomSlider = true;      //设置显示缩放条

3. 缩放按钮,可以使用zoomControl设置是否显示缩放按钮,默认为true,显示在地图的右下方。

  1. var mapOptions = {};
  2. mapOptions.center = {lat: 48.856613, lng: 2.352222};
  3. mapOptions.zoom = 10;
  4. mapOptions.zoomControl = false;      //设置不显示缩放按钮

4. 指北针,可以使用rotateControl设置是否显示指北针,默认为false。当地图朝向不是正北方,自动显示在右上角。

  1. var mapOptions = {};
  2. mapOptions.center = {lat: 48.856613, lng: 2.352222};
  3. mapOptions.zoom = 10;
  4. mapOptions.rotateControl= true;      //设置显示指北针

5. 平移按钮,可以使用navigationControl设置是否显示平移按钮,默认为false,显示在地图的右上方。

  1. var mapOptions = {};
  2. mapOptions.center = {lat: 48.856613, lng: 2.352222};
  3. mapOptions.zoom = 10;
  4. mapOptions.navigationControl= true;      //设置显示平移按钮

6. 版权,可以使用copyrightControl设置是否显示版权,并且通过copyrightControlOptions自定义版权内容以及样式等,默认为false。

  1. var mapOptions = {};
  2. mapOptions.center = {lat: 48.856613, lng: 2.352222};
  3. mapOptions.zoom = 10;
  4. mapOptions.copyrightControl = true;    //设置显示版权
  5. mapOptions.copyrightControlOptions = {value: "<font style='position: absolute; left: 20px; bottom: 20px; z-index: 101' size='5' color='red'>HUAWEI</font>",}//设置版权内容
说明:
地图控件除了可以在创建地图之前设置,也可以在创建地图之后通过set方法设置。

2 相机控制

1. 地图移动,可以调用map.panTo(latLng)方法,地图中心会移动到指定坐标点。

  1. <tr>
  2.    <td>X/Latitude:</td>
  3.    <td><input id="xLatInput" type="text" value="48.8"/></td>
  4. </tr>
  5. <tr>
  6.    <td>Y/Longitude:</td>
  7.    <td><input id="yLngInput" type="text" value="2.3"/></td>
  8. </tr>
  1. var lat = Number(document.getElementById("xLatInput").value);
  2. var lng = Number(document.getElementById("yLngInput").value);
  3. map.panTo({lat: lat, lng: lng});

2. 地图偏移,可以调用map.panBy(x, y)方法,地图中心会根据x和y值进行偏移,其中x和y单位为像素。

  1. <tr>
  2.    <td>X/Latitude:</td>
  3.    <td><input id="xLatInput" type="text" value="100"/></td>
  4. </tr>
  5. <tr>
  6.    <td>Y/Longitude:</td>
  7.    <td><input id="yLngInput" type="text" value="100"/></td>
  8. </tr>
  1. var x = Number(document.getElementById("xLatInput").value);
  2. var y = Number(document.getElementById("yLngInput").value);
  3. map.panBy(x, y);

3. 缩放控制,可以使用map.setZoom(zoom)方法对地图缩放级别进行指定设置,也可以使用map.zoomIn()和map.zoomOut()对地图缩放级别进行修改,每次增加或缩小一个级别。

  1. <tr>
  2.     <td>Super Input:</td>
  3.     <td><input id="superInput" type="text" value=""/></td>
  4. </tr>
  1. var zoom = Number(document.getElementById("superInput").value);
  2. map.setZoom(zoom);//设置地图缩放系数
  3. map.zoomIn();//地图放大一个级别
  4. setTimeout(function () {
  5.    map.zoomOut();//地图缩小一个级别
  6. }, 5000);

4. 区域控制,可以使用map.fitBounds(bounds)设置地图显示区域的范围。

  1. <tr>
  2.    <td>SouthWestLat:</td>
  3.    <td><input id="swLatInput" type="text" value="39.82"/></td>
  4. </tr>
  5. <tr>
  6.    <td>SouthWestLng:</td>
  7.    <td><input id="swLngInput" type="text" value="116.3"/></td>
  8. </tr>
  9. <tr>
  10.    <td>NorthEastLat:</td>
  11.    <td><input id="neLatInput" type="text" value="40.0"/></td>
  12. </tr>
  13. <tr>
  14.    <td>NorthEastLng:</td>
  15.    <td><input id="neLngInput" type="text" value="116.5"/></td>
  16. </tr>
  1. var swLat = Number(document.getElementById("swLatInput").value);
  2. var swLng = Number(document.getElementById("swLngInput").value);
  3. var neLat = Number(document.getElementById("neLatInput").value);
  4. var neLng = Number(document.getElementById("neLngInput").value);
  5. map.fitBounds({
  6.    sw: {lng: swLng, lat: swLat},
  7.    ne: {lng: neLng, lat: neLat},
  8. });

3 地图事件

1. 地图点击事件:

  1. map.on('click', () => {
  2.      map.zoomIn();
  3. });

2. 地图中心点改变事件:

  1. map.onCenterChanged(centerChangePost);
  2. function centerChangePost() {
  3.    var center = map.getCenter();
  4.    alert( 'Lng:'+center.lng+'\n'+'Lat:'+center.lat);
  5. }

3. 地图方向改变事件:

  1. map.onHeadingChanged(headingChangePost);
  2. function headingChangePost() {
  3.    alert('Heading Changed!')
  4. }

4. 地图缩放级别改变事件:

  1. map.onZoomChanged(zoomChangePost);
  2. function zoomChangePost() {
  3.    alert('Zoom Changed!')
  4. }


关于地图事件,如下表格所示:

事件含义使用方式
click鼠标左键点击。map.on('click', callback), 参数callback为自定义回调函数。
singleclick鼠标左键单击。map.on('singleclick', callback), 参数callback为自定义回调函数。
dblclick鼠标左键双击。map.on('dblclick', callback), 参数callback为自定义回调函数。
contextmenu鼠标右键单击。map.on('contextmenu', callback), 参数callback为自定义回调函数。
pointermove鼠标移动。map.on('pointermove', callback), 参数callback为自定义回调函数。
pointerdown鼠标键按下。map.on('pointerdown', callback), 参数callback为自定义回调函数。
pointerup鼠标键松开。map.on('pointerup', callback), 参数callback为自定义回调函数。
movestart地图开始移动。map.on('movestart', callback), 参数callback为自定义回调函数。
moveend地图结束移动。map.on('moveend', callback), 参数callback为自定义回调函数。
pointerdrag地图拖动。map.on('pointerdrag', callback), 参数callback为自定义回调函数。
onCenterChanged地图中心点改变。map.onCenterChanged(callback), 参数callback为自定义回调函数。
onHeadingChanged方向改变。map.onHeadingChanged(callback), 参数callback为自定义回调函数。
onZoomChanged缩放级别改变。map.onZoomChanged(callback), 参数callback为自定义回调函数。