Polygons

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Polyline 類別

google.maps.Polyline 類別

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

此類別會擴充 MVCObject

Polyline
Polyline([opts])
參數:
使用傳送的 PolylineOptions 建立折線,以指定在繪製折線時要使用的折線路徑和筆劃樣式。建立折線時,您可以傳遞 LatLng 陣列或 LatLngMVCArray,但在執行個體化時,簡易陣列會轉換成折線內的 MVCArray
getDraggable
getDraggable()
參數:
傳回值:boolean
傳回使用者是否可以拖曳此形狀。
getEditable
getEditable()
參數:
傳回值:boolean
傳回使用者是否能編輯這個形狀。
getMap
getMap()
參數:
傳回值:Map|null
傳回附加此形狀的地圖。
getPath
getPath()
參數:
傳回值:MVCArray<LatLng>
擷取路徑。
getVisible
getVisible()
參數:
傳回值:boolean
傳回是否要在地圖上顯示這個折線。
setDraggable
setDraggable(draggable)
參數:
  • draggableboolean
傳回值:
如果設為 true,使用者就可以將這個形狀拖曳到地圖上。geodesic 屬性可定義拖曳模式。
setEditable
setEditable(editable)
參數:
  • editableboolean
傳回值:
如果設為 true,使用者只要拖曳頂點和每個片段所顯示的控制點,即可編輯這個形狀。
setMap
setMap(map)
參數:
  • mapMap optional
傳回值:
在指定的地圖上顯示這個形狀。如果將地圖設為 null,系統將移除形狀。
setOptions
setOptions(options)
參數:
傳回值:
setPath
setPath(path)
參數:
傳回值:
設定路徑。如需詳細資訊,請參閱 PolylineOptions
setVisible
setVisible(visible)
參數:
  • visibleboolean
傳回值:
如果設為 false,系統會隱藏這個折線。
繼承: addListenerbindTogetnotifysetsetValuesunbindunbindAll
click
function(event)
引數:
折線引發 DOM click 事件時,會引發此事件。
contextmenu
function(event)
引數:
當 Poyline 觸發 DOM 內容選單事件時,會觸發此事件。
dblclick
function(event)
引數:
折線引發 DOM dblclick 事件時,會引發此事件。
drag
function(event)
引數:
使用者拖曳折線時,會重複觸發這個事件。
dragend
function(event)
引數:
使用者停止拖曳折線時,會引發此事件。
dragstart
function(event)
引數:
使用者開始拖曳折線時,會引發此事件。
mousedown
function(event)
引數:
折線引發 DOM mousedown 事件時,會引發此事件。
mousemove
function(event)
引數:
折線引發 DOM mousemove 事件時,會引發此事件。
mouseout
function(event)
引數:
折線 mouseout 會引發此事件。
mouseover
function(event)
引數:
折線 mouseover 會引發此事件。
mouseup
function(event)
引數:
折線引發 DOM mouseup 事件時,會引發此事件。
rightclick
function(event)
引數:
以滑鼠右鍵按一下折線時,會引發此事件。

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 的簡單陣列或 LatLngMVCArray 來指定這個路徑。請注意,如果您傳送的是簡單陣列,系統會將該陣列轉換為 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])
參數:
使用傳送的 PolygonOptions 建立多邊形,指定多邊形的路徑、多邊形邊緣的筆劃樣式,以及多邊形內部區域的填滿樣式。多邊形可能包含一或多個路徑,其中每個路徑都是由 LatLng 所組成的陣列。您可以在建構這些路徑時,傳送 LatLng 陣列或 LatLngMVCArray。陣列化時,陣列會轉換成多邊形內的 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)
參數:
  • draggableboolean
傳回值:
如果設為 true,使用者就可以將這個形狀拖曳到地圖上。geodesic 屬性可定義拖曳模式。
setEditable
setEditable(editable)
參數:
  • editableboolean
傳回值:
如果設為 true,使用者只要拖曳頂點和每個片段所顯示的控制點,即可編輯這個形狀。
setMap
setMap(map)
參數:
  • mapMap optional
傳回值:
在指定的地圖上顯示這個形狀。如果將地圖設為 null,系統將移除形狀。
setOptions
setOptions(options)
參數:
傳回值:
setPath
setPath(path)
參數:
傳回值:
設定第一個路徑。如需詳細資訊,請參閱 PolygonOptions
setPaths
setPaths(paths)
參數:
傳回值:
設定此多邊形的路徑。
setVisible
setVisible(visible)
參數:
  • visibleboolean
傳回值:
如果設為 false,系統會隱藏這個折線。
繼承: addListenerbindTogetnotifysetsetValuesunbindunbindAll
click
function(event)
引數:
多邊形引發 DOM click 事件時,會引發此事件。
contextmenu
function(event)
引數:
當多邊形疊加層的 DOM 內容選單事件啟動時,會觸發此事件。
dblclick
function(event)
引數:
多邊形引發 DOM dblclick 事件時,會引發此事件。
drag
function(event)
引數:
使用者拖曳多邊形時,會重複觸發此事件。
dragend
function(event)
引數:
使用者停止拖曳多邊形時,會觸發此事件。
dragstart
function(event)
引數:
使用者開始拖曳多邊形時,會引發此事件。
mousedown
function(event)
引數:
多邊形引發 DOM mousedown 事件時,會引發此事件。
mousemove
function(event)
引數:
多邊形引發 DOM mousemove 事件時,會引發此事件。
mouseout
function(event)
引數:
多邊形 mouseout 會引發此事件。
mouseover
function(event)
引數:
多邊形 mouseover 會引發此事件。
mouseup
function(event)
引數:
多邊形引發 DOM mouseup 事件時,會引發此事件。
rightclick
function(event)
引數:
以滑鼠右鍵按一下多邊形時,會引發此事件。

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
筆劃位置。
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
繼承: domEventlatLng
繼承: stop

Rectangle 類別

google.maps.Rectangle 類別

矩形疊加層。

此類別會擴充 MVCObject

Rectangle
Rectangle([opts])
參數:
使用傳送的 RectangleOptions 建立矩形,藉此指定邊界和樣式。
getBounds
getBounds()
參數:
傳回值:LatLngBounds
傳回這個矩形的界限。
getDraggable
getDraggable()
參數:
傳回值:boolean
傳回使用者是否能拖曳這個矩形。
getEditable
getEditable()
參數:
傳回值:boolean
傳回使用者是否能編輯這個矩形。
getMap
getMap()
參數:
傳回值:Map
傳回顯示這個矩形的地圖。
getVisible
getVisible()
參數:
傳回值:boolean
傳回是否要在地圖上顯示這個矩形。
setBounds
setBounds(bounds)
參數:
傳回值:
設定這個矩形的界限。
setDraggable
setDraggable(draggable)
參數:
  • draggableboolean
傳回值:
如果設為 true,使用者就可以在地圖上拖曳這個矩形。
setEditable
setEditable(editable)
參數:
  • editableboolean
傳回值:
如果設為 true,使用者只要拖曳角落和各邊緣顯示的控制點,即可編輯這個矩形。
setMap
setMap(map)
參數:
傳回值:
在指定的地圖上呈現矩形。如果將地圖設為 null,矩形就會遭到移除。
setOptions
setOptions(options)
參數:
傳回值:
setVisible
setVisible(visible)
參數:
  • visibleboolean
傳回值:
如果設為 false,系統會隱藏這個矩形。
繼承: addListenerbindTogetnotifysetsetValuesunbindunbindAll
bounds_changed
function()
引數:
當矩形的邊界變更時,會觸發此事件。
click
function(event)
引數:
當矩形觸發 DOM 點擊事件時,會觸發此事件。
contextmenu
function(event)
引數:
當矩形觸發 DOM 內容選單事件時,會觸發此事件。
dblclick
function(event)
引數:
當矩形引發 DOM dblclick 事件時,會觸發此事件。
drag
function(event)
引數:
這個事件會在使用者拖曳矩形時重複觸發。
dragend
function(event)
引數:
使用者停止拖曳矩形時,會引發此事件。
dragstart
function(event)
引數:
使用者開始拖曳矩形時,會引發此事件。
mousedown
function(event)
引數:
當矩形觸發 DOM 滑鼠關閉事件時,會觸發此事件。
mousemove
function(event)
引數:
當矩形觸發 DOM 滑鼠移動事件時,會觸發此事件。
mouseout
function(event)
引數:
此事件會在矩形滑鼠移開時觸發。
mouseover
function(event)
引數:
此事件會在矩形滑鼠懸停時觸發。
mouseup
function(event)
引數:
當矩形觸發 DOM 滑鼠向上事件時,會觸發此事件。
rightclick
function(event)
引數:
以滑鼠右鍵按一下矩形時,會引發此事件。

RectangleOptions 介面

google.maps.RectangleOptions 介面

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

bounds 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
筆劃位置。
strokeWeight optional
類型:number optional
筆觸寬度 (以像素為單位)。
visible optional
類型:boolean optional
預設:true
此矩形是否顯示在地圖上。
zIndex optional
類型:number optional
和其他多邊形比較的 zIndex。

Circle 類別

google.maps.Circle 類別

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

此類別會擴充 MVCObject

Circle
Circle([circleOrCircleOptions])
參數:
使用傳送的 CircleOptions 建立圓形,指定中心、半徑和樣式。
getBounds
getBounds()
參數:
傳回值:LatLngBounds
取得這個圓形的LatLngBounds
getCenter
getCenter()
參數:
傳回值:LatLng
傳回這個圓形的中心。
getDraggable
getDraggable()
參數:
傳回值:boolean
傳回使用者是否能拖曳這個圓形。
getEditable
getEditable()
參數:
傳回值:boolean
傳回使用者是否能編輯這個社交圈。
getMap
getMap()
參數:
傳回值:Map
傳回顯示這個圓形的地圖。
getRadius
getRadius()
參數:
傳回值:number
傳回這個圓形的半徑 (單位為公尺)。
getVisible
getVisible()
參數:
傳回值:boolean
傳回是否要在地圖上顯示這個圓形。
setCenter
setCenter(center)
參數:
傳回值:
設定這個圓形的中心。
setDraggable
setDraggable(draggable)
參數:
  • draggableboolean
傳回值:
如果設為 true,使用者就能將這個圓圈拖曳到地圖上。
setEditable
setEditable(editable)
參數:
  • editableboolean
傳回值:
設為 true 後,使用者只要拖曳中央及周圍的控制點,即可編輯這個圓形。
setMap
setMap(map)
參數:
傳回值:
在指定的地圖上呈現圓形。如果將地圖設為 null,社交圈將遭到移除。
setOptions
setOptions(options)
參數:
傳回值:
setRadius
setRadius(radius)
參數:
  • radiusnumber
傳回值:
設定這個圓形的半徑 (單位為公尺)。
setVisible
setVisible(visible)
參數:
  • visibleboolean
傳回值:
如果設為 false,系統會隱藏這個社交圈。
繼承: addListenerbindTogetnotifysetsetValuesunbindunbindAll
center_changed
function()
引數:
當圓形的中心變更時,即會觸發此事件。
click
function(event)
引數:
當圓形的 DOM 點擊事件觸發時,會觸發此事件。
dblclick
function(event)
引數:
當圓形的 DOM dblclick 事件觸發時,會觸發此事件。
drag
function(event)
引數:
這個事件會在使用者拖曳圓圈時重複觸發。
dragend
function(event)
引數:
使用者停止拖曳圓圈時,會觸發此事件。
dragstart
function(event)
引數:
使用者開始拖曳圓圈時,就會觸發這個事件。
mousedown
function(event)
引數:
當圓形觸發 DOM 滑鼠關閉事件時,會觸發此事件。
mousemove
function(event)
引數:
當圓形觸發 DOM 滑鼠移動事件時,會觸發此事件。
mouseout
function(event)
引數:
這個事件會在圈外的滑鼠遊標離開時觸發。
mouseover
function(event)
引數:
這個事件會在圓形滑鼠遊標懸停時觸發。
mouseup
function(event)
引數:
當圓形上發生 DOM 滑鼠向上事件時,會觸發此事件。
radius_changed
function()
引數:
當圓形的半徑變更時,會觸發此事件。
rightclick
function(event)
引數:
以滑鼠右鍵按一下圓形時,會觸發此事件。

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
筆劃位置。
strokeWeight optional
類型:number optional
筆觸寬度 (以像素為單位)。
visible optional
類型:boolean optional
預設:true
是否要在地圖上顯示這個圓形。
zIndex optional
類型:number optional
和其他多邊形比較的 zIndex。

StrokePosition 常數

google.maps.StrokePosition 常數

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

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