地圖容器(v3.x版本)
地圖容器是基礎平面地圖中用于承載地圖本身和各子組件的容器,支持添加區(qū)域熱力層、點熱力層等子組件,支持配置地圖的位置、顏色、鼠標交互事件等,能夠多角度、多形式地渲染全國各城市地理位置的實時數(shù)據(jù)。本文介紹基礎平面地圖容器各配置項的含義。
鏡頭設置
單擊畫布中基礎平面地圖 3.0組件右上方的按鈕或者雙擊組件進入鏡頭設置界面。
在鏡頭設置界面,您可以自由改變地圖的鏡頭視角,更改完成后需要將設定的地圖鏡頭視角保存。
通過鼠標更改地圖鏡頭視角的方法有如下幾種:
單擊地圖中的省或直轄市區(qū)域處,可以定位并放大該區(qū)域視角到地圖正中間(區(qū)域熱力層)。
雙擊地圖中的省或直轄市區(qū)域及地市級區(qū)域即可下鉆定位并放大該區(qū)域視角到地圖正中間(自定義區(qū)域下鉆層)。
單擊并按住鼠標左鍵鍵,可以拖動平移地圖(任意子組件)。
上下滾動鼠標滑輪,可以縮放地圖的大小(任意子組件)。
設置完地圖鏡頭后,單擊鏡頭設置界面右上角的圖標,即可保存地圖鏡頭后關閉鏡頭設置界面。
說明退出鏡頭設置界面后,依舊可以重新進入修改地圖鏡頭樣式。每次新進入鏡頭設置頁面,鏡頭視角如有改動都需要重新保存。
配置面板
子組件管理
添加子組件
在控制臺中單擊基礎平面地圖 3.0組件,進入右側的配置頁面。
單擊子組件管理左側的圖標。
選中一個或多個子組件,單擊下方的+添加子組件。添加成功后,子組件會顯示在子組件管理列表中。
單擊添加子組件面板左上角的以分析模式創(chuàng)建,即可切換到分析模式子組件面板中,同樣可參見上述步驟添加一個或多個分析模式的子組件。
單擊已經(jīng)添加的子組件,配置子組件參數(shù)。
配置完成后,單擊圖標,返回到基礎平面地圖配置面板,配置其他子組件。
復制、重命名、刪除子組件:鼠標移至已經(jīng)添加的子組件上,單擊右側的圖標,復制子組件。單擊圖標,修改子組件名稱。單擊圖標,刪除子組件。
說明更多子組件的相關操作請參見管理地圖子組件。
- 搜索配置:單擊配置面板右上角的搜索配置,可在搜索配置面板中輸入您需要搜索的配置項名稱,快速定位到該配置項,系統(tǒng)支持模糊匹配。詳情請參見搜索資產(chǎn)配置。
- 圖表尺寸:包括組件的寬度和高度,單位為px。可單擊圖標鎖定組件的寬高比,等比例修改組件的寬高。再次單擊進行解鎖,解鎖后寬高比不受限制。
- 圖表位置:包括組件的橫坐標和縱坐標,單位為px。橫坐標為組件左上角距離頁面左邊界的像素距離,縱坐標為組件左上角距離頁面上邊界的像素距離。
- 旋轉角度:以組件的中心為中心點,進行旋轉,單位為度(°)。
- 手動輸入角度值,控制組件的旋轉角度。
- 拖動圖標內(nèi)的黑點,控制組件的旋轉角度。
- 單擊圖標,控制組件左右翻轉樣式。
- 單擊圖標,控制組件上下翻轉樣式。
- 不透明度:取值范圍為0~1。為0時,圖表隱藏;為1時,圖表全部顯示。默認為1。
通用:地圖容器的通用配置。
參數(shù)
說明
地圖背景
地圖的背景顏色,請參見顏色選擇器說明進行修改。
地圖縮放
控制地圖父容器的縮放范圍及默認級別。
縮放范圍:縮放范圍控制父容器只能在縮放范圍內(nèi)操作,取值范圍0~22。
默認級別:默認級別設置父容器默認顯示級別,需要設置在縮放范圍內(nèi),取值范圍0~22。
說明地圖縮放支持分數(shù)級縮放。縮放級別控制父容器只能在縮放范圍內(nèi)操作;默認級別設置父容器默認顯示級別,需要設置在縮放范圍內(nèi)。
地圖中心
地圖中心的經(jīng)緯度。
比例尺控件
單擊比例尺控件右側的圖標,可在地圖上顯示比例尺控件。開啟后,可調整比例尺控件的字體顏色、邊框顏色和在水平和垂直方向的偏移值。
您也可以通過配置數(shù)據(jù)源來更改地圖中心點和縮放等級。
說明如需定位到其他省份的地圖區(qū)域,需要使用區(qū)域熱力層(v3.x版本)或自定義區(qū)域下鉆層(v3.x版本)來實現(xiàn)。
坐標:地圖的坐標系類型,可選通用坐標或自定義兩個類型。
參數(shù)
說明
通用坐標
通用坐標包括EPSG3857、EPSG3395、EPSG4326和BD09,系統(tǒng)默認設置為EPSG3857坐標系,如果切換成別的類型的通用坐標,底圖層對應的瓦片URL需要重新設置。
自定義
您可以自定義設置坐標系,包括配置坐標系的EPSG、proj參數(shù)、經(jīng)度原點、緯度原點和分辨率。自定義坐標系詳情請參見自定義坐標系的地圖。
交互:設置地圖交互功能的參數(shù)。
參數(shù)
說明
地圖交互
打開開關,開啟地圖交互功能。在預覽或發(fā)布頁面下,可單擊聚焦到某個區(qū)域,并查看該區(qū)域的數(shù)據(jù)配置信息。
拖拽交互
打開開關,開啟地圖拖拽功能。在預覽或發(fā)布頁面下,可單擊鼠標拖拽地圖。
縮放交互
打開開關,開啟地圖縮放功能。在預覽或發(fā)布頁面下,可滾動鼠標滾輪,對地圖進行縮放。
無極縮放
打開開關,開啟無極縮放功能,地圖縮放效果更加平滑;關閉開關,地圖縮放性能更高。
數(shù)據(jù)面板
配置字段說明
字段 | 說明 |
zoom | (可選)地圖的縮放等級,對應配置面板中的地圖縮放。如果兩者都進行了配置,DataV優(yōu)先使用數(shù)據(jù)中的配置。 |
lng | (可選)地圖中心位置的經(jīng)度,對應配置面板中的 。如果兩者都進行了配置,DataV優(yōu)先使用數(shù)據(jù)中的配置。 |
lat | (可選)地圖中心位置的緯度,對應配置面板中的 。如果兩者都進行了配置,DataV優(yōu)先使用數(shù)據(jù)中的配置。 |
配置項 | 說明 |
受控模式 | 打開開關,資產(chǎn)初始化狀態(tài)下不請求數(shù)據(jù),僅通過回調ID或藍圖編輯器配置的方法發(fā)起請求數(shù)據(jù);關閉開關,可以使用自動更新請求數(shù)據(jù)。開關默認為關閉狀態(tài)。 |
自動更新請求 | 選中后可以設置動態(tài)輪詢,還可以手動輸入輪詢的時間頻次。取消選中后則不會自動更新,需要手動刷新頁面,或通過藍圖編輯器和回調ID事件來觸發(fā)請求更新數(shù)據(jù)。 |
數(shù)據(jù)源 | 單擊配置數(shù)據(jù)源,可在設置數(shù)據(jù)源面板中修改數(shù)據(jù)源類型和數(shù)據(jù)查詢代碼、預覽數(shù)據(jù)源返回結果以及查看數(shù)據(jù)響應結果,詳情請參見配置資產(chǎn)數(shù)據(jù)。 |
數(shù)據(jù)過濾器 | 數(shù)據(jù)過濾器提供數(shù)據(jù)結構轉換、篩選和一些簡單的計算功能。單擊添加過濾器,可在設置數(shù)據(jù)源面板配置數(shù)據(jù)過濾器腳本,詳情請參見過濾器使用說明。 |
數(shù)據(jù)響應結果 | 展示數(shù)據(jù)請求的響應結果。當數(shù)據(jù)源發(fā)生改變時,可單擊右側的圖標,實時查看數(shù)據(jù)響應結果。 |
交互面板
選中啟用,開啟組件交互功能。當地圖移動時和地圖移動結束時,會拋出您自定義的變量值。具體配置請參見如何配置數(shù)字翻牌器組件的回調ID。
它的部分子組件支持交互配置,即回調ID,例如:區(qū)域熱力層、區(qū)域下鉆熱力層、線熱力層、散點層。通過回調ID,可以實現(xiàn)地圖的交互功能,具體請參見 配置組件交互和如何配置數(shù)字翻牌器組件的回調ID。
藍圖編輯器交互配置
- 在畫布編輯器頁面,右鍵單擊組件,選擇導出到藍圖編輯器。
- 單擊頁面左上角的圖標。
在藍圖編輯器配置頁面,單擊導入節(jié)點欄內(nèi)的基礎平面地圖 3.0組件,在畫布中可以看到如下圖所示的基礎平面地圖的藍圖編輯器配置參數(shù)。
事件
事件
說明
當數(shù)據(jù)接口請求完成時
數(shù)據(jù)接口請求返回并經(jīng)過過濾器處理后拋出的事件,同時拋出處理后的JSON格式的數(shù)據(jù)。具體數(shù)據(jù)示例請參見畫布編輯器中組件右側配置面板數(shù)據(jù)頁簽的數(shù)據(jù)響應結果區(qū)域。
當數(shù)據(jù)接口請求失敗時
數(shù)據(jù)接口請求失敗時(請求失敗的情況可能是:網(wǎng)絡問題或接口報錯等)返回并經(jīng)過過濾器處理后拋出的事件,同時拋出處理后的JSON格式的數(shù)據(jù)。具體數(shù)據(jù)示例請參見畫布編輯器中組件右側配置面板數(shù)據(jù)頁簽的數(shù)據(jù)響應結果區(qū)域。
地圖移動時
地圖中心點發(fā)生移動時拋出的事件,參考數(shù)據(jù)示例如下。
return { "type": "flyTo",//類型 "zoom": "1",//縮放級別 "lng": "102.4",//經(jīng)度 "lat": "34.0"http://維度 }
地圖移動結束
地圖中心點移動結束時拋出的事件,參考數(shù)據(jù)示例如下。
return { "type": "flyTo",//類型 "zoom": "1",//縮放級別 "lng": "102.4",//經(jīng)度 "lat": "34.0"http://維度 }
動作
動作
說明
請求數(shù)據(jù)接口
重新請求服務端數(shù)據(jù),上游數(shù)據(jù)處理節(jié)點或圖層節(jié)點拋出的數(shù)據(jù)將作為參數(shù)。例如基礎平面地圖配置了API數(shù)據(jù)源為
https://api.test
,傳到請求數(shù)據(jù)接口動作的數(shù)據(jù)為{ id: '1'}
,則最終請求接口為https://api.test?id=1
。導入數(shù)據(jù)接口
按組件繪制格式處理數(shù)據(jù)后,導入組件,重新繪制。不需要重新請求服務端數(shù)據(jù)。具體數(shù)據(jù)示例請參見畫布編輯器中組件右側配置面板數(shù)據(jù)頁簽的數(shù)據(jù)響應結果區(qū)域。
顯示
顯示組件,不需要參數(shù)。
隱藏
隱藏組件,不需要參數(shù)。
設置視圖
設置地圖視圖的地圖中心點和縮放級別,參考數(shù)據(jù)示例如下。
return { "zoom": 6, "lng": 108, "lat": 38 }
設置縮放級別
設置地圖的縮放級別,參考數(shù)據(jù)示例如下。
//設置縮放級別 return {"zoom": 6}
設置縮放范圍
設置地圖的級別縮放范圍,參考數(shù)據(jù)示例如下。
//設置縮放級別范圍:[最小級別,最大級別]。 return { "range": [3,20] }
設置最大視圖范圍
設置地圖最大視圖的坐標范圍,參考數(shù)據(jù)示例如下。
//坐標范圍:[[最小緯度,最小經(jīng)度],[最大緯度,最大經(jīng)度]] return { "zoom": 1, "bounds": [ [-90,-180], [90,180] ] }
飛行到指定位置
設置飛行到指定位置點的經(jīng)緯度和縮放級別和飛線的時間間隔,參考數(shù)據(jù)示例如下。
return { "zoom": 4.5,//縮放級別,需要在設置的縮放級別范圍內(nèi)。 "lng": 108,//經(jīng)度范圍:[-180,180] "lat": 38,//緯度范圍:[-90,90] "duration": 0.25//間隔時間,單位:秒 }
飛行到指定范圍
設置飛行到指定范圍的坐標范圍和飛行間隔時間,參考數(shù)據(jù)示例如下。
return { "bounds": //坐標范圍:[[最小緯度,最小經(jīng)度],[最大緯度,最大經(jīng)度]] [ [0,72], [53,138] ], "duration": 0.25//時間間隔,單位:秒 }
更新組件配置
動態(tài)更新組件的樣式配置。需要先在組件的配置面板中,單擊復制配置到剪貼板,獲取組件配置數(shù)據(jù)。再根據(jù)需要在藍圖編輯器配置頁面的數(shù)據(jù)處理節(jié)點中更改對應樣式的字段值。
切換顯隱狀態(tài)
切換組件顯示或者隱藏,參考數(shù)據(jù)示例如下。
return { "animationIn": { "animationType": "",// 動畫方式,可選fade,不填無動畫。 "animationDuration": 1000,// 顯示延時,單位為ms。 "animationEasing": "linear"http:// 動畫函數(shù),可選linear|easeInOutQuad|easeInOutExpo。 }, "animationOut": { "animationType": "", "animationDuration": 1000, "animationEasing": "linear" } }
移動
將組件移動到指定位置,參考數(shù)據(jù)示例如下。
return { // 移動方式。絕對定位:to,相對定位:by。默認值:to。 "positionType": "to", // 指定位置。x坐標,y坐標。 "attr": { "x": 0, "y": 0 }, // 動畫方式。 "animation": { "enable": false, // 動畫延時。 "animationDuration": 1000, // 動畫曲線。可選值為:linear|easeInOutQuad|easeInOutExpo。 "animationEasing": "linear" } }