圖標散點層是基礎平面地圖的子組件，能夠以圖標散點的形式表現地理位置上的點數據信息。圖標散點層支持獨立的樣式、數據和交互配置，包括圖標散點層的圖標配置、系列配置、彈框樣式以及交互配置等。本文介紹圖標散點層各配置項的含義。
參見地圖容器（v2.x版本）添加圖標散點層子組件，并配置其參數。
配置
搜索配置：單擊配置面板右上角的搜索配置，可在搜索配置面板中輸入您需要搜索的配置項名稱，快速定位到該配置項，系統支持模糊匹配。詳情請參見搜索資產配置。
可見級別：設置圖標散點層的可見級別值，在設定的級別范圍內圖標散點層可見，級別之外不可見。
圖標配置：設置圖標散點的圖片路徑、圖片尺寸、相對位置、以及圖標的偏移量。
參數
說明
圖片路徑
在圖片路徑區域
鼠標移動到圖片位置，單擊刪除可刪除當前圖片，然后單擊圖片區域或者拖動本地圖片到區域內即可添加一個散點圖標。
鼠標移動到圖片位置，單擊更改可重新上傳本地圖片。
您也可以輸入圖片的URL地址，將遠程服務器上的圖片作為散點圖標。
圖片尺寸
設置散點圖標的寬度和高度來控制圖片尺寸大小。
相對位置
設置散點圖標對于散點的相對位置樣式，可選擇底部或中心。
偏移量
設置圖標從水平方向或者垂直方向的偏移量值。
系列配置：單擊右側的
或
圖標，增加或刪除一個系列。 單擊
或
圖標配置多個系列的排列樣式。單擊
圖標，即可復制當前選中系列配置內容并新增一個同樣配置的系列。類型過濾值：與數據源中的type字段對應，配置您所設置的type值對應散點的類型樣式。
設置每一個系列類型的圖標樣式，具體請參見配置下的圖標配置參數來配置對應系列的圖標樣式。
標注：散點的文字注釋。單擊標注左側的
圖標，可控制標注的顯隱。 參數
說明
顯示字段
與數據面板中的數據源配合使用，需要與地理數據中的某個字段名稱匹配。例如設置為name，那么可視化應用上的散點標注會顯示為name字段的值。
文本樣式
設置標注文字的字體、文字粗細、字號、顏色和陰影色。請參見顏色選擇器說明進行修改文本顏色。
相對位置
標注文字相對于散點的位置，包括中心、頂部、底部、左側、右側。
偏移量
設置文本注釋從水平方向或者垂直方向的偏移量值，單位為px。
彈框：在預覽或發布頁面，單擊數據點的圖標出現的彈框樣式。單擊左側的
圖標，可控制彈框的顯隱。 說明開啟彈窗功能需要先設置info字段。
info字段：打開開關，設置info字段作為彈窗內容，該字段支持配置html標簽；關閉開關，則兼容name和value字段內容作為彈窗內容。
事件類型：選擇通過點擊或鼠標移入事件作為彈框顯示的類型。
配置選項：彈框樣式的配置項內容，可選擇父容器默認或自定義配置。
父容器默認：系統自帶的默認樣式。
自定義配置：自定義配置彈框的文本樣式、行高比例、圓角半徑等參數。
參數
說明
文本樣式
設置彈框內文本的字體、文字粗細、字號和顏色，請參見顏色選擇器說明進行顏色修改。
行高比例
設置彈框格式的行高比例值。
圓角半徑
設置彈框的圓角半徑值，數值越大圓角越圓。
外邊距
設置彈框內文本與彈框四邊的距離。
背景色
設置彈框的背景色。
關閉按鈕
設置關閉彈框按鈕的顏色、大小、按鈕離頂部的距離和離右側的距離。
交互配置
懸停樣式：設置鼠標懸停時，圖標懸停大小相對原始大小的比例值。單擊左側
圖標，可控制懸停交互功能的開啟或關閉。
數據
表 1. 字段說明
字段 | 說明 |
type | （可選）多系列配置，與配置面板的系列配置配合使用，來配置散點的圖標類型。 說明 沒有配置系列值或者不在系列值之內的數據點，會使用配置面板中的圖標配置進行渲染。 |
name | （可選）散點的標注名稱，可以用于顯示點位標注，與配置面板中標注內的顯示字段對應，來設置特定散點的標注信息樣式。 |
lng | 散點的經度。 |
lat | 散點的緯度。 |
value | （可選）散點在配置項勾選數據映射時用于數據映射的值，缺失則按無數據配置渲染。 |
info | （可選）單擊散點，出現的彈窗信息內容。 |
iconUrl | （可選）自定義圖標的地址路徑。 |
配置項 | 說明 |
受控模式 | 打開開關，資產初始化狀態下不請求數據，僅通過回調ID或藍圖編輯器配置的方法發起請求數據；關閉開關，可以使用自動更新請求數據。開關默認為關閉狀態。 |
自動更新請求 | 選中后可以設置動態輪詢，還可以手動輸入輪詢的時間頻次。取消選中后則不會自動更新，需要手動刷新頁面，或通過藍圖編輯器和回調ID事件來觸發請求更新數據。 |
數據源 | 單擊配置數據源，可在設置數據源面板中修改數據源類型和數據查詢代碼、預覽數據源返回結果以及查看數據響應結果，詳情請參見配置資產數據。 |
數據過濾器 | 數據過濾器提供數據結構轉換、篩選和一些簡單的計算功能。單擊添加過濾器，可在設置數據源面板配置數據過濾器腳本，詳情請參見過濾器使用說明。 |
數據響應結果 | 展示數據請求的響應結果。當數據源發生改變時，可單擊右側的 |
圖標，實時查看數據響應結果。交互
表 2. 交互說明
交互 | 說明 |
當點擊點時 | 選中啟用，開啟組件交互功能。圖標散點層子組件擁有交互配置，當單擊某個散點時拋出回調值，默認拋出數據中的lng和lat字段。具體配置請參見組件回調ID配置。 |
當鼠標移入時 | 選中啟用，開啟組件交互功能。圖標散點層子組件擁有交互配置，當鼠標移入到散點位置時拋出回調值，默認拋出數據中的lng和lat字段。具體配置請參見組件回調ID配置。 |
藍圖編輯器交互配置
在畫布編輯器頁面，單擊基礎平面地圖子組件管理列表中圖標散點層右側的
圖標。單擊頁面左上角的
圖標。在藍圖編輯器配置頁面，單擊導入節點欄內的圖標散點層組件，在畫布中可以看到如下圖所示的圖標散點層的藍圖編輯器配置參數。
事件
事件
說明
當數據接口請求完成時
數據接口請求返回并經過過濾器處理后拋出的事件，同時拋出處理后的JSON格式的數據。具體數據示例請參見畫布編輯器中組件右側配置面板數據頁簽的數據響應結果區域。
當數據接口請求失敗時
數據接口請求失敗時（請求失敗的情況可能是：網絡問題或接口報錯等）返回并經過過濾器處理后拋出的事件，同時拋出處理后的JSON格式的數據。具體數據示例請參見畫布編輯器中組件右側配置面板數據頁簽的數據響應結果區域。
當點擊點時
當單擊圖標散點層的散點時拋出的事件，同時拋出該散點對應的經緯度數據項。
當鼠標移入時
當鼠標移入圖標散點層的散點時拋出的事件，同時拋出該散點對應的經緯度數據項。
動作
動作
說明
請求數據接口
重新請求服務端數據，上游數據處理節點或圖層節點拋出的數據將作為參數。例如圖標散點層配置了API數據源為
http://api.test，傳到請求數據接口動作的數據為{ id: '1'}，則最終請求接口為http://api.test?id=1。導入數據接口
按組件繪制格式處理數據后，導入組件，重新繪制。不需要重新請求服務端數據。具體數據示例請參見畫布編輯器中組件右側配置面板數據頁簽的數據響應結果區域。
顯示
顯示組件，不需要參數。
隱藏
隱藏組件，不需要參數。