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, đa tuyế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 thành phần điều khiển 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 phần Thư viện trong API Maps JavaScript.
DrawingManager
DrawingManager([options])
Thông 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ủ sẽ được vẽ bằng một thành phần điều khiển bản vẽ.
getDrawingMode
getDrawingMode()
Thông số:  Không có
Giá trị trả về:  OverlayType|null
Trả về chế độ vẽ của DrawingManager.
getMap
getMap()
Thông số:  Không có
Giá trị trả về:  Map
Trả về Map mà DrawingManager được đính kèm, đây là Map mà các lớp phủ đã tạo sẽ được đặt.
setDrawingMode
setDrawingMode(drawingMode)
Thông 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 kỳ nội dung nào.
setMap
setMap(map)
Thông số: 
Giá trị trả về:  Không có
Gắn đối tượng DrawingManager vào Map đã chỉ định.
setOptions
setOptions(options)
Thông số: 
Giá trị trả về:  Không có
Đặt các tuỳ chọn của DrawingManager.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
circlecomplete
function(circle)
Đối số: 
  • circle:  Circle 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 vòng 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 một điểm đánh dấu.
overlaycomplete
function(event)
Đối số: 
  • event:  OverlayCompleteEvent 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 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 Đường đa tuyế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 đa tuyến.
rectanglecomplete
function(rectangle)
Đối số: 
  • rectangle:  Rectangle 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 hình chữ nhật.

Giao diện DrawingManagerOptions

Giao diện google.maps.drawing.DrawingManagerOptions

Các tuỳ chọn cho trình quản lý bản vẽ.
circleOptions optional
Loại:  CircleOptions optional
Các tuỳ chọn để áp dụng cho mọi vòng tròn mới được tạo bằng DrawingManager này. Các thuộc tính center và radius sẽ bị bỏ qua và 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 thành phần điều khiển bản vẽ.
drawingControlOptions optional
Loại:  DrawingControlOptions optional
Các tuỳ chọn hiển thị cho thành phần điều khiển bản vẽ.
drawingMode optional
Loại:  OverlayType optional
Chế độ vẽ của DrawingManager, xác định loại lớp phủ cần thêm trên 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 kỳ nội dung nào.
map optional
Loại:  Map optional
Map được đính kèm DrawingManager, đây là Map mà các lớp phủ được tạo sẽ được đặt.
markerOptions optional
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 optional
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 optional
Loại:  PolylineOptions optional
Các tuỳ chọn để áp dụng cho mọi đường đa tuyến 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 đường đa tuyến mới luôn được đặt thành bản đồ của DrawingManager.
rectangleOptions optional
Loại:  RectangleOptions optional
Các tuỳ 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

Giao diện google.maps.drawing.DrawingControlOptions

Các tuỳ chọn để kết xuất thành phần điều khiển bản vẽ.
drawingModes optional
Loại:  Array<OverlayType> optional
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 optional
Loại:  ControlPosition optional
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

Giao diện google.maps.drawing.OverlayCompleteEvent

Các thuộc tính của sự kiện overlaycomplete trên DrawingManager.
overlay
Lớp phủ đã hoàn tất.
type
Loại:  OverlayType
Loại của 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 hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. 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 phần Thư viện trong API Maps JavaScript.
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 đa tuyến và lớp phủ được cung cấp trong sự kiện overlaycomplete là một đường đa tuyến.
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.