地圖模式

3D平面地圖包括中國地圖和世界地圖兩種地圖模式，其組件配置和子組件配置完全一致，以后章節內容均以中國地圖模式介紹各配置項的含義。

快速樣式

3D平面地圖組件具有快速樣式功能，您可以根據實際應用場景，選擇不同的樣式。包括碧璽綠、丹霞橙、晴山藍等樣式。

鏡頭設置

1. 單擊畫布中3D平面地圖組件右上方的按鍵或者雙擊組件進入鏡頭設置界面。

2. 在鏡頭設置界面，您可以自由調整地圖的鏡頭視角，并在完成更改后保存所設定的視角。

   使用鼠標更改地圖鏡頭視角的方法如下：

   • 雙擊地圖中的省、直轄市或地市級區域，可以下鉆并放大該區域，將其定位到地圖正中央。

   • 鼠標右鍵雙擊地圖的空白區域，可以上鉆一級，并將視角放大定位到上鉆后的區域中心。

   • 按住鼠標右鍵并拖動，可以平移地圖。

   • 上下滾動鼠標滑輪，可以縮放地圖的大小。

   • 按住鼠標左鍵并拖動，可以旋轉地圖。

3. 設置完地圖鏡頭后，單擊保存并退出設置，即可保存地圖鏡頭并關閉鏡頭設置界面。

   說明

   退出鏡頭設置界面后，依舊可以重新進入修改地圖鏡頭樣式。每次新進入鏡頭設置頁面，鏡頭視角如有改動都需要重新保存。

子組件管理

• 添加子組件

  1. 在畫布中單擊3D平面地圖組件，進入右側的配置頁面。

  2. 單擊面板左側的圖標，展開子組件面板和子組件管理面板。

  3. 單擊添加需要添加的子組件，添加成功后，子組件會顯示在子組件管理列表中。

  4. 單擊已經添加的子組件，在右側標簽欄中配置子組件參數。

  5. 配置完成后，單擊圖標，返回到3D平面地圖配置面板，配置其他子組件。

• 復制、刪除和重命名子組件：鼠標移至已經添加的子組件上，單擊鼠標右鍵，分別選擇復制、刪除子組件，完成復制和刪除操作。雙擊子組件，完成重命名操作。

  

樣式面板

• 搜索配置：單擊樣式面板右上角的搜索配置項圖標，可在搜索配置面板中輸入您需要搜索的配置項名稱，快速定位到該配置項，系統支持模糊匹配。詳情請參見搜索配置項。

• 基礎配置：

  • 尺寸：包括組件的寬度和高度，單位為px。

  • 定位：包括組件的橫坐標和縱坐標，單位為px。橫坐標為組件左上角距離頁面左邊界的像素距離，縱坐標為組件左上角距離頁面上邊界的像素距離。

  • 旋轉：以組件的中心為中心點，進行旋轉，單位為度（°）。

    • 手動輸入角度值，控制組件的旋轉角度。

    • 單擊圖標，控制組件左右翻轉樣式。

    • 單擊圖標，控制組件上下翻轉樣式。

  • 不透明度：取值范圍為0~1。為0時，圖表隱藏；為1時，圖表全部顯示。默認為1。

  • 交互穿透：開啟后，鼠標可穿透該組件，避免看板中組件較多時，該組件會遮擋鼠標與下層組件的交互。

  • 對齊：組件在編輯器中的對齊方式。

• 通用：地圖容器的通用配置。

  參數	說明
  高性能模式	開啟后，會終止資源預加載和關閉陰影效果，提升產品的使用性能。
  背景顏色	設置地圖的背景顏色。
  相機參數	設置相機的參數配置。 范圍限制：設置鏡頭角度和縮放的最大和最小值。 視圖角度：傾斜角度取值范圍為0~90，旋轉角度取值范圍為-30~30。 視圖縮放：視距比例取值范圍為0.2~2。 視圖角度：地圖的傾斜角度和旋轉角度。傾斜角度取值范圍為0~90，旋轉角度取值范圍為-30~30。 視圖縮放：地圖距離視線的比例大小值，取值范圍為0.2~2。

• 自然：地圖的自然效果配置。

  • 光照：地圖光照效果。

    參數	說明
    環境貼圖	模擬物體表面反射周圍環境的效果。在選擇框中選擇或上傳需要使用的貼圖，設置貼圖的方向和強度。
    環境光	設置環境光的顏色和強度。
    平行光	設置平行光沿著x軸、y軸和z軸三個方向的角度值、光照顏色和光照強度值，平行光顏色。啟用陰影是通過平行光源來投射陰影，開啟后可以增加場景的立體感和真實感。

  • 海洋：地圖中的水體效果樣式，可單擊圖標控制樣式的顯隱。

    參數	配置
    水體顏色	地圖水體的顏色。
    紋理貼圖	設置動態裝飾材質的紋理貼圖樣式，可以自定義上傳貼圖。
    法線貼圖	地圖水體的法線貼圖樣式，可以自定義上傳貼圖。
    波紋	設置水面動態效果，包括低頻尺寸、高頻尺寸和密度。
    水流	拖動滑塊，設置水體在水平和垂直方向的流動速度值，取值范圍0~100。

  • 霧：地圖霧化效果樣式，可單擊圖標控制霧化效果的顯隱。

    參數	說明
    顏色	設置地圖霧化的顏色。
    霧強度	拖動滑塊，設置地圖霧化效果可見性強度，取值范圍0.1~1。

• 地形：設置地圖地形的樣式參數。

  說明

  紋理貼圖、法線貼圖在配置樣式時，支持單紋理貼圖和柵格瓦片服務地址兩種形式，其中柵格瓦片服務地址為xyz瓦片服務，URL鏈接中必須包含{x}{y}{z}占位符。如果您使用自有柵格服務，則需要提供至少12層的瓦片。

  • 主體地形：設置當前所有子組件數據顯示的區域地形的樣式，在主體地形內可以配置交互操作，單擊圖標控制主體地形的顯隱。

    • 拉伸比例：拖動滑塊，設置地形垂直方向相對于水平面的縮放比例，取值范圍為1~10。

    • 頂面樣式：設置主體地形頂面樣式參數。包括可自定義調整頂面類型、填充顏色、材質顏色、粗糙度和金屬感，還可以單擊圖標控制頂面紋理貼圖、法線貼圖的顯隱，配置貼圖的樣式和強度。

    • 側面樣式：設置主體地形側面樣式參數，單擊圖標控制紋理貼圖和發光效果的顯隱。設置紋理貼圖的動畫速率，調整發光效果的顏色和強度，可以增強視覺吸引力。

    • 文字標注：地圖中地形區域的文字標注樣式。

      • 距離衰減：開啟后，隨著文字標注距離的增加，文字的可見性和清晰度會逐漸減弱。

      • 基本樣式：設置文字粗細樣式、字號大小、文字的顏色、文字描邊的顏色和粗細，可單擊圖標控制文字標注的顯隱。

    • 發光圍欄：通過賦予地圖區域輪廓發光效果，增強其在復雜場景中的可見性和吸引力。

      • 高度比例：拖動滑塊，設置發光效果垂直方向相對于水平面的縮放比例，取值范圍為0.1~5。

      • 材質顏色：設置沒有發光效果時的基本顏色。

      • 紋理貼圖：使用系統提供的樣式或自定義貼圖URL。

      • 發光效果：調整發光效果的顏色、強度和發光速率，可以增強視覺吸引力。

  • 背景地形：設置地圖除了主體地形以外的背景地形區域的樣式，背景地形設置不會響應交互事件，可單擊圖標控制背景地形的顯隱。

    • 頂面樣式：設置背景地形頂面樣式參數。包括可自定義調整頂面類型、填充顏色、材質顏色、粗糙度和金屬感，還可以單擊圖標控制頂面紋理貼圖、法線貼圖的顯隱，配置貼圖的樣式。

    • 側面樣式：設置背景地形側面樣式參數，單擊圖標控制紋理貼圖和發光效果的顯隱。設置紋理貼圖的動畫速率，調整發光效果的顏色和強度，可以增強視覺吸引力。

• 邊界：設置地圖邊界的參數。

  • 主體地形邊界：設置當前所有子組件數據顯示的區域邊界的樣式，在主體地形內可以配置交互操作，單擊圖標控制主體地形邊界顯隱。

    • 描邊樣式：設置主體地形邊界描邊的顏色和粗細。

    • 描邊動畫：設置描邊動畫的動畫混合模式、飛線長度、粗細、背景顏色、動畫顏色、動畫時長，使邊界看起來更具動態感。

  • 背景地形邊界：設置地圖中背景地形區域的邊界樣式，該邊界不會響應交互事件，可單擊圖標控制背景地形邊界顯隱。

    描邊樣式：設置背景地形邊界描邊的粗細和顏色。

  • 邊界線：表示地理特征、區域界限或數據邊界的線條樣式，可單擊圖標控制邊界線顯隱。

    • 國界：設置國界的邊界顏色、邊界粗細和混合模式。

    • 海岸：設置海岸線的邊界顏色、邊界粗細和混合模式。

    • 省界：設置省界的邊界顏色、邊界粗細和混合模式。

• 裝飾：設置地圖裝飾樣式的參數。

  • 動態裝飾：單擊圖標控制動態裝飾的顯隱。

    參數	說明
    縮放比例	設置動態裝飾的縮放比例值，取值范圍0~1。
    顏色	設置動態裝飾材質的顏色。
    紋理貼圖	設置動態裝飾材質的紋理貼圖樣式，可選四種類型的貼圖，也可以自定義上傳貼圖。
    發光顏色	設置動態裝飾材質發光顏色。
    發光強度	設置動態裝飾材質發光強度。
    旋轉速度	設置動態裝飾的旋轉速度。
    呼吸速度	設置動態裝飾的呼吸速度。

  • 背景網格：單擊圖標控制背景網格的顯隱。

    參數	說明
    材質顏色	設置背景網格材質的顏色。
    紋理貼圖	背景網格材質的紋理貼圖樣式，可選四種類型的貼圖、也可以自定義上傳貼圖。 設置在水平和垂直方向平鋪的值，填充地圖的寬度和高度。單擊圖標控制紋理貼圖的顯隱。
    發光效果	設置背景網格材質發光效果的顏色和強度，顯著增強地圖視覺效果和功能性。

• 交互：動態地和地圖內容進行互動，增強了地圖的實用性和用戶體驗。

  說明

  動態交互配置效果僅在預覽發布或開啟交互模式時可見。

  • 相機交互：通過控制虛擬相機的視角和位置來與三維場景進行互動。

    • 拖拽：開啟后單擊并按住鼠標右鍵，可以拖動平移地圖。

    • 縮放：開啟后上下滾動鼠標滑輪，可以縮放地圖的大小。

    • 旋轉：開啟后單擊并按住鼠標左鍵，可以旋轉地圖。

  • 地圖鉆取：地圖鉆取是一種交互技術，通過查看地圖的不同層級，更有效地分析和利用地理數據。

    • 上鉆：開啟后雙擊地圖的空白區域，可以上鉆一級，并將視角放大定位到上鉆后的區域中心。

    • 下鉆：開啟后雙擊地圖中的省、直轄市或地市級區域，可以下鉆并放大該區域，將其定位到地圖正中央。

  • 懸停：鼠標指針停留在地圖的某個元素上時，所觸發的交互效果。

    • 懸停比例：懸停交互效果發生變化的比例，范圍為0~1。

    • 動畫時長：完成交互動畫顯示的時間，范圍為1~5000，單位為ms。

    • 動畫類型：產品內置了線性、緩入、緩出、緩入緩出動畫效果。

  • 聚焦：改變地圖或區域的動畫屬性，增強地圖交互體驗。

    • 聚焦比例：聚焦交互效果發生變化的比例，范圍為0~1。

    • 動畫時長：完成交互動畫顯示的時間，范圍為1~5000，單位為ms。

    • 鏡頭轉場時長：鏡頭場景轉換需要的事件，范圍為1~5000，單位為ms。

    • 動畫類型：產品內置了線性、緩入、緩出、緩入緩出動畫效果。

  • 轉場動畫：通過動畫過渡地圖或視圖調整過程，提升地圖操作的連貫性。

  • 抬升動畫：通過動畫給予某些元素或區域更高的視覺優先級，使信息傳遞更加直觀和有效。

• 后處理：在地圖初步處理或渲染完成后，開啟啟用后期開關，通過后期配置提高視覺效果。

  參數	說明
  屏幕百分比	拖動滑塊，調整后期屏幕百分比的值，取值范圍為0.25~2。
  抗鋸齒類型	后期樣式中抗鋸齒的類型，可選taa和fxaa。
  taa抗鋸齒	拖動滑塊，調整taa抗鋸齒類型中的亮度變化閾值、時域混合系數和顏色范圍縮放系數的值，僅在抗鋸齒類型選擇taa時可配置。
  輝光	打開開關，可以配置輝光后期效果，包括遮罩、亮度閾值、平滑度、散射系數和強度；關閉開關，無法配置該效果。
  顏色分級	配置畫質調整內顏色分級的后期效果，包括調整顏色的曝光度、對比度、色調、飽和度和顏色濾鏡。

數據源面板

高級面板

通過高級面板配置交互事件或關聯全局變量，實現組件之間的聯動。具體操作請參見組件交互配置。

藍圖交互

1. 單擊頁面左上角的圖標，進入藍圖頁面。

2. 在圖層節點頁簽下，添加當前組件至主畫布中。

3. 查看藍圖配置參數。

   說明

   圖層事件和動作的參數提示信息，可以在畫布右側的錨點配置中單擊圖標查看。

   • 事件

     事件	說明
     當層級數據更新時	數據接口請求返回并經過過濾器處理后拋出的事件，同時拋出處理后的JSON格式的數據。具體數據示例請參見畫布編輯器中組件右側配置面板數據源頁簽的數據響應結果區域。
     當層級數據請求狀態發生改變時	當數據請求狀態變化時拋出該事件，回調參數為當前狀態，具體數據示例請參見畫布編輯器中組件右側配置面板數據源頁簽的數據響應結果區域。
     當區域下鉆時觸發	當地圖區域下鉆時觸發事件并拋出數據。
     當區域上鉆時觸發	當地圖區域上鉆時觸發事件并拋出數據。
     當區域同級切換時觸發	當地圖區域同級切換時觸發事件并拋出數據。

   • 動作

     動作	說明
     導入層級數據	按組件繪制格式處理數據后，導入組件，重新繪制。不需要重新請求服務端數據。具體數據示例請參見畫布編輯器中組件右側配置面板數據源頁簽的數據響應結果區域。
     請求層級數據	重新請求服務端數據，上游數據處理節點或圖層節點拋出的數據將作為參數。例如地圖容器配置了API數據源為https://api.test，傳到請求層級數據動作的數據為{ id: '1'}，則最終請求接口為https://api.test?id=1。
     下鉆至指定區域	通過區域編碼下鉆到地圖指定區域。參考數據示例。 { "treeID": "1", //區域樹節點編碼 "adcode": "100000" //行政區域編碼 }
     設置相機	設置相機到指定包圍盒區域的范圍，參考數據示例。 { "bbox": [ -180, //最小經度 -85, //最小緯度 180, // 最大經度 85 //最大緯度 ] }
     移動	將組件移動到指定位置，參考數據示例。 { // 移動方式。絕對定位：to，相對定位：by。默認值：to。 "positionType": "to", // 指定位置。x坐標，y坐標。 "attr": { "x": 0, "y": 0 }, // 動畫方式。 "animation": { "enable": false, // 動畫延時。 "animationDuration": 1000, // 動畫曲線。可選值為：linear|easeInOutQuad|easeInOutExpo。 "animationEasing": "linear" } }
     切換顯隱	切換顯隱、顯示和隱藏組件默認不需要參數，可以按需添加動畫配置，參考數據示例。 { //動畫方式，可選值為：appear|fade|slideToUp，默認值為 fade，不填無動畫。 "animationType": "fade", //動畫延遲，默認值為1000，單位ms。 "animationDuration": 1000, //動畫曲線，可選值為：linear|easeInOutQuad|easeInOutExpo，默認值為 linear。 "animationEasing": "linear" }
     顯示
     隱藏
     更新組件配置	動態更新組件的樣式配置。需要先在組件的樣式面板中，單擊復制配置到剪貼板，獲取組件配置數據。再根據需要在藍圖編輯器配置頁面的數據處理節點中更改對應樣式的字段值。