เลเยอร์การวาด (ไลบรารี)

1. ภาพรวม
2. การใช้ไลบรารี
3. ตัวเลือก DrawingManager
4. การอัปเดตตัวควบคุมเครื่องมือวาดภาพ
5. ภาพวาด

ภาพรวม

ชั้นเรียน DrawingManager มอบอินเทอร์เฟซที่เป็นกราฟิกให้ผู้ใช้วาดรูปเหลี่ยม สี่เหลี่ยมผืนผ้า เส้นประกอบ วงกลม และเครื่องหมายบนแผนที่ได้

การใช้ไลบรารี

เครื่องมือวาดคือไลบรารีแบบประกอบของตัวเองที่แยกจากโค้ด JavaScript ของ Maps API หลัก หากต้องการใช้ฟังก์ชันที่มีอยู่ในไลบรารีนี้ ก่อนอื่นคุณต้องโหลดโดยใช้พารามิเตอร์ libraries ใน URL รองเท้าบู๊ตของ Maps API

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=drawing&callback=initMap">
</script>

เมื่อเพิ่มพารามิเตอร์ Library แล้ว คุณจะสร้างออบเจ็กต์ DrawingManager ได้ดังนี้

var drawingManager = new google.maps.drawing.DrawingManager();
drawingManager.setMap(map);

ตัวเลือก DrawingManager

เครื่องมือสร้าง DrawingManager จะใช้ชุดตัวเลือกที่กําหนดชุดการควบคุมที่จะแสดง ตําแหน่งของการควบคุม และสถานะภาพวาดเริ่มต้น

• พร็อพเพอร์ตี้ drawingMode ของ DrawingManager กําหนดสถานะภาพวาดเริ่มต้นของ DrawingManager ยอมรับค่าคงที่ google.maps.drawing.OverlayType ค่าเริ่มต้นคือ null ซึ่งในกรณีนี้เคอร์เซอร์จะอยู่ในโหมดไม่วาดเมื่อเริ่มต้น DrawingManager
• พร็อพเพอร์ตี้ drawingControl ของ DrawingManager กําหนดระดับการเข้าถึงของอินเทอร์เฟซการเลือกเครื่องมือวาดภาพในแผนที่ โดยยอมรับค่าบูลีน
• นอกจากนี้ คุณยังกําหนดตําแหน่งของการควบคุมและประเภทการวางซ้อนที่ควรแสดงในการควบคุมได้โดยใช้พร็อพเพอร์ตี้ drawingControlOptions ของ DrawingManager
  • position กําหนดตําแหน่งของตัวควบคุมภาพวาดบนแผนที่ และยอมรับค่าคงที่ google.maps.ControlPosition
  • drawingModes คืออาร์เรย์ของค่าคงที่ google.maps.drawing.OverlayType และกําหนดประเภทการวางซ้อนที่จะรวมไว้ในเครื่องมือควบคุมรูปร่างการวาด ไอคอนมือจะปรากฏขึ้นเพื่อให้ผู้ใช้โต้ตอบกับแผนที่ได้โดยไม่ต้องวาด ลําดับของเครื่องมือในการควบคุมจะตรงกับลําดับที่ประกาศในอาร์เรย์
• การวางซ้อนแต่ละประเภทสามารถกําหนดชุดของพร็อพเพอร์ตี้เริ่มต้น ซึ่งกําหนดลักษณะของโฆษณาซ้อนทับเมื่อสร้างครั้งแรก ค่าเหล่านี้กําหนดไว้ในพร็อพเพอร์ตี้ {overlay}Options ของการวางซ้อนนั้น (โดย {overlay} แสดงถึงประเภทการวางซ้อน) เช่น พร็อพเพอร์ตี้การเติมวงกลม พร็อพเพอร์ตี้โรคหลอดเลือดสมอง zindex และความสามารถในการคลิกจะกําหนดได้ด้วยพร็อพเพอร์ตี้ circleOptions หากระบบส่งค่าขนาด สถานที่ตั้ง หรือแผนที่ ระบบจะไม่สนใจค่านั้น ดูรายละเอียดทั้งหมดของพร็อพเพอร์ตี้ที่ตั้งค่าได้ในเอกสารอ้างอิง API

หมายเหตุ: หากต้องการสร้างรูปร่างที่ผู้ใช้แก้ไขได้หลังจากที่สร้างแล้ว ให้ตั้งค่าพร็อพเพอร์ตี้ editable เป็น true

TypeScript

// This example requires the Drawing library. Include the libraries=drawing
// parameter when you first load the API. For example:
// <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=drawing">

function initMap(): void {
  const map = new google.maps.Map(
    document.getElementById("map") as HTMLElement,
    {
      center: { lat: -34.397, lng: 150.644 },
      zoom: 8,
    }
  );

  const drawingManager = new google.maps.drawing.DrawingManager({
    drawingMode: google.maps.drawing.OverlayType.MARKER,
    drawingControl: true,
    drawingControlOptions: {
      position: google.maps.ControlPosition.TOP_CENTER,
      drawingModes: [
        google.maps.drawing.OverlayType.MARKER,
        google.maps.drawing.OverlayType.CIRCLE,
        google.maps.drawing.OverlayType.POLYGON,
        google.maps.drawing.OverlayType.POLYLINE,
        google.maps.drawing.OverlayType.RECTANGLE,
      ],
    },
    markerOptions: {
      icon: "https://developers.google.com/maps/documentation/javascript/examples/full/images/beachflag.png",
    },
    circleOptions: {
      fillColor: "#ffff00",
      fillOpacity: 1,
      strokeWeight: 5,
      clickable: false,
      editable: true,
      zIndex: 1,
    },
  });

  drawingManager.setMap(map);
}

declare global {
  interface Window {
    initMap: () => void;
  }
}
window.initMap = initMap;
index.ts

หมายเหตุ: อ่านคู่มือเกี่ยวกับการใช้ TypeScript และ Google Maps

JavaScript

// This example requires the Drawing library. Include the libraries=drawing
// parameter when you first load the API. For example:
// <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=drawing">
function initMap() {
  const map = new google.maps.Map(document.getElementById("map"), {
    center: { lat: -34.397, lng: 150.644 },
    zoom: 8,
  });
  const drawingManager = new google.maps.drawing.DrawingManager({
    drawingMode: google.maps.drawing.OverlayType.MARKER,
    drawingControl: true,
    drawingControlOptions: {
      position: google.maps.ControlPosition.TOP_CENTER,
      drawingModes: [
        google.maps.drawing.OverlayType.MARKER,
        google.maps.drawing.OverlayType.CIRCLE,
        google.maps.drawing.OverlayType.POLYGON,
        google.maps.drawing.OverlayType.POLYLINE,
        google.maps.drawing.OverlayType.RECTANGLE,
      ],
    },
    markerOptions: {
      icon: "https://developers.google.com/maps/documentation/javascript/examples/full/images/beachflag.png",
    },
    circleOptions: {
      fillColor: "#ffff00",
      fillOpacity: 1,
      strokeWeight: 5,
      clickable: false,
      editable: true,
      zIndex: 1,
    },
  });

  drawingManager.setMap(map);
}

window.initMap = initMap;
index.js

หมายเหตุ: JavaScript จะรวบรวมจากข้อมูลโค้ด TypeScript

ดูตัวอย่าง

ลองใช้ตัวอย่าง

Stackblitz.com CodeSandbox.io JSFiddle.net GitPod.io Google Cloud Shell

การอัปเดตการควบคุมเครื่องมือวาดภาพ

เมื่อสร้างออบเจ็กต์ DrawingManager แล้ว คุณจะอัปเดตออบเจ็กต์ได้ด้วยการเรียก setOptions() และส่งค่าใหม่

drawingManager.setOptions({
  drawingControlOptions: {
    position: google.maps.ControlPosition.BOTTOM_LEFT,
    drawingModes: ['marker']
  }
});

หากต้องการซ่อนหรือแสดงตัวควบคุมเครื่องมือวาดภาพ ให้ทําดังนี้

// To hide:
drawingManager.setOptions({
  drawingControl: false
});

// To show:
drawingManager.setOptions({
  drawingControl: true
});

วิธีนําตัวควบคุมเครื่องมือวาดภาพออกจากออบเจ็กต์ map

drawingManager.setMap(null);

การซ่อนการควบคุมภาพวาดทําให้ตัวควบคุมเครื่องมือวาดไม่แสดง แต่ฟังก์ชันทั้งหมดของคลาส DrawingManager ยังคงใช้งานได้ วิธีนี้ช่วยให้คุณใช้การควบคุมของตัวเองได้หากต้องการ การนํา DrawingManager ออกจากออบเจ็กต์ map จะปิดใช้ฟังก์ชันการวาดทั้งหมด ต้องแนบไว้กับแผนที่อีกครั้งด้วย drawingManager.setMap(map) หรือออบเจ็กต์ DrawingManager ใหม่ที่สร้างขึ้นหากจะกู้คืนฟีเจอร์ภาพวาด

งานกิจกรรมวาดภาพ

เมื่อมีการสร้างรูปร่างทับซ้อนกัน เหตุการณ์ 2 เหตุการณ์จะเริ่มทํางาน ได้แก่

• เหตุการณ์ {overlay}complete (ที่ {overlay} แสดงถึงประเภทการวางซ้อน เช่น circlecomplete, polygoncomplete เป็นต้น) ระบบจะส่งการอ้างอิงไปยังการวางซ้อนเป็นอาร์กิวเมนต์
• เหตุการณ์ overlaycomplete สัญพจน์ของออบเจ็กต์ซึ่งมี OverlayType และการอ้างอิงการวางซ้อนจะเป็นอาร์กิวเมนต์

google.maps.event.addListener(drawingManager, 'circlecomplete', function(circle) {
  var radius = circle.getRadius();
});

google.maps.event.addListener(drawingManager, 'overlaycomplete', function(event) {
  if (event.type == 'circle') {
    var radius = event.overlay.getRadius();
  }
});

โปรดทราบว่าระบบจะปิดใช้เหตุการณ์ google.maps.Map เช่น click และ mousemove ขณะวาดบนแผนที่