控制器
電子地圖上可添加的控制器
互相衝突的控制器
因部分控制器的功能會互相影響，因此在添加下列控制器時，會自動移除與其衝突的控制器，避免共存造成問題，其餘的控制器皆可同時添加至地圖中。
| 控制器 | 受影響的控制器 |
|---|---|
| DrawControl | MeasureControl、RouteNavControl |
| MeasureControl | DrawControl、RouteNavControl |
| RouteNavControl | DrawControl、MeasureControl |
| StyleModeControl | TrafficFlowControl |
| TrafficFlowControl | StyleModeControl |
範例：
使用方法
addControl
map.addControl(control, position)
新增地圖的控制器
參數：
- control
Object: 地圖控制器，可添加Popup、Marker、TerrainControl等控制器。 - position
string(預設: "top-right"): 控制器位置，可設定'top-left'、'top-right'、'bottom-left'、'bottom-right'，預設為'top-right'。
範例：
removeControl
map.removeControl(control)
移除地圖的控制器
參數：
- control
Object: 要移除的控制器。
範例：
removeAllControl
map.removeAllControl()
移除地圖的全部控制器
範例：
AttributionControl
new mapPlus.AttributionControl(options)
顯示地圖的資訊。
參數：
- options
Object:
| 名稱 | 描述 |
|---|---|
options.compact boolean | 是否有收合功能，預設為false。 |
options.customAttribution string | 帶入自定義文字的附加資訊。 |
範例：
DrawControl
new mapPlus.DrawControl(options)
地圖繪圖功能。
參數：
- options
Object:
| 名稱 | 描述 |
|---|---|
options.useButton boolean | 是否顯示預設繪圖控制器按鈕，預設為 true。 |
options.continuousDrawing boolean | 是否啟用連續繪圖模式，此模式可連續繪製多個幾何圖形，直至取消目前按鈕的 active 狀態或切換至其他幾何圖形為止，預設為 false。 |
options.showMeasureValue boolean | 是否顯示測量值（長度/面積），預設為 false。 |
options.enableCustomButtonManagement boolean | 是否使用自訂按鈕來實現繪圖功能，並統一控制自訂按鈕的 active 狀態，預設為 false。 |
注意： 在自訂按鈕上，須根據所需功能分別賦予指定的id（custom-point、custom-line、custom-polygon、custom-circle、custom-select、custom-clear），自訂按鈕的功能才會被啟用，詳情參考範例繪圖控制指令。
範例：
實例方法：
getAll
getAll()
取得所有繪製的 GeoJSON。
範例：
startDrawPoint
startDrawPoint()
開始繪製點幾何圖形。
範例：
startDrawLine
startDrawLine()
開始繪製線幾何圖形。
範例：
startDrawPolygon
startDrawPolygon()
開始繪製面幾何圖形。
範例：
startDrawCircle
startDrawCircle()
開始繪製圓幾何圖形。
範例：
stopDraw
stopDraw()
停止繪製幾何圖形，並切換到選擇模式。
範例：
clearAll
clearAll()
清除所有已繪製的幾何圖形。
範例：
FullscreenControl
new mapPlus.FullscreenControl(options)
全螢幕功能。
參數：
- options
Object:
| 名稱 | 描述 |
|---|---|
options.container HTMLElement | 要顯示全螢幕的容器。 |
範例：
MassTransitControl
new mapPlus.MassTransitControl(options)
控制大眾運輸顯示或隱藏。
參數：
- options
Object:
| 名稱 | 描述 |
|---|---|
options.useButton boolean | 是否使用按鈕控制大眾運輸顯示/隱藏。 |
範例：
實例方法：
offTransit
offTransit(transit)
隱藏指定大眾運輸。
參數：
- transit
string: 要隱藏的大眾運輸，捷運路線為mrt、火車路線為train。
範例：
onTransit
onTransit(transit)
顯示指定大眾運輸。
參數：
- transit
string: 要顯示的大眾運輸，捷運路線為mrt、火車路線為train。
範例：
MeasureControl
new mapPlus.MeasureControl(options)
地圖測距功能。
參數：
- options
Object:
| 名稱 | 描述 |
|---|---|
options.units boolean | 使用單位，可設定為 metric（公制）、imperial（英制），預設為 metric。 |
範例：
NavigationControl
new mapPlus.NavigationControl()
導航功能。
範例：
RouteNavControl
new mapPlus.RouteNavControl(options)
地圖導航功能。
參數：
- options
Object:
| 名稱 | 描述 |
|---|---|
options.useSearch boolean | 在地圖導航功能中，是否可使用地圖搜尋功能，預設為false。 |
範例：
ScaleControl
new mapPlus.ScaleControl(options)
比例尺功能。
參數：
- options
Object:
| 名稱 | 描述 |
|---|---|
options.unit string | 比例尺的單位，可設定為'metric'（公制單位）、'imperial'（英制單位）或'nautical'（海洋單位），預設為'metric'。 |
options.maxWidth number | 比例尺的最大寬度，預設為80。 |
範例：
SearchControl
new mapPlus.SearchControl(options)
地圖搜尋功能。
參數：
- options
Object:
| 名稱 | 描述 |
|---|---|
options.useRouteNav boolean | 在地圖搜尋功能中，是否可使用地圖導航功能，預設為false。 |
options.useAutoComplete boolean | 在地圖搜尋功能中，是否可使用自動完成功能，預設為false。 |
範例：
SelectControl
new mapPlus.SelectControl(options)
選取工具
參數：
- options
Object:
| 名稱 | 描述 |
|---|---|
options.useButton boolean | 是否使用按鈕控制選取工具的開關。 |
options.layerId string | 要綁定的圖層 id。 |
範例：
StyleModeControl
new mapPlus.StyleModeControl(options)
切換地圖風格模式。
參數：
- options
Object:
| 名稱 | 描述 |
|---|---|
options.useButton boolean | 是否使用按鈕控制風格模式。 |
options.styleList object | 要添加的地圖風格。key 為地圖樣式 id，value 為 object，value.title 為樣式名稱，value.sky 為天空顏色，value.style 為 .etxt 樣式檔。 |
範例：
實例方法：
addStyleMode
addStyleMode(modeId, style)
添加地圖模式。
參數：
- modeId
string: 要新增的地圖模式 id。 - style
object:
| 名稱 | 描述 |
|---|---|
style.title object | 樣式名稱。 |
style.sky object | 天空顏色。 |
style.style object | .etxt 樣式檔。 |
範例：
setStyleMode
setStyleMode(modeId)
更改地圖模式。
參數：
- modeId
string: 要切換的地圖模式 id。
範例：
TextureControl
new mapPlus.TextureControl(options)
套用建物材質。
參數：
- options
Object:
| 名稱 | 描述 |
|---|---|
options.useButton boolean | 是否使用按鈕控制建物材質的開關。 |
options.ignoreLandmark boolean | 如果圖磚為特殊地標，是否要忽略套用建物材質。 |
範例：
TrafficFlowControl
new mapPlus.TrafficFlowControl(options)
顯示即時路況。
參數：
- options
Object:
| 名稱 | 描述 |
|---|---|
options.useButton Object | 是否使用按鈕控制即時路況的開關。 |
options.color boolean | 設定即時路況的顏色。 |
範例：