Polygons

Polyline 類別

google.maps.Polyline 類別

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

這個類別會擴充 MVCObject

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

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)
引數: 
DOM 內容選單事件會在 Poyline 上觸發時,就會觸發這個事件。
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 物件。

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%」) 或像素 (例如「50 像素」) 表示。
repeat optional
類型:  string optional
預設值: 0
線條連續圖示之間的距離。這段距離可以使用線條長度的百分比 (例如「50%」) 或像素 (例如「50 像素」) 表示。如要停止重複顯示圖示,請將這個屬性指定為「0」。

Polygon 類別

google.maps.Polygon 類別

多邊形 (例如折線) 會依序定義一系列連接的座標。此外,多邊形會形成封閉式迴圈,並定義實心區域。請參閱開發人員指南中的範例,首先以簡易多邊形有孔的多邊形等功能。請注意,您也可以使用資料層建立多邊形。資料層可以更精簡地建立孔,因為它會為您處理內部和外部路徑的順序。

這個類別會擴充 MVCObject

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

Polygon
Polygon([opts])
參數: 
使用傳送的 PolygonOptions 建立多邊形,以指定多邊形的路徑、多邊形邊緣的筆劃樣式,以及多邊形內部區域的填滿樣式。多邊形可能包含一或多個路徑,而每個路徑都包含 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
指定閉合迴圈的座標順序。和折線不同,多邊形可能包含一種以上的路徑。因此,路徑屬性可指定一或多個 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

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

Rectangle
Rectangle([opts])
參數: 
使用傳遞的 RectangleOptions 建立矩形,以指定邊界和樣式。
getBounds
getBounds()
參數:
傳回價值:  LatLngBounds|null
傳回這個矩形的界限。
getDraggable
getDraggable()
參數:
傳回價值:  boolean
傳回使用者是否能拖曳這個矩形。
getEditable
getEditable()
參數:
傳回價值:  boolean
傳回使用者是否可以編輯這個矩形。
getMap
getMap()
參數:
傳回價值:  Map|null
傳回顯示這個矩形的地圖。
getVisible
getVisible()
參數:
傳回價值:  boolean
傳回這個矩形是否在地圖上顯示。
setBounds
setBounds(bounds)
參數: 
傳回值:
設定這個矩形的界限。
setDraggable
setDraggable(draggable)
參數: 
  • draggableboolean
傳回值:
如果設為 true,使用者就可以將矩形拖曳到地圖上。
setEditable
setEditable(editable)
參數: 
  • editableboolean
傳回值:
如果設為 true,使用者可以拖曳角落和邊緣兩邊顯示的控制點,編輯這個矩形。
setMap
setMap(map)
參數: 
  • mapMap optional
傳回值:
在指定的地圖上呈現矩形。如果地圖設為 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 mousedown 事件時,就會觸發這個事件。
mousemove
function(event)
引數: 
矩形觸發 DOM 移動事件時,會觸發這個事件。
mouseout
function(event)
引數: 
矩形懸停時,會觸發此事件。
mouseover
function(event)
引數: 
滑鼠懸停時引發這個事件。
mouseup
function(event)
引數: 
矩形引發 DOM mouseup 事件時,會觸發此事件。
rightclick
function(event)
引數: 
在矩形按一下滑鼠右鍵時,會觸發這個事件。

RectangleOptions 介面

google.maps.RectangleOptions 介面

用於定義可在矩形上使用的屬性的 RectangleOptions 物件。

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

Circle 類別

google.maps.Circle 類別

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

這個類別會擴充 MVCObject

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

Circle
Circle([circleOrCircleOptions])
參數: 
使用傳遞的 CircleOptions 建立圓形,以指定中心、半徑和樣式。
getBounds
getBounds()
參數:
傳回價值:  LatLngBounds|null
取得這個圓形的 LatLngBounds
getCenter
getCenter()
參數:
傳回價值:  LatLng|null
傳回這個圓形的中心。
getDraggable
getDraggable()
參數:
傳回價值:  boolean
傳回使用者是否能拖曳這個圓圈。
getEditable
getEditable()
參數:
傳回價值:  boolean
傳回使用者是否可以編輯這個圓形。
getMap
getMap()
參數:
傳回價值:  Map|null
傳回顯示這個圓形的地圖。
getRadius
getRadius()
參數:
傳回價值:  number
傳回這個圓形的半徑 (單位為公尺)。
getVisible
getVisible()
參數:
傳回價值:  boolean
傳回這個圓形是否在地圖上顯示。
setCenter
setCenter(center)
參數: 
傳回值:
設定這個圓形的中心。
setDraggable
setDraggable(draggable)
參數: 
  • draggableboolean
傳回值:
如果設為 true,使用者就可以拖曳這個圓形在地圖上。
setEditable
setEditable(editable)
參數: 
  • editableboolean
傳回值:
如果設為 true,使用者只要拖曳中心中心顯示的控制項點或圓形圍繞的端點,即可編輯這個圓形。
setMap
setMap(map)
參數: 
  • mapMap optional
傳回值:
在指定的地圖上呈現圓形。如果地圖設為 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 mouseup 事件時,會觸發此事件。
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 常數

多邊形的筆劃可能性。

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

CENTER 筆劃會以多邊形路徑為中心,在多邊形內部有一半的筆觸,多邊形外半部的筆劃。
INSIDE 筆觸位於多邊形內。
OUTSIDE 筆觸來自多邊形外。