Lớp vẽ (Thư viện)

  1. Tổng quan
  2. Sử dụng Thư viện
  3. Các tuỳ chọn DrawingManager
  4. Cập nhật thành phần điều khiển Công cụ vẽ
  5. Sự kiện vẽ

Tổng quan

Lớp DrawingManager cung cấp giao diện đồ hoạ để người dùng vẽ đa giác, hình chữ nhật, hình nhiều đường, hình tròn và điểm đánh dấu trên bản đồ.

Sử dụng Thư viện

Công cụ vẽ là một thư viện độc lập, tách biệt với mã JavaScript của API Maps chính. Để sử dụng chức năng có trong thư viện này, trước tiên, bạn phải tải chức năng đó bằng cách sử dụng tham số libraries trong URL khởi động của API Maps:

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

Sau khi thêm tham số thư viện, bạn có thể tạo đối tượng DrawingManager như sau:

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

Các tuỳ chọn DrawingManager

Hàm khởi tạo DrawingManager có một tập hợp các tuỳ chọn xác định tập hợp các chế độ điều khiển cần hiển thị, vị trí của thành phần điều khiển và trạng thái vẽ ban đầu.

  • Thuộc tính drawingMode của DrawingManager xác định trạng thái vẽ ban đầu của DrawingManager. Phương thức này chấp nhận hằng số google.maps.drawing.OverlayType. Giá trị mặc định là null, trong trường hợp này, con trỏ ở chế độ không vẽ khi DrawingManager được khởi chạy.
  • Thuộc tính drawingControl của DrawingManager xác định chế độ hiển thị của giao diện chọn công cụ vẽ trên bản đồ. Phương thức này chấp nhận một giá trị boolean.
  • Bạn cũng có thể xác định vị trí của chế độ kiểm soát và các loại lớp phủ cần được biểu thị trong chế độ điều khiển đó bằng cách sử dụng thuộc tính drawingControlOptions của DrawingManager.
    • position xác định vị trí của thành phần điều khiển bản vẽ trên bản đồ và chấp nhận hằng số google.maps.ControlPosition.
    • drawingModes là một mảng gồm các hằng số google.maps.drawing.OverlayType và xác định các loại lớp phủ để đưa vào bộ chọn hình dạng điều khiển bản vẽ. Biểu tượng bàn tay sẽ luôn xuất hiện, cho phép người dùng tương tác với bản đồ mà không cần vẽ. Thứ tự của các công cụ trong thành phần điều khiển sẽ khớp với thứ tự được khai báo trong mảng.
  • Mỗi loại lớp phủ có thể được gán một tập hợp thuộc tính mặc định, xác định giao diện của lớp phủ khi được tạo lần đầu tiên. Các đối số này được xác định trong thuộc tính {overlay}Options của lớp phủ đó (trong đó {overlay} đại diện cho loại lớp phủ). Ví dụ: các thuộc tính tô màu nền, thuộc tính nét vẽ, zIndex và khả năng nhấp của một hình tròn có thể được xác định bằng thuộc tính circleOptions. Nếu bất kỳ giá trị kích thước, vị trí hoặc bản đồ nào được chuyển, chúng sẽ bị bỏ qua. Để biết thông tin đầy đủ về các thuộc tính có thể thiết lập, hãy tham khảo Tài liệu tham khảo API.

Lưu ý: Để tạo một hình dạng người dùng có thể chỉnh sửa sau khi tạo, hãy đặt thuộc tính editable thành 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;

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;
Xem ví dụ

Thử mẫu

Cập nhật chế độ điều khiển Công cụ vẽ

Sau khi tạo đối tượng DrawingManager, bạn có thể cập nhật đối tượng đó bằng cách gọi setOptions() và truyền các giá trị mới.

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

Để ẩn hoặc hiện chế độ điều khiển công cụ vẽ:

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

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

Cách xoá chế độ điều khiển công cụ vẽ khỏi đối tượng map:

drawingManager.setMap(null);

Việc ẩn thành phần điều khiển bản vẽ sẽ khiến các thành phần điều khiển của công cụ vẽ không xuất hiện, nhưng mọi chức năng của lớp DrawingManager vẫn dùng được. Bằng cách này, bạn có thể triển khai chế độ kiểm soát của riêng mình nếu muốn. Việc xoá DrawingManager khỏi đối tượng map sẽ vô hiệu hoá mọi chức năng vẽ; bạn phải đính kèm lại đối tượng này vào bản đồ bằng drawingManager.setMap(map) hoặc một đối tượng DrawingManager mới được tạo nếu cần khôi phục các tính năng vẽ.

Sự kiện vẽ

Khi một lớp phủ hình dạng được tạo, hai sự kiện sẽ được kích hoạt:

  • Sự kiện {overlay}complete (trong đó {overlay} đại diện cho loại lớp phủ, chẳng hạn như circlecomplete, polygoncomplete, v.v.). Thông tin tham chiếu đến lớp phủ được truyền dưới dạng đối số.
  • Sự kiện overlaycomplete. Một đối tượng cố định chứa OverlayType và tham chiếu đến lớp phủ sẽ được chuyển dưới dạng đối số.
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();
  }
});

Xin lưu ý rằng các sự kiện google.maps.Map, chẳng hạn như clickmousemove, bị tắt trong khi vẽ trên bản đồ.