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.
Hàm dựng | |
---|---|
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ẽ. |
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 Trả về Map mà DrawingManager đượ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
|
Sự kiện | |
---|---|
circlecomplete |
function(circle) Đối số:
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ố:
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ố:
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ố:
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ố:
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ố:
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 lựa chọn cho trình quản lý bản vẽ.
Thuộc tính | |
---|---|
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 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 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 Map mà DrawingManager đượ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.DrawingControlOptions
giao diện
Các lựa chọn để kết xuất chế độ kiểm soát bản vẽ.
Thuộc tính | |
---|---|
drawingModes optional |
Loại:
Array<OverlayType> optional Mặc định:
[ 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ặc định:
ControlPosition.TOP_LEFT 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.OverlayCompleteEvent
giao diện
Các thuộc tính của sự kiện overlaycomplete trên một DrawingManager
.
Thuộc tính | |
---|---|
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.
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 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. |