資料層叢集
使用 map.data.enableCluster(true) 啟用叢集圖功能後，即可在地圖上以叢集圖的方式渲染資料層的點資料。
特色
資料層叢集功能可讓您在地圖上以叢集圖的方式顯示資料層中的點資料。
透過 map.data.enableCluster(true) 啟用叢集功能後，系統會自動將相近的點資料聚合成叢集，並可透過 addToCluster 屬性單獨控制每個點是否加入叢集。您也可以分別控制所有叢集點與非叢集點的顯示或隱藏。
開始使用
新增資料點後，直接調用 map.data.enableCluster(true) 即可開始使用資料層叢集，詳情使用方法請參考 enableCluster。
Examples
點選「開始使用」，即可開始操作地圖
叢集圖樣式
可使用 enableCluster() 的 options.styles 來自訂叢集圖的樣式。
包含以下屬性：
- circle
(object): 叢集圓圈樣式
| Key | Value |
|---|---|
colors (string[]) | 叢集圓圈的顏色陣列，依資料點數多寡套用不同顏色，預設為 ['#FFA500', '#F1F075', '#F28CB1']。 |
sizes (number[]) | 叢集圓圈的大小陣列，依資料點數多寡套用不同大小，預設為 [20, 30, 40]。 |
opacity (number) | 叢集圓圈的透明度，範圍為 0 到 1，預設為 0.8。 |
strokeColor (string) | 叢集圓圈外框顏色，預設為 #FFFFFF。 |
strokeWidth (number) | 叢集圓圈外框寬度，預設為 2。 |
- text
(object): 叢集圓圈文字樣式
| Key | Value |
|---|---|
color (string) | 叢集圓圈文字顏色，預設為 #FFFFFF。 |
size (number) | 叢集圓圈文字大小，預設為 12。 |
font (string[]) | 叢集圓圈文字字體，預設為 ['Noto Sans Regular']。 |
- point
(object): 叢集點樣式
| Key | Value |
|---|---|
color (string) | 叢集點的顏色，預設為 #FFA500。 |
size (number) | 叢集點的大小，預設為 6。 |
strokeColor (string) | 叢集點的外框顏色，預設為 #FFFFFF。 |
strokeWidth (number) | 叢集點的外框寬度，預設為 1。 |
- nonCluster
(object): 非叢集點樣式
| Key | Value |
|---|---|
color (string) | 非叢集點的顏色，預設為 #008000。 |
size (number) | 非叢集點的大小，預設為 6。 |
strokeColor (string) | 非叢集點的外框顏色，預設為 #FFFFFF。 |
strokeWidth (number) | 非叢集點的外框寬度，預設為 1。 |
Examples
點選「開始使用」，即可開始操作地圖
控制資料點是否加入叢集
可在資料點的 properties 中設定 addToCluster 屬性來控制該點是否加入叢集。
- addToCluster
(boolean): 該資料點是否加入叢集，true為加入成為叢集點之一，false為不加入（即非叢集點）。當有啟用叢集功能時，預設即為true。
Examples
點選「開始使用」，即可開始操作地圖
資料層的叢集實例方法
- enableCluster: 是否啟用叢集功能。
- toggleClusterPoints: 顯示或隱藏所有叢集點。
- toggleNonClusterPoints: 顯示或隱藏所有非叢集點。
enableCluster
map.data.enableCluster(enabled, options)
是否啟用叢集功能。
- enabled
(boolean): 必填，是否啟用叢集功能。 - options
(object): 選填，叢集圖的參數。
| Name | Description |
|---|---|
options.radius number | 選填，叢集半徑，以像素為單位，預設為 50。 |
options.maxZoom number | 選填，叢集圖層會停止叢集化的最大縮放級別，預設為 14。 |
options.styles object | 選填，叢集圖的樣式設置。 |
Examples
toggleClusterPoints
map.data.toggleClusterPoints(visible)
顯示或隱藏所有叢集點。
- visible
(boolean): 必填，是否顯示叢集點，true為顯示，false為隱藏。
Examples
toggleNonClusterPoints
map.data.toggleNonClusterPoints(visible)
顯示或隱藏所有非叢集點。
- visible
(boolean): 必填，是否顯示非叢集點，true為顯示，false為隱藏。
Examples