Polygons

Polyline 類別

google.maps.Polyline 類別

折線是地圖上連接線段的線性疊加層。

此類別會擴充 MVCObject。

建構函式
Polyline	Polyline([opts]) 參數： opts：PolylineOptions optional 使用傳送的 PolylineOptions 建立折線，以指定在繪製折線時要使用的折線路徑和筆劃樣式。建立折線時，您可以傳遞 LatLng 陣列或 LatLng 的 MVCArray，但在執行個體化時，簡易陣列會轉換成折線內的 MVCArray。

方法
getDraggable	getDraggable() 參數：無 傳回值：boolean 傳回使用者是否可以拖曳此形狀。
getEditable	getEditable() 參數：無 傳回值：boolean 傳回使用者是否能編輯這個形狀。
getMap	getMap() 參數：無 傳回值：Map|null 傳回附加此形狀的地圖。
getPath	getPath() 參數：無 傳回值：MVCArray<LatLng> 擷取路徑。
getVisible	getVisible() 參數：無 傳回值：boolean 傳回是否要在地圖上顯示這個折線。
setDraggable	setDraggable(draggable) 參數： draggable：boolean 傳回值：無 如果設為 true，使用者就可以將這個形狀拖曳到地圖上。geodesic 屬性可定義拖曳模式。
setEditable	setEditable(editable) 參數： editable：boolean 傳回值：無 如果設為 true，使用者只要拖曳頂點和每個片段所顯示的控制點，即可編輯這個形狀。
setMap	setMap(map) 參數： map：Map optional 傳回值：無 在指定的地圖上顯示這個形狀。如果將地圖設為 null，系統將移除形狀。
setOptions	setOptions(options) 參數： options：PolylineOptions optional 傳回值：無
setPath	setPath(path) 參數： path：MVCArray<LatLng>|Array<LatLng|LatLngLiteral> 傳回值：無 設定路徑。如需詳細資訊，請參閱 PolylineOptions。
setVisible	setVisible(visible) 參數： visible：boolean 傳回值：無 如果設為 false，系統會隱藏這個折線。
繼承： addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll

事件
click	function(event) 引數： event：PolyMouseEvent 折線引發 DOM click 事件時，會引發此事件。
contextmenu	function(event) 引數： event：PolyMouseEvent 當 Poyline 觸發 DOM 內容選單事件時，會觸發此事件。
dblclick	function(event) 引數： event：PolyMouseEvent 折線引發 DOM dblclick 事件時，會引發此事件。
drag	function(event) 引數： event：MapMouseEvent 使用者拖曳折線時，會重複觸發這個事件。
dragend	function(event) 引數： event：MapMouseEvent 使用者停止拖曳折線時，會引發此事件。
dragstart	function(event) 引數： event：MapMouseEvent 使用者開始拖曳折線時，會引發此事件。
mousedown	function(event) 引數： event：PolyMouseEvent 折線引發 DOM mousedown 事件時，會引發此事件。
mousemove	function(event) 引數： event：PolyMouseEvent 折線引發 DOM mousemove 事件時，會引發此事件。
mouseout	function(event) 引數： event：PolyMouseEvent 折線 mouseout 會引發此事件。
mouseover	function(event) 引數： event：PolyMouseEvent 折線 mouseover 會引發此事件。
mouseup	function(event) 引數： event：PolyMouseEvent 折線引發 DOM mouseup 事件時，會引發此事件。
rightclick	已淘汰：請改用 Polyline.contextmenu 事件，以支援使用 macOS 的 Control-click 等使用模式。 function(event) 引數： event：PolyMouseEvent 以滑鼠右鍵按一下折線時，會引發此事件。

PolylineOptions 介面

google.maps.PolylineOptions 介面

PolylineOptions 物件，用來定義可在 Polyline 上設定的屬性。

屬性
clickable optional	類型：boolean optional 預設：true 指出此 Polyline 是否處理滑鼠事件。
draggable optional	類型：boolean optional 預設：false 如果設為 true，使用者就可以將這個形狀拖曳到地圖上。geodesic 屬性可定義拖曳模式。
editable optional	類型：boolean optional 預設：false 如果設為 true，使用者只要拖曳頂點和每個片段所顯示的控制點，即可編輯這個形狀。
geodesic optional	類型：boolean optional 預設：false 當 true 的多邊形邊緣被解譯為測地線，因此會跟隨地球的彎曲度。當 false 時，多邊形的邊緣會在螢幕空間中以直線轉譯。請注意，拖曳的測地多邊形在拖曳時，可能會隨形狀而改變。
icons optional	類型：Array<IconSequence> optional 要顯示在折線上的圖示。
map optional	類型：Map optional 要顯示折線的地圖。
path optional	類型：MVCArray<LatLng>|Array<LatLng|LatLngLiteral> optional 折線座標的排列順序。您可以使用 LatLng 的簡單陣列或 LatLng 的 MVCArray 來指定這個路徑。請注意，如果您傳送的是簡單陣列，系統會將該陣列轉換為 MVCArray。如果在 MVCArray 中新增或移除經緯度，系統就會自動更新地圖上的折線。
strokeColor optional	類型：string optional 筆觸色彩。除了延伸的具名色彩之外，也支援所有的 CSS3 色彩。
strokeOpacity optional	類型：number optional 筆觸透明度介於 0.0 和 1.0 之間。
strokeWeight optional	類型：number optional 筆觸寬度 (以像素為單位)。
visible optional	類型：boolean optional 預設：true 此折線是否顯示在地圖上。
zIndex optional	類型：number optional 和其他多邊形比較的 zIndex。

IconSequence 介面

google.maps.IconSequence 介面

說明圖示在線條上的呈現方式。

如果折線是測地線，則根據預設，偏移與重複指定的距離會以公尺為單位計算。設定偏移值或重複像素值時，會導致螢幕中的距離以像素為單位計算。

屬性
fixedRotation optional	類型：boolean optional 預設：false 如果設為 true，無論其所屬邊緣的角度為何，序列中的每個圖示都具有相同的旋轉角度。如為 false，則系統會輪播序列中的每個圖示，使其與邊緣對齊。
icon optional	類型：Symbol optional 要顯示在線條的圖示。
offset optional	類型：string optional 預設：'100%' 圖示顯示位置與線條起點之間的距離。這個距離可以用線條長度的百分比表示 (例如「50%」) 或以像素為單位 (例如「50px」)。
repeat optional	類型：string optional 預設：0 線條上連續圖示之間的距離。這個距離可以用線條長度的百分比表示 (例如「50%」) 或以像素為單位 (例如「50px」)。如要停用圖示的重複功能，請指定「0」。

Polygon 類別

google.maps.Polygon 類別

多邊形 (例如折線) 是按照順序排列的一系列連續座標。此外，多邊形會形成封閉的迴圈並定義填滿的區域。請參閱開發人員指南中的範例 (從簡單多邊形開始，以及有孔的多邊形等)。請注意，您也可以使用資料層來建立多邊形。資料層能讓你輕鬆建立孔，因為其會處理內部和外部路徑的順序。

此類別會擴充 MVCObject。

建構函式
Polygon	Polygon([opts]) 參數： opts：PolygonOptions optional 使用傳送的 PolygonOptions 建立多邊形，指定多邊形的路徑、多邊形邊緣的筆劃樣式，以及多邊形內部區域的填滿樣式。多邊形可能包含一或多個路徑，其中每個路徑都是由 LatLng 所組成的陣列。您可以在建構這些路徑時，傳送 LatLng 陣列或 LatLng 的 MVCArray。陣列化時，陣列會轉換成多邊形內的 MVCArray。

方法
getDraggable	getDraggable() 參數：無 傳回值：boolean 傳回使用者是否可以拖曳此形狀。
getEditable	getEditable() 參數：無 傳回值：boolean 傳回使用者是否能編輯這個形狀。
getMap	getMap() 參數：無 傳回值：Map|null 傳回附加此形狀的地圖。
getPath	getPath() 參數：無 傳回值：MVCArray<LatLng> 擷取第一個路徑。
getPaths	getPaths() 參數：無 傳回值：MVCArray<MVCArray<LatLng>> 擷取此多邊形的路徑。
getVisible	getVisible() 參數：無 傳回值：boolean 傳回是否要在地圖上顯示這個折線。
setDraggable	setDraggable(draggable) 參數： draggable：boolean 傳回值：無 如果設為 true，使用者就可以將這個形狀拖曳到地圖上。geodesic 屬性可定義拖曳模式。
setEditable	setEditable(editable) 參數： editable：boolean 傳回值：無 如果設為 true，使用者只要拖曳頂點和每個片段所顯示的控制點，即可編輯這個形狀。
setMap	setMap(map) 參數： map：Map optional 傳回值：無 在指定的地圖上顯示這個形狀。如果將地圖設為 null，系統將移除形狀。
setOptions	setOptions(options) 參數： options：PolygonOptions optional 傳回值：無
setPath	setPath(path) 參數： path：MVCArray<LatLng>|Array<LatLng|LatLngLiteral> 傳回值：無 設定第一個路徑。如需詳細資訊，請參閱 PolygonOptions。
setPaths	setPaths(paths) 參數： paths：MVCArray<MVCArray<LatLng>>|MVCArray<LatLng>|Array<Array<LatLng|LatLngLiteral>>|Array<LatLng|LatLngLiteral> 傳回值：無 設定此多邊形的路徑。
setVisible	setVisible(visible) 參數： visible：boolean 傳回值：無 如果設為 false，系統會隱藏這個折線。
繼承： addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll

事件
click	function(event) 引數： event：PolyMouseEvent 多邊形引發 DOM click 事件時，會引發此事件。
contextmenu	function(event) 引數： event：PolyMouseEvent 當多邊形疊加層的 DOM 內容選單事件啟動時，會觸發此事件。
dblclick	function(event) 引數： event：PolyMouseEvent 多邊形引發 DOM dblclick 事件時，會引發此事件。
drag	function(event) 引數： event：MapMouseEvent 使用者拖曳多邊形時，會重複觸發此事件。
dragend	function(event) 引數： event：MapMouseEvent 使用者停止拖曳多邊形時，會觸發此事件。
dragstart	function(event) 引數： event：MapMouseEvent 使用者開始拖曳多邊形時，會引發此事件。
mousedown	function(event) 引數： event：PolyMouseEvent 多邊形引發 DOM mousedown 事件時，會引發此事件。
mousemove	function(event) 引數： event：PolyMouseEvent 多邊形引發 DOM mousemove 事件時，會引發此事件。
mouseout	function(event) 引數： event：PolyMouseEvent 多邊形 mouseout 會引發此事件。
mouseover	function(event) 引數： event：PolyMouseEvent 多邊形 mouseover 會引發此事件。
mouseup	function(event) 引數： event：PolyMouseEvent 多邊形引發 DOM mouseup 事件時，會引發此事件。
rightclick	已淘汰：請改用 Polygon.contextmenu 事件，以支援使用 macOS 的 Control-click 等使用模式。 function(event) 引數： event：PolyMouseEvent 以滑鼠右鍵按一下多邊形時，會引發此事件。

PolygonOptions 介面

google.maps.PolygonOptions 介面

PolygonOptions 物件，用來定義可在多邊形上設定的屬性。

屬性
clickable optional	類型：boolean optional 預設：true 指出此 Polygon 是否處理滑鼠事件。
draggable optional	類型：boolean optional 預設：false 如果設為 true，使用者就可以將這個形狀拖曳到地圖上。geodesic 屬性可定義拖曳模式。
editable optional	類型：boolean optional 預設：false 如果設為 true，使用者只要拖曳頂點和每個片段所顯示的控制點，即可編輯這個形狀。
fillColor optional	類型：string optional 填色。除了延伸的具名色彩之外，也支援所有的 CSS3 色彩。
fillOpacity optional	類型：number optional 填滿透明度介於 0.0 和 1.0 之間
geodesic optional	類型：boolean optional 預設：false 當 true 的多邊形邊緣被解譯為測地線，因此會跟隨地球的彎曲度。當 false 時，多邊形的邊緣會在螢幕空間中以直線轉譯。請注意，拖曳的測地多邊形在拖曳時，可能會隨形狀而改變。
map optional	類型：Map optional 要顯示多邊形的地圖。
paths optional	類型：MVCArray<MVCArray<LatLng>>|MVCArray<LatLng>|Array<Array<LatLng|LatLngLiteral>>|Array<LatLng|LatLngLiteral> optional 指定閉合迴圈的座標順序。和折線不同，多邊形可能包含一種以上的路徑。因此，路徑屬性可以指定一或多個 LatLng 座標陣列。路徑會自動關閉；請勿重複將路徑的第一個頂點當做最後一個頂點。使用單一 LatLng 陣列即可定義簡易多邊形。更複雜的多邊形可以指定陣列陣列。任何簡易陣列都會轉換為 MVCArray。從 MVCArray 插入或移除 LatLng 會自動更新地圖上的多邊形。
strokeColor optional	類型：string optional 筆觸色彩。除了延伸的具名色彩之外，也支援所有的 CSS3 色彩。
strokeOpacity optional	類型：number optional 筆觸透明度介於 0.0 和 1.0 之間
strokePosition optional	類型：StrokePosition optional 預設：StrokePosition.CENTER 筆劃位置。
strokeWeight optional	類型：number optional 筆觸寬度 (以像素為單位)。
visible optional	類型：boolean optional 預設：true 這個多邊形是否在地圖上顯示。
zIndex optional	類型：number optional 和其他多邊形比較的 zIndex。

PolyMouseEvent 介面

google.maps.PolyMouseEvent 介面

這個物件是從折線和多邊形的滑鼠事件傳回。

此介面會擴充 MapMouseEvent。

屬性
edge optional	類型：number optional 事件發生時，在遊標下方路徑中的邊緣索引 (如果事件發生於可編輯多邊形的中點)。
path optional	類型：number optional 如果事件發生在頂點上，且多邊形可供編輯，遊標下方路徑的路徑索引。否則為 undefined。
vertex optional	類型：number optional 如果事件發生在頂點上，且折線或多邊形可供編輯，遊標會在頂點下頂點的索引。如果事件未發生在頂點，值為 undefined。
繼承： domEvent、 latLng

方法
繼承： stop

Rectangle 類別

google.maps.Rectangle 類別

矩形疊加層。

此類別會擴充 MVCObject。

建構函式
Rectangle	Rectangle([opts]) 參數： opts：RectangleOptions optional 使用傳送的 RectangleOptions 建立矩形，藉此指定邊界和樣式。

方法
getBounds	getBounds() 參數：無 傳回值：LatLngBounds|null 傳回這個矩形的界限。
getDraggable	getDraggable() 參數：無 傳回值：boolean 傳回使用者是否能拖曳這個矩形。
getEditable	getEditable() 參數：無 傳回值：boolean 傳回使用者是否能編輯這個矩形。
getMap	getMap() 參數：無 傳回值：Map|null 傳回顯示這個矩形的地圖。
getVisible	getVisible() 參數：無 傳回值：boolean 傳回是否要在地圖上顯示這個矩形。
setBounds	setBounds(bounds) 參數： bounds：LatLngBounds|LatLngBoundsLiteral optional 傳回值：無 設定這個矩形的界限。
setDraggable	setDraggable(draggable) 參數： draggable：boolean 傳回值：無 如果設為 true，使用者就可以在地圖上拖曳這個矩形。
setEditable	setEditable(editable) 參數： editable：boolean 傳回值：無 如果設為 true，使用者只要拖曳角落和各邊緣顯示的控制點，即可編輯這個矩形。
setMap	setMap(map) 參數： map：Map optional 傳回值：無 在指定的地圖上呈現矩形。如果將地圖設為 null，矩形就會遭到移除。
setOptions	setOptions(options) 參數： options：RectangleOptions 傳回值：無
setVisible	setVisible(visible) 參數： visible：boolean 傳回值：無 如果設為 false，系統會隱藏這個矩形。
繼承： addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll

事件
bounds_changed	function() 引數：無 當矩形的邊界變更時，會觸發此事件。
click	function(event) 引數： event：MapMouseEvent 當矩形觸發 DOM 點擊事件時，會觸發此事件。
contextmenu	function(event) 引數： event：MapMouseEvent 當矩形觸發 DOM 內容選單事件時，會觸發此事件。
dblclick	function(event) 引數： event：MapMouseEvent 當矩形引發 DOM dblclick 事件時，會觸發此事件。
drag	function(event) 引數： event：MapMouseEvent 這個事件會在使用者拖曳矩形時重複觸發。
dragend	function(event) 引數： event：MapMouseEvent 使用者停止拖曳矩形時，會引發此事件。
dragstart	function(event) 引數： event：MapMouseEvent 使用者開始拖曳矩形時，會引發此事件。
mousedown	function(event) 引數： event：MapMouseEvent 當矩形觸發 DOM 滑鼠關閉事件時，會觸發此事件。
mousemove	function(event) 引數： event：MapMouseEvent 當矩形觸發 DOM 滑鼠移動事件時，會觸發此事件。
mouseout	function(event) 引數： event：MapMouseEvent 此事件會在矩形滑鼠移開時觸發。
mouseover	function(event) 引數： event：MapMouseEvent 此事件會在矩形滑鼠懸停時觸發。
mouseup	function(event) 引數： event：MapMouseEvent 當矩形觸發 DOM 滑鼠向上事件時，會觸發此事件。
rightclick	已淘汰：請改用 Rectangle.contextmenu 事件，以支援使用 macOS 的 Control-click 等使用模式。 function(event) 引數： event：MapMouseEvent 以滑鼠右鍵按一下矩形時，會引發此事件。

RectangleOptions 介面

google.maps.RectangleOptions 介面

RectangleOptions 物件，用來定義可在 Rectangle 上設定的屬性。

屬性
bounds optional	類型：LatLngBounds|LatLngBoundsLiteral optional 界限。
clickable optional	類型：boolean optional 預設：true 指出此 Rectangle 是否處理滑鼠事件。
draggable optional	類型：boolean optional 預設：false 如果設為 true，使用者就可以在地圖上拖曳這個矩形。
editable optional	類型：boolean optional 預設：false 如果設為 true，使用者只要拖曳角落和各邊緣顯示的控制點，即可編輯這個矩形。
fillColor optional	類型：string optional 填色。除了延伸的具名色彩之外，也支援所有的 CSS3 色彩。
fillOpacity optional	類型：number optional 填滿透明度介於 0.0 和 1.0 之間
map optional	類型：Map optional 要顯示矩形的地圖。
strokeColor optional	類型：string optional 筆觸色彩。除了延伸的具名色彩之外，也支援所有的 CSS3 色彩。
strokeOpacity optional	類型：number optional 筆觸透明度介於 0.0 和 1.0 之間
strokePosition optional	類型：StrokePosition optional 預設：StrokePosition.CENTER 筆劃位置。
strokeWeight optional	類型：number optional 筆觸寬度 (以像素為單位)。
visible optional	類型：boolean optional 預設：true 此矩形是否顯示在地圖上。
zIndex optional	類型：number optional 和其他多邊形比較的 zIndex。

Circle 類別

google.maps.Circle 類別

地表上的圓形，又稱為「球帽」。

此類別會擴充 MVCObject。

建構函式
Circle	Circle([circleOrCircleOptions]) 參數： circleOrCircleOptions：Circle|CircleLiteral|CircleOptions optional 使用傳送的 CircleOptions 建立圓形，指定中心、半徑和樣式。

方法
getBounds	getBounds() 參數：無 傳回值：LatLngBounds|null 取得這個圓形的LatLngBounds。
getCenter	getCenter() 參數：無 傳回值：LatLng 傳回這個圓形的中心。
getDraggable	getDraggable() 參數：無 傳回值：boolean 傳回使用者是否能拖曳這個圓形。
getEditable	getEditable() 參數：無 傳回值：boolean 傳回使用者是否能編輯這個社交圈。
getMap	getMap() 參數：無 傳回值：Map|null 傳回顯示這個圓形的地圖。
getRadius	getRadius() 參數：無 傳回值：number 傳回這個圓形的半徑 (單位為公尺)。
getVisible	getVisible() 參數：無 傳回值：boolean 傳回是否要在地圖上顯示這個圓形。
setCenter	setCenter(center) 參數： center：LatLng|LatLngLiteral 傳回值：無 設定這個圓形的中心。
setDraggable	setDraggable(draggable) 參數： draggable：boolean 傳回值：無 如果設為 true，使用者就能將這個圓圈拖曳到地圖上。
setEditable	setEditable(editable) 參數： editable：boolean 傳回值：無 設為 true 後，使用者只要拖曳中央及周圍的控制點，即可編輯這個圓形。
setMap	setMap(map) 參數： map：Map optional 傳回值：無 在指定的地圖上呈現圓形。如果將地圖設為 null，社交圈將遭到移除。
setOptions	setOptions(options) 參數： options：CircleOptions 傳回值：無
setRadius	setRadius(radius) 參數： radius：number 傳回值：無 設定這個圓形的半徑 (單位為公尺)。
setVisible	setVisible(visible) 參數： visible：boolean 傳回值：無 如果設為 false，系統會隱藏這個社交圈。
繼承： addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll

事件
center_changed	function() 引數：無 當圓形的中心變更時，即會觸發此事件。
click	function(event) 引數： event：MapMouseEvent 當圓形的 DOM 點擊事件觸發時，會觸發此事件。
dblclick	function(event) 引數： event：MapMouseEvent 當圓形的 DOM dblclick 事件觸發時，會觸發此事件。
drag	function(event) 引數： event：MapMouseEvent 這個事件會在使用者拖曳圓圈時重複觸發。
dragend	function(event) 引數： event：MapMouseEvent 使用者停止拖曳圓圈時，會觸發此事件。
dragstart	function(event) 引數： event：MapMouseEvent 使用者開始拖曳圓圈時，就會觸發這個事件。
mousedown	function(event) 引數： event：MapMouseEvent 當圓形觸發 DOM 滑鼠關閉事件時，會觸發此事件。
mousemove	function(event) 引數： event：MapMouseEvent 當圓形觸發 DOM 滑鼠移動事件時，會觸發此事件。
mouseout	function(event) 引數： event：MapMouseEvent 這個事件會在圈外的滑鼠遊標離開時觸發。
mouseover	function(event) 引數： event：MapMouseEvent 這個事件會在圓形滑鼠遊標懸停時觸發。
mouseup	function(event) 引數： event：MapMouseEvent 當圓形上發生 DOM 滑鼠向上事件時，會觸發此事件。
radius_changed	function() 引數：無 當圓形的半徑變更時，會觸發此事件。
rightclick	function(event) 引數： event：MapMouseEvent 以滑鼠右鍵按一下圓形時，會觸發此事件。

CircleOptions 介面

google.maps.CircleOptions 介面

CircleOptions 物件，用來定義可在圓形上設定的屬性。

屬性
center optional	類型：LatLng|LatLngLiteral optional 圓圈的中心。
clickable optional	類型：boolean optional 預設：true 指出此 Circle 是否處理滑鼠事件。
draggable optional	類型：boolean optional 預設：false 如果設為 true，使用者就能將這個圓圈拖曳到地圖上。
editable optional	類型：boolean optional 預設：false 設為 true 後，使用者只要拖曳中央及周圍的控制點，即可編輯這個圓形。
fillColor optional	類型：string optional 填色。除了延伸的具名色彩之外，也支援所有的 CSS3 色彩。
fillOpacity optional	類型：number optional 填滿透明度介於 0.0 和 1.0 之間。
map optional	類型：Map optional 要顯示圓形的地圖。
radius optional	類型：number optional 地球表面的半徑 (單位為公尺)。
strokeColor optional	類型：string optional 筆觸色彩。除了延伸的具名色彩之外，也支援所有的 CSS3 色彩。
strokeOpacity optional	類型：number optional 筆觸透明度介於 0.0 和 1.0 之間。
strokePosition optional	類型：StrokePosition optional 預設：StrokePosition.CENTER 筆劃位置。
strokeWeight optional	類型：number optional 筆觸寬度 (以像素為單位)。
visible optional	類型：boolean optional 預設：true 是否要在地圖上顯示這個圓形。
zIndex optional	類型：number optional 和其他多邊形比較的 zIndex。

StrokePosition 常數

google.maps.StrokePosition 常數

多邊形在多邊形上的可能位置。

常數
CENTER	筆劃的多邊形以多邊形的路徑為中心，中間有一半的筆劃是多邊形的一半，而筆劃則是多邊形外的一半。
INSIDE	筆劃在多邊形內。
OUTSIDE	筆劃位於多邊形外。