線熱力層是基礎平面地圖的子組件,支持獨立的樣式、數據和交互配置,能夠以熱力線的形式表現地理位置上的線路信息,適用于地圖上線路圖的大屏展示,例如展示地鐵線路圖。本文介紹線熱力層各配置項的含義。
當前為v1.x版本的線熱力層子組件指導文檔,如需查看該子組件v2.x版本的文檔內容詳情,請參見線熱力層(v2.x版本)。
單擊子組件管理下方的線熱力層,進入配置面板配置線熱力層的樣式和數據。
如果子組件管理中沒有線熱力層,說明您還未添加線熱力層子組件,請參見地圖容器(v1.x版本)進行添加。
配置
邊線選項
交互配置
懸停:單擊圖標,可控制懸停交互功能的開啟或關閉。開啟后可設置懸停顏色和懸停時線的粗細,僅在預覽或發布時才能看到效果。
彈窗:打開開關,單擊熱力線,顯示線的詳細信息,該信息可在數據的properties屬性中進行配置,僅在預覽或發布時才能看到效果。
點擊聚焦:打開開關,單擊熱力線,會根據線的位置進行聚焦,僅在預覽或發布時才能看到效果。
聚焦范圍比:熱力線的聚焦范圍比,僅當開啟了點擊聚焦配置項,且在預覽或發布頁面時才能看到效果。
回調ID:設置組件之間數據聯動的變量,需要配置為數據中的某一個字段。
重要此功能已更新到交互面板中,配置面板的該功能將棄用,請盡快升級。新版本的交互功能支持配置多個字段。
數據
該組件需要配置兩個數據源,地理邊界geojson數據接口和熱力值數據接口。
地理邊界geojson數據接口:geojson 類型的數據,要求類型為 LineString。如果需要跟熱力值射數據對應,必須保證有唯一的 link_id 或者 id 字段。關于geojson的標準可以參見geojson.org 。
本文僅提供一個簡單的代碼示例,如下所示。
{ "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "type": "LineString", "coordinates": [ [ 109.4677734375, 41.409775832009565 ], [ 117.46582031249999, 36.31512514748051 ], [ 118.828125, 32.0639555946604 ], [ 114.9169921875, 27.566721430409707 ] ] } } ] }
說明properties字段對應配置面板中的彈窗信息,您可以自定義該字段值進行配置。
熱力值數據接口
表 1. 字段說明 字段
說明
link_id
線關聯ID,通過該字段,與矢量線數據進行對應。
value
線的權重值,是配置面板中設置最大值、最小值、空值顏色的依據。
info
(可選)彈窗內容,如果為空,則彈窗信息顯示為對應的矢量線數據中的properties字段的內容。如果不為空,彈窗信息顯示為info字段的內容。
color
(可選)線熱力層支持數據優先的渲染,如果您配置了color(線顏色)、weight(線寬)、dashArray(虛線)等字段,那么會優先使用這些屬性來對關聯的線進行渲染。
表 2. 配置項說明 配置項
說明
受控模式
打開開關,資產初始化狀態下不請求數據,僅通過回調ID或藍圖編輯器配置的方法發起請求數據;關閉開關,可以使用自動更新請求數據。開關默認為關閉狀態。
自動更新請求
選中后可以設置動態輪詢,還可以手動輸入輪詢的時間頻次。取消選中后則不會自動更新,需要手動刷新頁面,或通過藍圖編輯器和回調ID事件來觸發請求更新數據。
數據源
單擊配置數據源,可在設置數據源面板中修改數據源類型和數據查詢代碼、預覽數據源返回結果以及查看數據響應結果,詳情請參見配置資產數據。
數據過濾器
數據過濾器提供數據結構轉換、篩選和一些簡單的計算功能。單擊添加過濾器,可在設置數據源面板配置數據過濾器腳本,詳情請參見過濾器使用說明。
數據響應結果
展示數據請求的響應結果。當數據源發生改變時,可單擊右側的圖標,實時查看數據響應結果。
交互
選中啟用,開啟組件交互功能。線熱力層子組件擁有交互配置,可單擊某個熱力線拋出回調值,默認拋出數據中的link_id字段。具體配置請參見組件回調ID配置。
藍圖編輯器交互配置
在畫布編輯器頁面,單擊基礎平面地圖子組件管理列表中線熱力層右側的圖標。
單擊頁面左上角的圖標。
在藍圖編輯器配置頁面,單擊導入節點欄內的線熱力層組件,在畫布中可以看到如下圖所示的線熱力層的藍圖編輯器配置參數。
事件
事件
說明
當地理邊界geojson數據接口請求完成時
地理邊界geojson數據接口請求返回并經過過濾器處理后拋出的事件,同時拋出處理后的JSON格式的數據。
當熱力值數據接口請求完成時
熱力值數據接口請求返回并經過過濾器處理后拋出的事件,同時拋出處理后的JSON格式的數據。
當點擊線時
當單擊某條線時觸發事件。
動作
動作
說明
請求地理邊界geojson數據接口
重新請求服務端數據,上游數據處理節點或圖層節點拋出的數據將作為參數。例如線熱力層配置了API數據源為
http://api.test
,傳到請求地理邊界geojson數據接口動作的數據為{ id: '1'}
,則最終請求接口為http://api.test?id=1
。請求熱力值數據接口
重新請求服務端數據,上游數據處理節點或圖層節點拋出的數據將作為參數。例如線熱力層配置了API數據源為
http://api.test
,傳到請求熱力值數據接口動作的數據為{ id: '1'}
,則最終請求接口為http://api.test?id=1
。導入地理邊界geojson數據接口
按組件繪制格式處理數據后,導入組件,重新繪制。不需要重新請求服務端數據。
導入熱力值數據接口
按組件繪制格式處理數據后,導入組件,重新繪制。不需要重新請求服務端數據。
顯示
顯示組件,不需要參數。
隱藏
隱藏組件,不需要參數。