圖片背景層是基礎平面地圖的子組件,能夠使用自定義的圖片URL地址來設置基礎平面地圖的背景。與底圖層不同的是,圖片背景層使用的是本地或遠程服務器上的圖片,而底圖層使用的是瓦片地址,兩者可以配合使用。本文介紹圖片背景層各配置項的含義。

注意 當前為v2.x版本的圖片背景層子組件指導文檔,如需查看該子組件v1.x版本的文檔內容詳情,請參見背景層(v1.x版本)。
單擊子組件管理下方的圖片背景層,進入配置面板配置圖片背景層的樣式和數據。
說明 如果子組件管理中沒有圖片背景層,說明您還未添加圖片背景層子組件,請參見地圖容器(v2.x版本)進行添加。

配置

圖片背景層配置面板v2.x
  • 搜索配置:單擊配置面板右上角的搜索配置,可在搜索配置面板中輸入您需要搜索的配置項名稱,快速定位到該配置項,系統支持模糊匹配。詳情請參見搜索資產配置
  • 可見級別:設置圖片背景層的可見級別值,在設定的級別范圍內可見,級別之外不可見。
  • 默認配置:設置默認配置下的圖片路徑、透明度和圖片范圍等參數。
    參數 說明
    圖片路徑 圖片路徑區域
    • 鼠標移動到圖片位置,單擊刪除可刪除當前圖片,然后單擊圖片區域或者拖動本地圖片到區域內即可添加一個背景圖。
    • 鼠標移動到圖片位置,單擊更改可重新上傳本地圖片。
    • 您也可以輸入圖片的URL地址,將遠程服務器上的圖片作為背景圖。

    對于固定縮放等級的可視化應用設計需求,用戶可以自己設計地圖背景,作為地圖底圖,增強地圖美感。

    透明度 圖片背景層的透明度,范圍為0~1。
    圖片范圍 可以通過左下角和右上角的X、Y坐標,來調整圖片背景層的位置。其中X坐標的取值范圍為[-180,180],Y坐標的取值范圍為[-90,90]。
    注意
    • 在圖片背景層配置面板內,僅支持配置一張背景圖。
    • 當數據面板內有配置圖片數據,配置面板內設置的圖片參數就不生效。
    • 如果您只需要配置一張背景圖,可以選擇在配置面板直接添加并設置圖片相關參數,也可以選擇在數據面板添加圖片對應的字段數據來配置背景圖,兩種方式選其一即可。
    • 如果您需要配置多張背景圖,則必須通過在數據面板內添加多張圖片對應的字段數據來實現。

數據

圖片背景層數據面板
表 1. 字段說明
字段 說明
imageUrl (可選)圖片的URL地址。
opacity (可選)圖片的透明度值。
bounds (可選)圖片范圍值。
表 2. 配置項說明
配置項 說明
受控模式 打開開關,資產初始化狀態下不請求數據,僅通過回調ID或藍圖編輯器配置的方法發起請求數據;關閉開關,可以使用自動更新請求數據。開關默認為關閉狀態。
自動更新請求 選中后可以設置動態輪詢,還可以手動輸入輪詢的時間頻次。取消選中后則不會自動更新,需要手動刷新頁面,或通過藍圖編輯器和回調ID事件來觸發請求更新數據。
數據源 單擊配置數據源,可在設置數據源面板中修改數據源類型和數據查詢代碼、預覽數據源返回結果以及查看數據響應結果。詳情請參見配置資產數據。
數據過濾器 數據過濾器提供數據結構轉換、篩選和一些簡單的計算功能。單擊添加過濾器,可在設置數據源面板配置數據過濾器腳本,詳情請參見過濾器使用說明。
數據響應結果 展示數據請求的響應結果。當數據源發生改變時,可單擊右側的刷新圖標 圖標,實時查看數據響應結果。

交互

此組件沒有交互事件。

藍圖編輯器交互配置

  1. 在畫布編輯器頁面,單擊基礎平面地圖子組件管理列表中圖片背景層右側的導出到藍圖編輯器圖標。
  2. 單擊頁面左上角的藍圖圖標圖標。
  3. 在藍圖編輯器配置頁面,單擊導入節點欄內的圖片背景層組件,在畫布中可以看到如下圖所示的圖片背景層的藍圖編輯器配置參數。圖片背景層藍圖參數
    • 事件
      事件 說明
      當圖片數據接口請求完成時 數據接口請求返回并經過過濾器處理后拋出的事件,同時拋出處理后的JSON格式的數據。具體數據示例請參見畫布編輯器中組件右側配置面板數據頁簽的數據響應結果區域。
      當圖片數據接口請求失敗時 數據接口請求失敗時(請求失敗的情況可能是:網絡問題或接口報錯等)返回并經過過濾器處理后拋出的事件,同時拋出處理后的JSON格式的數據。具體數據示例請參見畫布編輯器中組件右側配置面板數據頁簽的數據響應結果區域。
    • 動作
      動作 說明
      請求圖片數據接口 重新請求服務端數據,上游數據處理節點或圖層節點拋出的數據將作為參數。例如圖片背景層配置了API數據源為http://api.test,傳到請求圖片數據接口動作的數據為{ id: '1'},則最終請求接口為http://api.test?id=1。
      導入圖片數據接口 按組件繪制格式處理數據后,導入組件,重新繪制。不需要重新請求服務端數據。具體數據示例請參見畫布編輯器中組件右側配置面板數據頁簽的數據響應結果區域。
      顯示 顯示組件,不需要參數。
      隱藏 隱藏組件,不需要參數。