Drawing Library

Lớp DrawingManager

Lớp google.maps.drawing.DrawingManager

Cho phép người dùng vẽ điểm đánh dấu, đa giác, đường nhiều đoạn, 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ế độ kiểm soát vào bản đồ, cho phép người dùng chuyển đổi chế độ vẽ.

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {DrawingManager} = await google.maps.importLibrary("drawing").
Xem Thư viện trong Maps JavaScript API.

DrawingManager
DrawingManager([options])
Tham số: 
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ế độ kiểm soát vẽ.
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
Trả về MapDrawingManager được đính kèm, đây là Map mà các lớp phủ được tạo sẽ được đặt trên đó.
setDrawingMode
setDrawingMode(drawingMode)
Tham số: 
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 sẽ không vẽ bất cứ thứ gì.
setMap
setMap(map)
Tham số: 
Giá trị trả về:  Không có
Đính kèm đối tượng DrawingManager vào Map được chỉ định.
setOptions
setOptions(options)
Tham số: 
Giá trị trả về:  Không có
Đặt các lựa chọn của DrawingManager.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
circlecomplete
function(circle)
Đối số: 
  • circleCircle Vòng 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ố: 
  • markerMarker Đ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 một điểm đánh dấu.
overlaycomplete
function(event)
Đối số: 
  • eventOverlayCompleteEvent 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 hoàn tất việc vẽ một lớp phủ thuộc bất kỳ loại nào.
polygoncomplete
function(polygon)
Đối số: 
  • polygonPolygon Đ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ố: 
  • polylinePolyline Đường nhiều đoạ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 đường nhiều đoạn.
rectanglecomplete
function(rectangle)
Đối số: 
  • rectangleRectangle 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.DrawingManagerOptionsgiao diện

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

circleOptions optional
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 centerradius 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 optional
Loại:  boolean optional
Mặc định: true
Trạng thái bật/tắt của chế độ vẽ.
drawingControlOptions optional
Loại:  DrawingControlOptions optional
Các lựa chọn hiển thị cho chế độ kiểm soát bản vẽ.
drawingMode optional
Loại:  OverlayType optional
Chế độ vẽ của DrawingManager, 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 sẽ không vẽ bất cứ thứ gì.
map optional
Loại:  Map optional
MapDrawingManager được đính kèm, đây là Map mà các lớp phủ được tạo sẽ được đặt lên.
markerOptions optional
Loại:  MarkerOptions optional
Các lựa 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 sẽ bị bỏ qua và thuộc tính map của một điểm đánh dấu mới luôn được đặt thành bản đồ của DrawingManager.
polygonOptions optional
Loại:  PolygonOptions optional
Các lựa 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 sẽ bị bỏ qua và thuộc tính map của một đa giác mới luôn được đặt thành bản đồ của DrawingManager.
polylineOptions optional
Loại:  PolylineOptions optional
Các lựa chọn để áp dụng cho mọi đường nhiều đoạn mới được tạo bằng DrawingManager này. Thuộc tính path sẽ bị bỏ qua và thuộc tính map của một đường nhiều đoạn mới luôn được đặt thành bản đồ của DrawingManager.
rectangleOptions optional
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 sẽ bị bỏ qua và thuộc tính map của một 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.DrawingControlOptionsgiao diện

Các lựa chọn để kết xuất chế độ kiểm soát bản vẽ.

drawingModes optional
Loại:  Array<OverlayType> optional
Các chế độ vẽ sẽ xuất hiện trong chế độ vẽ, theo thứ tự xuất hiện. 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 optional
Loại:  ControlPosition optional
Mã vị trí. Dùng để chỉ định vị trí của chế độ điều khiển trên bản đồ.

Giao diện OverlayCompleteEvent

google.maps.drawing.OverlayCompleteEventgiao diện

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

overlay
Lớp phủ đã hoàn thành.
type
Loại:  OverlayType
Loại lớp phủ đã hoàn tất.

Hằng số OverlayType

Hằng số google.maps.drawing.OverlayType

Các loại lớp phủ mà DrawingManager có thể tạo. 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

Truy cập bằng cách gọi const {OverlayType} = await google.maps.importLibrary("drawing").
Xem Thư viện trong Maps JavaScript API.

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 các đ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 các đường nhiều đoạn và lớp phủ được cung cấp trong sự kiện overlaycomplete là một đường nhiều đoạn.
RECTANGLE Chỉ định rằng DrawingManager tạo các hình chữ nhật và lớp phủ được cung cấp trong sự kiện overlaycomplete là một hình chữ nhật.