Polyline 類別
google.maps.Polyline
類別
折線是地圖上連接線段的線性疊加層。
這個類別會擴充 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) 引數:
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 事件時,會引發此事件。 |
|
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 內的經緯度,並自動更新地圖上的折線。 |
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 的陣列。建構這些路徑時,您可以傳遞經緯度陣列或 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 內容選單事件時,就會觸發這個事件。 |
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 指定閉合迴圈的座標順序。和折線不同,多邊形可能包含一種以上的路徑。因此,路徑屬性可指定一或多個 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 點擊事件時,會觸發此事件。 |
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 事件時,會觸發此事件。 |
|
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) 參數:
傳回值:無
如果設為 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 點擊事件,就會觸發這個事件。 |
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 |
筆觸來自多邊形外。 |