Drawing Library

Lớp DrawingManager

google.maps.drawing.DrawingManager class
extends MVCObject
library "drawing"

Không dùng nữa: Chức năng thư viện vẽ trong API JavaScript của Maps không còn được dùng nữa. API này không còn được dùng nữa kể từ tháng 8 năm 2025 và sẽ không hoạt động trong phiên bản Maps JavaScript API phát hành sau đó vào tháng 5 năm 2026. Để biết thêm thông tin, hãy xem https://developers.google.com/maps/deprecations

Cho phép người dùng vẽ điểm đánh dấu, đa giác, hình nhiều đường, hình chữ nhật và hình tròn trên bản đồ. Chế độ vẽ của DrawingManager xác định loại lớp phủ mà người dùng sẽ tạo. Thêm một chế độ điều khiển vào bản đồ, cho phép người dùng chuyển đổi chế độ vẽ.

const {DrawingManager} = await google.maps.importLibrary("drawing");

Hàm dựng
DrawingManager	DrawingManager([options]) Tham số: options: DrawingManagerOptions optional Tạo một DrawingManager cho phép người dùng vẽ lớp phủ trên bản đồ và chuyển đổi giữa các loại lớp phủ cần vẽ bằng một chế độ điều khiển vẽ.

Phương thức
getDrawingMode	getDrawingMode() Tham số: Không có Giá trị trả về: OverlayType|null Trả về chế độ vẽ của DrawingManager.
getMap	getMap() Tham số: Không có Giá trị trả về: Map|null Trả về Map mà DrawingManager được đính kèm, tức là Map nơi đặt lớp phủ đã tạo.
setDrawingMode	setDrawingMode(drawingMode) Tham số: drawingMode: OverlayType optional Giá trị trả về: Không có Thay đổi chế độ vẽ của DrawingManager, chế độ này xác định loại lớp phủ sẽ được thêm vào bản đồ. Các giá trị được chấp nhận là 'marker', 'polygon', 'polyline', 'rectangle', 'circle' hoặc null. Chế độ vẽ null có nghĩa là người dùng có thể tương tác với bản đồ như bình thường và các lượt nhấp không vẽ bất cứ thứ gì.
setMap	setMap(map) Tham số: map: Map optional Giá trị trả về: Không có Gắn đối tượng DrawingManager vào Map được chỉ định.
setOptions	setOptions(options) Tham số: options: DrawingManagerOptions optional Giá trị trả về: Không có Đặt các tuỳ chọn của DrawingManager.
Được kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Sự kiện
circlecomplete	function(circle) Đối số: circle: Circle optional Hình tròn mà người dùng vừa vẽ. Sự kiện này được kích hoạt khi người dùng vẽ xong một hình tròn.
markercomplete	function(marker) Đối số: marker: Marker Điểm đánh dấu mà người dùng vừa vẽ. Sự kiện này được kích hoạt khi người dùng đã vẽ xong điểm đánh dấu.
overlaycomplete	function(event) Đối số: event: OverlayCompleteEvent optional Lớp phủ mà người dùng vừa vẽ, cùng với loại lớp phủ. Sự kiện này được kích hoạt khi người dùng đã vẽ xong một lớp phủ thuộc bất kỳ loại nào.
polygoncomplete	function(polygon) Đối số: polygon: Polygon Đa giác mà người dùng vừa vẽ. Sự kiện này được kích hoạt khi người dùng vẽ xong một đa giác.
polylinecomplete	function(polyline) Đối số: polyline: Polyline optional Hình nhiều đường mà người dùng vừa vẽ. Sự kiện này được kích hoạt khi người dùng vẽ xong một hình nhiều đường.
rectanglecomplete	function(rectangle) Đối số: rectangle: Rectangle optional Hình chữ nhật mà người dùng vừa vẽ. Sự kiện này được kích hoạt khi người dùng vẽ xong một hình chữ nhật.

Giao diện DrawingManagerOptions

google.maps.drawing.DrawingManagerOptions giao diện

Các tuỳ chọn cho trình quản lý bản vẽ.

Thuộc tính
circleOptions không bắt buộc	Loại: CircleOptions optional Các lựa chọn áp dụng cho mọi vòng kết nối mới được tạo bằng DrawingManager này. Các thuộc tính center và radius sẽ bị bỏ qua, còn thuộc tính map của một vòng tròn mới luôn được đặt thành bản đồ của DrawingManager.
drawingControl không bắt buộc	Loại: boolean optional Mặc định: true Trạng thái bật/tắt của chế độ điều khiển bản vẽ.
drawingControlOptions không bắt buộc	Loại: DrawingControlOptions optional Các lựa chọn hiển thị cho thành phần điều khiển bản vẽ.
drawingMode không bắt buộc	Loại: OverlayType optional Chế độ vẽ của DrawingManager, xác định loại lớp phủ cần thêm vào bản đồ. Các giá trị được chấp nhận là 'marker', 'polygon', 'polyline', 'rectangle', 'circle' hoặc null. Chế độ vẽ null có nghĩa là người dùng có thể tương tác với bản đồ như bình thường và các lượt nhấp không vẽ bất cứ thứ gì.
map không bắt buộc	Loại: Map optional Map mà DrawingManager được đính kèm, tức là Map mà lớp phủ được tạo sẽ được đặt trên đó.
markerOptions không bắt buộc	Loại: MarkerOptions optional Các tuỳ chọn áp dụng cho mọi điểm đánh dấu mới được tạo bằng DrawingManager này. Thuộc tính position bị bỏ qua và thuộc tính map của điểm đánh dấu mới luôn được đặt thành bản đồ của DrawingManager.
polygonOptions không bắt buộc	Loại: PolygonOptions optional Các tuỳ chọn áp dụng cho mọi đa giác mới được tạo bằng DrawingManager này. Thuộc tính paths bị bỏ qua và thuộc tính map của đa giác mới luôn được đặt thành bản đồ của DrawingManager.
polylineOptions không bắt buộc	Loại: PolylineOptions optional Các tuỳ chọn áp dụng cho mọi hình nhiều đường mới được tạo bằng DrawingManager này. Thuộc tính path bị bỏ qua và thuộc tính map của một hình nhiều đường mới luôn được đặt thành bản đồ của DrawingManager.
rectangleOptions không bắt buộc	Loại: RectangleOptions optional Các lựa chọn để áp dụng cho mọi hình chữ nhật mới được tạo bằng DrawingManager này. Thuộc tính bounds bị bỏ qua và thuộc tính map của hình chữ nhật mới luôn được đặt thành bản đồ của DrawingManager.

Giao diện DrawingControlOptions

google.maps.drawing.DrawingControlOptions giao diện

Các tuỳ chọn để hiển thị thành phần điều khiển bản vẽ.

Thuộc tính
drawingModes không bắt buộc	Loại: Array<OverlayType> optional Mặc định: [OverlayType.MARKER, OverlayType.POLYLINE, OverlayType.RECTANGLE, OverlayType.CIRCLE, OverlayType.POLYGON] Các chế độ vẽ sẽ hiển thị trong thành phần điều khiển vẽ, theo thứ tự hiển thị. Biểu tượng bàn tay (tương ứng với chế độ vẽ null) luôn có sẵn và không được chỉ định trong mảng này.
position không bắt buộc	Loại: ControlPosition optional Mặc định: ControlPosition.TOP_LEFT Mã vị trí. Dùng để chỉ định vị trí của thành phần điều khiển trên bản đồ.

Giao diện OverlayCompleteEvent

google.maps.drawing.OverlayCompleteEvent giao diện

Các thuộc tính của sự kiện overlaycomplete trên DrawingManager.

Thuộc tính
overlay	Loại: Marker|Polygon|Polyline|Rectangle|Circle Lớp phủ hoàn chỉnh.
type	Loại: OverlayType Loại lớp phủ đã hoàn tất.

Hằng số OverlayType

google.maps.drawing.OverlayType hằng số
thư viện "drawing"

Các loại lớp phủ có thể được tạo bởi DrawingManager. Chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên của hằng số. Ví dụ: 'polygon' hoặc google.maps.drawing.OverlayType.POLYGON

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại OverlayTypeString.

const {OverlayType} = await google.maps.importLibrary("drawing");

Hằng số
CIRCLE	Chỉ định rằng DrawingManager tạo các vòng tròn và lớp phủ được cung cấp trong sự kiện overlaycomplete là một vòng tròn.
MARKER	Chỉ định rằng DrawingManager tạo điểm đánh dấu và lớp phủ được cung cấp trong sự kiện overlaycomplete là một điểm đánh dấu.
POLYGON	Chỉ định rằng DrawingManager tạo đa giác và lớp phủ được cung cấp trong sự kiện overlaycomplete là một đa giác.
POLYLINE	Chỉ định rằng DrawingManager tạo hình nhiều đường và lớp phủ được cung cấp trong sự kiện overlaycomplete là một hình nhiều đường.
RECTANGLE	Chỉ định rằng DrawingManager tạo hình chữ nhật và lớp phủ được cung cấp trong sự kiện overlaycomplete là hình chữ nhật.