Polyline 類別
google.maps.Polyline
類別
折線是地圖上連接線段的線性疊加層。
這個類別會擴充 MVCObject
。
呼叫 const {Polyline} = await google.maps.importLibrary("maps")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
建構函式 | |
---|---|
Polyline |
Polyline([opts]) 參數:
使用傳送的 PolylineOptions 建立折線,可同時指定繪製折線時要使用的折線路徑和筆劃樣式。雖然系統會在執行個體化時,將折線中的簡單陣列轉換為 MVCArray ,但您可以在建構折線時,傳遞 LatLng 的陣列或 LatLng 的 MVCArray 。 |
方法 | |
---|---|
getDraggable |
getDraggable() 參數:無
傳回值:
boolean 傳回是否可由使用者拖曳此形狀。 |
getEditable |
getEditable() 參數:無
傳回值:
boolean 傳回是否可由使用者編輯此形狀。 |
getMap |
getMap() 參數:無
傳回值:
Map|null 傳回附加此形狀的地圖。 |
getPath |
getPath() 參數:無
擷取路徑。 |
getVisible |
getVisible() 參數:無
傳回值:
boolean 傳回是否要在地圖上顯示此折線。 |
setDraggable |
setDraggable(draggable) 參數:
傳回值:無
如果設為 true ,使用者就能將這個形狀拖曳到地圖上。geodesic 屬性會定義拖曳模式。 |
setEditable |
setEditable(editable) 參數:
傳回值:無
如果設為 true ,使用者就能拖曳頂點和每個路段顯示的控制點,藉此編輯這個形狀。 |
setMap |
setMap(map) 參數:
傳回值:無
在指定的地圖上呈現此形狀。如果地圖設為 null ,系統就會移除形狀。 |
setOptions |
setOptions(options) 參數:
傳回值:無
|
setPath |
setPath(path) 參數:
傳回值:無
設定路徑。詳情請參閱 PolylineOptions 。 |
setVisible |
setVisible(visible) 參數:
傳回值:無
如果設為 false ,則會隱藏此折線。 |
沿用:
addListener 、bindTo 、get 、notify 、set 、setValues 、unbind 、unbindAll
|
活動 | |
---|---|
click |
function(event) 引數:
折線引發 DOM click 事件時,會引發此事件。 |
contextmenu |
function(event) 引數:
在 Poyline 上引發 DOM contentmenu 事件時,會引發此事件。 |
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 事件時,會引發此事件。 |
|
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 的簡易陣列或 LatLng 的 MVCArray 來指定這個路徑。請注意,如果您傳遞簡易陣列,該陣列會轉換成 MVCArray 在 MVCArray 中插入或移除 LatLng ,並自動更新地圖上的折線。 |
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
。
呼叫 const {Polygon} = await google.maps.importLibrary("maps")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
建構函式 | |
---|---|
Polygon |
Polygon([opts]) 參數:
使用傳送的 PolygonOptions 建立多邊形,這樣會指定多邊形的路徑、多邊形邊緣的筆劃樣式,以及多邊形內部區域的填滿樣式。多邊形可能包含一或多個路徑,每個路徑都是由 LatLng 陣列組成。建構這些路徑時,您可以傳遞 LatLng 陣列或 LatLng 的 MVCArray 。執行個體化時,多邊形內的陣列會轉換為 MVCArray 。 |
方法 | |
---|---|
getDraggable |
getDraggable() 參數:無
傳回值:
boolean 傳回是否可由使用者拖曳此形狀。 |
getEditable |
getEditable() 參數:無
傳回值:
boolean 傳回是否可由使用者編輯此形狀。 |
getMap |
getMap() 參數:無
傳回值:
Map|null 傳回附加此形狀的地圖。 |
getPath |
getPath() 參數:無
擷取第一個路徑。 |
getPaths |
getPaths() 參數:無
擷取這個多邊形的路徑。 |
getVisible |
getVisible() 參數:無
傳回值:
boolean 傳回是否要在地圖上顯示此折線。 |
setDraggable |
setDraggable(draggable) 參數:
傳回值:無
如果設為 true ,使用者就能將這個形狀拖曳到地圖上。geodesic 屬性會定義拖曳模式。 |
setEditable |
setEditable(editable) 參數:
傳回值:無
如果設為 true ,使用者就能拖曳頂點和每個路段顯示的控制點,藉此編輯這個形狀。 |
setMap |
setMap(map) 參數:
傳回值:無
在指定的地圖上呈現此形狀。如果地圖設為 null ,系統就會移除形狀。 |
setOptions |
setOptions(options) 參數:
傳回值:無
|
setPath |
setPath(path) 參數:
傳回值:無
設定第一個路徑。詳情請參閱 PolygonOptions 。 |
setPaths |
setPaths(paths) 參數:
傳回值:無
設定這個多邊形的路徑。 |
setVisible |
setVisible(visible) 參數:
傳回值:無
如果設為 false ,則會隱藏此折線。 |
沿用:
addListener 、bindTo 、get 、notify 、set 、setValues 、unbind 、unbindAll
|
活動 | |
---|---|
click |
function(event) 引數:
多邊形引發 DOM click 事件時,會引發此事件。 |
contextmenu |
function(event) 引數:
多邊形引發 DOM contentmenu 事件時,會引發此事件。 |
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 事件時,會引發此事件。 |
|
function(event) 引數:
以滑鼠右鍵按一下多邊形時,會引發此事件。 |
PolygonOptions 介面
google.maps.PolygonOptions
介面
PolygonOptions 物件用於定義可在 Polygon 上設定的屬性。
屬性 | |
---|---|
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 。 |
沿用:
domEvent 、latLng
|
方法 | |
---|---|
沿用:
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) 參數:
傳回值:無
如果設為 true ,使用者就能將這個矩形拖曳到地圖上。 |
setEditable |
setEditable(editable) 參數:
傳回值:無
如果設為 true ,使用者就能拖曳顯示在角落和每一邊的控制點,藉此編輯這個矩形。 |
setMap |
setMap(map) 參數:
傳回值:無
在指定的地圖上呈現矩形。如果地圖設為 null ,系統就會移除矩形。 |
setOptions |
setOptions(options) 參數:
傳回值:無
|
setVisible |
setVisible(visible) 參數:
傳回值:無
如果設為 false ,則隱藏這個矩形。 |
沿用:
addListener 、bindTo 、get 、notify 、set 、setValues 、unbind 、unbindAll
|
活動 | |
---|---|
bounds_changed |
function() 引數:無
當矩形的邊界變更時,會引發此事件。 |
click |
function(event) 引數:
矩形引發 DOM click 事件時,會引發此事件。 |
contextmenu |
function(event) 引數:
矩形引發 DOM contentmenu 事件時,會引發此事件。 |
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) 引數:
矩形滑鼠遊標懸停時,會引發此事件。 |
mouseup |
function(event) 引數:
矩形引發 DOM mouseup 事件時,會引發此事件。 |
|
function(event) 引數:
以滑鼠右鍵按一下矩形時,會引發此事件。 |
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 筆觸位置。 |
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) 參數:
傳回值:無
如果設為 true ,使用者就能將這個圓形拖曳到地圖上。 |
setEditable |
setEditable(editable) 參數:
傳回值:無
如果設為 true ,使用者就能拖曳中央和圓週處顯示的控制點,編輯這個圓形。 |
setMap |
setMap(map) 參數:
傳回值:無
在指定的地圖上呈現圓形。如果地圖設為 null ,系統就會移除圓形。 |
setOptions |
setOptions(options) 參數:
傳回值:無
|
setRadius |
setRadius(radius) 參數:
傳回值:無
設定這個圓形的半徑 (單位為公尺)。 |
setVisible |
setVisible(visible) 參數:
傳回值:無
如果設為 false ,隱藏這個社交圈。 |
沿用:
addListener 、bindTo 、get 、notify 、set 、setValues 、unbind 、unbindAll
|
活動 | |
---|---|
center_changed |
function() 引數:無
圓形的中心變更時,會引發此事件。 |
click |
function(event) 引數:
圓形引發 DOM click 事件時,會引發此事件。 |
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) 引數:
圓形滑鼠遊標懸停時,會引發此事件。 |
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 |
筆觸位於多邊形外。 |