Polyline class
google.maps.Polyline
class
折線是地圖上連接線段的線性疊加層。
這個類別會擴充 MVCObject。
撥打 const {Polyline} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
Polyline |
Polyline([opts])參數：
使用傳遞的 PolylineOptions 建立折線，指定折線路徑和繪製折線時使用的筆劃樣式。建構折線時，您可以傳遞 LatLng 陣列或 LatLng 的 MVCArray，但簡單陣列會在例項化時轉換為折線內的 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)引數：
在 Polyline 上觸發 DOM contextmenu 事件時，會觸發這個事件。 |
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 物件，用於定義可在 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 中插入或移除 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 interface
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 class
google.maps.Polygon
class
多邊形 (與折線類似) 會定義一系列依序排列的相連座標。此外，多邊形會形成封閉迴圈，並定義填滿的區域。請參閱開發人員指南中的範例，從簡單多邊形和有洞的多邊形開始，瞭解更多資訊。請注意，您也可以使用資料層建立多邊形。資料層可為您處理內部和外部路徑的順序，方便建立孔洞。
這個類別會擴充 MVCObject。
撥打 const {Polygon} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
Polygon |
Polygon([opts])參數：
使用傳遞的 PolygonOptions 建立多邊形，指定多邊形的路徑、多邊形邊緣的筆劃樣式，以及多邊形內部區域的填滿樣式。多邊形可能包含一或多條路徑，每條路徑都由 LatLng 陣列組成。建構這些路徑時，您可以傳遞 LatLng 陣列或 MVCArray 的 LatLng。在多邊形內例項化時，陣列會轉換為 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)引數：
當 Polygon 觸發 DOM contextmenu 事件時，就會觸發這個事件。 |
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 物件，用於定義可在多邊形上設定的屬性。
屬性 | |
|---|---|
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指定閉合迴圈的座標順序。和折線不同，多邊形可能包含一種以上的路徑。因此，paths 屬性可能會指定一或多個 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
|