Drawing Library

DrawingManager 類別

google.maps.drawing.DrawingManager 類別

允許使用者在地圖上繪製標記、多邊形、折線、矩形和圓形。DrawingManager 的繪圖模式會定義使用者建立的疊加層類型。在地圖上新增控制項，可讓使用者切換繪圖模式。

這個類別會擴充 MVCObject。

呼叫 const {DrawingManager} = await google.maps.importLibrary("drawing") 即可存取。請參閱 Maps JavaScript API 中的程式庫。

建構函式
DrawingManager	DrawingManager([options]) 參數：  options：DrawingManagerOptions optional 建立 DrawingManager，讓使用者能在地圖上繪製疊加層，並切換使用繪圖控制項繪製的疊加層類型。

方法
getDrawingMode	getDrawingMode() 參數：無 傳回值：  OverlayType|null 傳回 DrawingManager 的繪圖模式。
getMap	getMap() 參數：無 傳回值：  Map 傳回附加 DrawingManager 的 Map，這是建立疊加層的 Map。
setDrawingMode	setDrawingMode(drawingMode) 參數：  drawingMode：OverlayType optional 傳回值：無 變更 DrawingManager 的繪圖模式，以定義要在地圖上新增的疊加層類型。接受的值包括 'marker'、'polygon'、'polyline'、'rectangle'、'circle' 或 null。null 的繪圖模式表示使用者可以照常與地圖互動，而且點擊時不繪製任何內容。
setMap	setMap(map) 參數：  map：Map 傳回值：無 將 DrawingManager 物件附加至指定的 Map。
setOptions	setOptions(options) 參數：  options：DrawingManagerOptions 傳回值：無 設定 DrawingManager 的選項。
沿用： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

活動
circlecomplete	function(circle) 引數：  circle：Circle使用者剛剛繪製的圓形。 使用者繪製完圓形時，會引發此事件。
markercomplete	function(marker) 引數：  marker：Marker使用者剛繪製的標記。 使用者繪製完成標記時，會引發此事件。
overlaycomplete	function(event) 引數：  event：OverlayCompleteEvent使用者剛繪製的疊加層，以及疊加層的類型。 使用者繪製完任何類型的疊加層時，會引發此事件。
polygoncomplete	function(polygon) 引數：  polygon：Polygon使用者剛剛繪製的多邊形。 使用者繪製完成多邊形時，會引發此事件。
polylinecomplete	function(polyline) 引數：  polyline：Polyline使用者剛剛繪製的折線。 使用者繪製完成折線時，會引發此事件。
rectanglecomplete	function(rectangle) 引數：  rectangle：Rectangle使用者剛剛繪製的矩形。 使用者繪製完矩形時，會引發此事件。

DrawingManagerOptions 介面

google.maps.drawing.DrawingManagerOptions 介面

繪圖管理工具的選項。

屬性
circleOptions optional	類型：  CircleOptions optional 將選項套用至透過這個 DrawingManager 建立的任何新社交圈。系統會忽略 center 和 radius 屬性，且新圓形的 map 屬性一律會設為 DrawingManager 的地圖。
drawingControl optional	類型：  boolean optional 預設： true 繪圖控制項的啟用/停用狀態。
drawingControlOptions optional	類型：  DrawingControlOptions optional 繪圖控制項的顯示選項。
drawingMode optional	類型：  OverlayType optional DrawingManager 的繪圖模式，用於定義要在地圖上新增的疊加層類型。接受的值包括 'marker'、'polygon'、'polyline'、'rectangle'、'circle' 或 null。null 的繪圖模式表示使用者可以照常與地圖互動，而且點擊時不繪製任何內容。
map optional	類型：  Map optional DrawingManager 附加的 Map，這是要放置疊加層的 Map。
markerOptions optional	類型：  MarkerOptions optional 套用至使用此 DrawingManager 建立的任何新標記的選項。系統會忽略 position 屬性，且新標記的 map 屬性一律會設為 DrawingManager 的地圖。
polygonOptions optional	類型：  PolygonOptions optional 套用至使用此 DrawingManager 建立的任何新多邊形的選項。系統會忽略 paths 屬性，而且新多邊形的 map 屬性一律會設為 DrawingManager 的地圖。
polylineOptions optional	類型：  PolylineOptions optional 套用至使用此 DrawingManager 建立的任何新折線的選項。系統會忽略 path 屬性，並將新折線的 map 屬性設為 DrawingManager 的地圖。
rectangleOptions optional	類型：  RectangleOptions optional 套用至使用此 DrawingManager 建立的所有新矩形的選項。系統會忽略 bounds 屬性，且新矩形的 map 屬性一律會設為 DrawingManager 的地圖。

DrawingControlOptions 介面

google.maps.drawing.DrawingControlOptions 介面

繪圖控制項的轉譯選項。

屬性
drawingModes optional	類型：  Array<OverlayType> optional 預設： [OverlayType.MARKER, OverlayType.POLYLINE, OverlayType.RECTANGLE, OverlayType.CIRCLE, OverlayType.POLYGON] 繪圖控制項中的繪圖模式，依照顯示順序顯示。指針圖示 (與 null 繪圖模式對應) 可隨時使用，不會在這個陣列中指定。
position optional	類型：  ControlPosition optional 預設： ControlPosition.TOP_LEFT 位置 ID。用於指定地圖上控制項的位置。

OverlayCompleteEvent 介面

google.maps.drawing.OverlayCompleteEvent 介面

DrawingManager 上的 Overlaycomplete 事件屬性。

屬性
overlay	類型：  Marker|Polygon|Polyline|Rectangle|Circle 已完成的疊加層。
type	類型：  OverlayType 已完成疊加層的類型。

OverlayType 常數

google.maps.drawing.OverlayType 常數

可能由 DrawingManager 建立的疊加層類型。您可以採用值或常數名稱來指定這些參數。例如 'polygon' 或 google.maps.drawing.OverlayType.POLYGON。

呼叫 const {OverlayType} = await google.maps.importLibrary("drawing") 即可存取。請參閱 Maps JavaScript API 中的程式庫。

常數
CIRCLE	指定 DrawingManager 會建立圓形，且 overlaycomplete 事件中指定的疊加層為圓形。
MARKER	指定 DrawingManager 會建立標記，並將 overlaycomplete 事件中指定的疊加層為標記。
POLYGON	指定 DrawingManager 會建立多邊形，且 overlaycomplete 事件中指定的疊加層為多邊形。
POLYLINE	指定 DrawingManager 建立折線，而 overlaycomplete 事件中指定的疊加層為折線。
RECTANGLE	指定 DrawingManager 建立矩形，而 overlaycomplete 事件中提供的疊加層為矩形。