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