HERE API Example - 建立可移動標記

在 HERE 地圖上可以建立可拖動的標記,使用者可以透過滑鼠點選與拖拉標記的方式移動標記。

本範例呈現互動式地圖,其中包括一個標記。 標記可以在地圖上移動。

預設標記是通過使用 H.map.Marker 類別所建立的,為了回應移動事件,需要設置 marker.draggable,且在移動事件執行期間,必須禁用地圖的預設平移交互效果(H.mapevents.Behavior)。

<!DOCTYPE html>
<html>
  <head>
    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=yes">
    <meta http-equiv="Content-type" content="text/html;charset=UTF-8">    
    <link rel="stylesheet" type="text/css" href="https://js.api.here.com/v3/3.1/mapsjs-ui.css" />
    <link rel="stylesheet" type="text/css" href="demo.css" />
    <link rel="stylesheet" type="text/css" href="styles.css" />
    <link rel="stylesheet" type="text/css" href="../template.css" />
    <script type="text/javascript" src='../test-credentials.js'></script>
    <script type="text/javascript" src="https://js.api.here.com/v3/3.1/mapsjs-core.js"></script>
    <script type="text/javascript" src="https://js.api.here.com/v3/3.1/mapsjs-service.js"></script>
    <script type="text/javascript" src="https://js.api.here.com/v3/3.1/mapsjs-ui.js"></script>
    <script type="text/javascript" src="https://js.api.here.com/v3/3.1/mapsjs-mapevents.js"></script>
  </head>
  <body id="markers-on-the-map">  
    <div id="map"></div>
    <script type="text/javascript" src='demo.js'></script>
  </body>
</html>

JavaScript

function addDraggableMarker(map, behavior){

  var marker = new H.map.Marker({lat:25.03746, lng: 121.564558}, {
    volatility: true
  });
  // 確保標記可以接收拖動事件
  marker.draggable = true;
  map.addObject(marker);

  // 禁用地圖的預設的可拖動性,以及當拖動標記時的偏移量
  map.addEventListener('dragstart', function(ev) {
    var target = ev.target,
        pointer = ev.currentPointer;
    if (target instanceof H.map.Marker) {
      var targetPosition = map.geoToScreen(target.getGeometry());
      target['offset'] = new H.math.Point(pointer.viewportX - targetPosition.x, pointer.viewportY - targetPosition.y);
      behavior.disable();
    }
  }, false);


  // 重新啟用地圖的可拖動性
  map.addEventListener('dragend', function(ev) {
    var target = ev.target;
    if (target instanceof H.map.Marker) {
      behavior.enable();
    }
  }, false);

  // 建立拖動事件並根據需要移動標記的位置
   map.addEventListener('drag', function(ev) {
    var target = ev.target,
        pointer = ev.currentPointer;
    if (target instanceof H.map.Marker) {
      target.setGeometry(map.screenToGeo(pointer.viewportX - target['offset'].x, pointer.viewportY - target['offset'].y));
    }
  }, false);
}


//Step 1: 初始化 platform 與建立通訊
var platform = new H.service.Platform({
  apikey: window.apikey
});
var defaultLayers = platform.createDefaultLayers();

//Step 2: 初始化地圖,設定中心點在台灣
var map = new H.Map(document.getElementById('map'),
  defaultLayers.vector.normal.map, {
  center: {lat:25, lng:120},
  zoom: 8,
  pixelRatio: window.devicePixelRatio || 1
});
// add a resize listener to make sure that the map occupies the whole container
window.addEventListener('resize', () => map.getViewPort().resize());

//Step 3: 建立 map events
var behavior = new H.mapevents.Behavior(new H.mapevents.MapEvents(map));

// 建立預設 UI 元件
var ui = H.ui.UI.createDefault(map, defaultLayers, 'en-US');

// 增加點擊事件監聽器
addDraggableMarker(map, behavior);

CSS


#map {
    width: 95%;
    height: 450px;
    background: grey;
}

#panel {
    width: 100%;
    height: 400px;
}

執行結果

網頁開始執行時標記在台北。

可透過滑鼠點擊拖拉方式移動標記。

參考文章

Draggable Marker