本文檔對(duì)DataV基礎(chǔ)平面地圖組件的一鍵遷移功能進(jìn)行詳細(xì)說明，幫助您快速了解基礎(chǔ)平面地圖從1.x版本遷移到2.x版本之后的差別。
什么是一鍵遷移
簡(jiǎn)而言之，這是一個(gè)將最新版基礎(chǔ)平面地圖1.x 組件升級(jí)到基礎(chǔ)平面地圖2.x的過程。
在您單擊一鍵遷移按鈕后，DataV會(huì)在不影響舊版基礎(chǔ)平面地圖1.x的基礎(chǔ)上，按照舊版組件的配置為您創(chuàng)建出全新的基礎(chǔ)平面地圖2.x組件。
說明
- 一鍵遷移組件的過程是一個(gè)添加組件的過程，而不是新版組件直接覆蓋舊版組件的過程。
- 被遷移新添加出來的基礎(chǔ)平面地圖2.x組件不會(huì)影響到您當(dāng)前的可視化應(yīng)用和舊版組件。
一鍵遷移具體操作步驟
首先確保您的可視化應(yīng)用中已添加的是基礎(chǔ)平面地圖1.x版本組件。
- 在畫布編輯器內(nèi)，單擊畫布中的基礎(chǔ)平面地圖1.x組件。
- 在右側(cè)配置面板中，單擊名稱右側(cè)的更新版本按鈕（
）。
說明 如果您的可視化應(yīng)用中的基礎(chǔ)平面地圖組件已經(jīng)是最新1.x版本，則可以忽略此步驟。 - 更新基礎(chǔ)平面地圖1.x組件（包括所有子組件）完成后，單擊名稱右側(cè)的一鍵遷移按鈕。
- 在查看遷移時(shí)出現(xiàn)的對(duì)話框中的注意事項(xiàng)等內(nèi)容后，單擊右下角的遷移按鈕。
- 單擊對(duì)話框右下角的確定按鈕，完成基礎(chǔ)平面地圖組件的遷移。
- 完成遷移后可視化應(yīng)用中會(huì)新增一個(gè)名為基礎(chǔ)平面地圖-2.0版的全新地圖組件。
一鍵遷移功能有哪些適用對(duì)象
當(dāng)您遇到如下情況時(shí)建議使用一鍵遷移功能。
當(dāng)您的可視化應(yīng)用已經(jīng)添加了基礎(chǔ)平面地圖1.x組件，且當(dāng)前基礎(chǔ)平面地圖1.x滿足不了您目前對(duì)該組件的需求，甚至您對(duì)該組件已經(jīng)配置了特別復(fù)雜的配置項(xiàng)，難以通過直接添加基礎(chǔ)平面地圖2.x來復(fù)原舊版的配置時(shí)。
哪些情況不需要使用一鍵遷移功能
當(dāng)您遇到如下幾種情況時(shí)不建議使用一鍵遷移功能。
- 您的可視化應(yīng)用中原先沒有添加基礎(chǔ)平面地圖1.x組件，如現(xiàn)在有需要添加時(shí)，您可以從組件列表中添加一個(gè)基礎(chǔ)平面地圖2.x新組件。
- 您可視化應(yīng)用中的基礎(chǔ)平面地圖1.x沒有過多的配置內(nèi)容過，甚至不太想要這個(gè)舊版組件時(shí)，可以刪除舊版組件，然后從組件列表中添加一個(gè)基礎(chǔ)平面地圖2.x新組件。
- 您可視化應(yīng)用中的基礎(chǔ)平面地圖1.x版本組件目前功能足夠滿足需求時(shí)。
- 您可視化應(yīng)用中的基礎(chǔ)平面地圖組件，目前還沒升級(jí)到最新版，說明您還未體驗(yàn)過基礎(chǔ)平面地圖1.x版本的全部功能。此時(shí)建議您慎重選擇一鍵遷移功能，可以先體驗(yàn)完基礎(chǔ)平面地圖1.x版的全部功能，如果感覺功能依舊不夠滿足需求的情況下再進(jìn)行遷移。
新舊版本功能差異
| 功能說明 | 基礎(chǔ)平面地圖1.x版本 | 基礎(chǔ)平面地圖2.x版本 |
|---|---|---|
| 性能 | 最多只支持5000個(gè)散點(diǎn)。 | 極致的渲染性能，新增離屏渲染、緩存幀動(dòng)畫和算法加速等，能支持10W+的散點(diǎn)，極大的提升了繪制和交互的性能。 |
| 配置項(xiàng) | 按業(yè)務(wù)需求進(jìn)行的配置項(xiàng)。 | 更通用、科學(xué)的配置項(xiàng)梳理。 |
| 層級(jí)調(diào)整 | 添加后沒法進(jìn)行層級(jí)修改。 | 更科學(xué)的層級(jí)排布，可隨意拖拽層級(jí)。 |
| 子組件支持 | 所有1.x版本子組件，包括：高德在線底圖、區(qū)域熱力層、呼吸氣泡層、區(qū)域下鉆熱力層、飛線層、網(wǎng)格熱力層、點(diǎn)熱力層、背景層、等值面層、線熱力層、點(diǎn)聚合、散點(diǎn)層、流式氣泡層和底圖層。 | 除了包含1.x版本所有子組件外，額外新增了：高性能矢量散點(diǎn)層、高性能圖標(biāo)散點(diǎn)層、文字標(biāo)注層、蜂窩熱力層與網(wǎng)格熱力層。 |
| 子組件可見級(jí)別控制 | 不支持當(dāng)父組件縮放到某個(gè)級(jí)別時(shí)，此子組件是否可見。 | 支持當(dāng)父組件縮放到某個(gè)級(jí)別時(shí)，此子組件是否可見。 |
一鍵遷移注意事項(xiàng)和指導(dǎo)修復(fù)
以下情況在遷移之前需要特別注意：
- 您對(duì)舊版基礎(chǔ)平面地圖組件配置的藍(lán)圖交互并不會(huì)隨著組件一起遷移，藍(lán)圖的配置需要您在遷移后的新版組件內(nèi)重新配置。（考慮到藍(lán)圖功能眾多，如果跟著遷移會(huì)帶來風(fēng)險(xiǎn)）。
- 您的hook也不會(huì)隨著舊版基礎(chǔ)平面地圖組件一起遷移。
- 如果您的可視化應(yīng)用正在使用中，并且還未創(chuàng)建快照，建議您遷移前先打開快照功能，以防遷移后的新組件影響您可視化應(yīng)用的使用。
以下情況在遷移之后需要根據(jù)指導(dǎo)來修復(fù)：
- 點(diǎn)聚合層： 新版和舊版的點(diǎn)聚合層子組件布局看起來不一致了。新版點(diǎn)聚合算法進(jìn)行了優(yōu)化，對(duì)所有點(diǎn)位進(jìn)行網(wǎng)格化處理，并統(tǒng)計(jì)每個(gè)網(wǎng)格內(nèi)的點(diǎn)位數(shù)量，性能比舊版本點(diǎn)密度算法更高，視覺布局效果也更佳合理。
- 背景層：背景層子組件如果使用的是simple坐標(biāo)參考系，不支持升級(jí)。新版基礎(chǔ)平面地圖組件目前只支持GCJ-02坐標(biāo)系，不再兼容通過子組件修改地圖坐標(biāo)系為simple坐標(biāo)參考系。自定義坐標(biāo)系后續(xù)規(guī)劃中。