地圖配置

1.1 版本

1.2 應用場景

FineReport 設計器支援使用地圖展示與地理位置相關的資料資訊，而地理位置匹配的資訊則是透過「地圖配置」來決定的。

我們可以透過「地圖配置」功能自訂地圖邊框和 GIS 圖層，在設計器中選擇對應的「地圖邊框」即可。

注1：11.0.6 版本對地圖進行了一系列優化，為保證預覽效果，建議使用 Chrome 瀏覽器。

注2：11.0.6 版本及之後的「地圖配置」介面，需網路連結請求高德 API 資源，否則地理資訊、自訂圖片圖層無法顯示。

內網情況下開放標準樣式的高德 api 白名單域名可使用：webapi.amap.com 、vdata.amap.com 、restapi.amap.com 。

內網其餘情況可安裝 內網支援自訂地圖 插件使用，詳情請參見 內網支援自訂地圖插件 。

1.3 功能簡介

1）在設計器中點選「伺服器>地圖配置」，登入數據決策系統，即可直接跳轉到地圖配置介面。如下圖所示：

2）在設計器中點選「伺服器>報表平台管理」，登入數據決策系統，在「管理系統」下點選「地圖設定」功能。如下圖所示：

3）「地圖配置」中共有三個配置頁面，分別為：

• 地理資訊：可以自訂地圖區域邊框和點的資訊。

• 自訂圖片：使用自訂的圖片作為地圖邊框。

• 自訂 GIS 圖層：可以新增預定義 GIS 圖層。

注：11.0.6 版本設計器新增「中國行政區」檔案，需更新 地圖檔案資源 後使用。

地理資訊介面如下圖所示：

對應標號區域的功能說明如下表所示：

2.1 建立/複製目錄

要自訂一個新地圖邊框，首先要建立或複製一個目錄，設定新邊框的名稱。

2.1.1 新增目錄

新增目錄時，需選中一個已有的目錄作為父級目錄，再點選目錄右上角的新增按鈕新增目錄，設定名稱後點選確定。如下圖所示：

新增的目錄在「父級目錄」下，沒有任何地理資訊。如下圖所示：

2.1.2 複製目錄

複製目錄時，需選中你想要的地理資訊目錄，在彈出框中設定新目錄的「檔案名稱」和「父級目錄」，最後點選確定即可。如下圖所示：

注：不支援連同子目錄一起復制，僅支援複製選中的目錄檔案。

複製的目錄檔案，包含原目錄檔案的地理資訊。如下圖所示：

2.2 地圖編輯工具

2.2.1 選區工具

選中剛剛建立的目錄，在地圖編輯框中選擇選區工具，按照工具提示轉列自訂區域，轉列完成時會彈出預設區域名和中心點的配置框，可自行修改。

多邊形、矩形、圓形選區工具操作示範視頻如下所示：

2.2.2 合併區域

若地圖中有可選的區域，在選擇「合併」工具後，可點選地圖中的區域或勾選區域列表中的區域進行合併。操作示範視頻如下所示：

注：不支援取消合併，在沒有點選右上角「儲存」之前，可使用「重置」恢復到修改前的狀態。

2.2.3 編輯/刪除工具

若地圖中有可編輯的區域，選擇「編輯」工具後，可對區域形狀、大小等進行修改。選擇「刪除」工具後，點選區域刪除，點選「完成」即刪除成功。

操作示範視頻如下所示：

2.2.4 標記點工具

同一個目錄的「區域」和「點」類型互不影響，若要改變點地圖資訊，選中目錄後再選擇「點」修改即可。點地圖無選區工具、合併區域工具，支援標記點工具。

如下圖所示：

2.3 儲存/重置

配置完成後，點選右上角「儲存」按鈕，自訂的地理資訊會生成兩個 JSON 檔案儲存到%FR_HOME%\webapps\webroot\WEB-INF\assets\map\geographic\對應目錄下，分別是 名稱-area.json 和 名稱-point.json，如下圖所示：

所以在「儲存」後，重置不再生效；在「儲存」之前，點選「重置」可恢復到修改之前的狀態。

2.4 同步地理檔案

在 %FR_HOME%\webapps\webroot\WEB-INF\assets\map 目錄下，手動新增、刪除或修改 geographic (地理檔案)、image（自訂圖片）及其任意 JSON 檔案內容，需要進入「地圖配置」，點選右上角「同步地理檔案」按鈕，設計器中才能生效。

遠端設計 時，這些 json 檔案可以直接copy到伺服器端使用，注意需要同時將「名稱-area.json」和「名稱-point.json」檔案一起copy到伺服器端webroot\WEB-INF\assets\map目錄下的相同資料夾位置下。

copy完成後，同樣需要「同步地理檔案」，還需要點選設計器中地圖類型下的「重新整理」按鈕。如下圖所示：

自訂圖片：即把一張圖片作為地圖邊框，然後可以在圖片中轉列區域或者點。

注：上傳圖片大小限制為 2M，也就是 Tomcat 預設 post 大小限制，使用者可自行設定為不限制圖片大小，設定方法參見文檔：WangEditor富正文元件插件 第 4 節的內容。

詳細的介紹和範例可以參見文檔 自訂圖片作為地圖邊框 的說明。

3.1 新增目錄

自訂圖片僅支援建立目錄，不支援複製目錄。同樣需要先選擇一個父級目錄，再點選新增按鈕新增目錄。如下圖所示：

選中建立的新目錄，點選「匯入圖片」即可。如下圖所示：

3.2 編輯工具

自訂圖片中，編輯工具支援放大、縮減、多邊形選區、矩形選區、圓形選區、標記點、合併區域、編輯和刪除。使用方法與「地理資訊」中的工具相同，可參考第 2 章的操作示範視頻。

配置完成後，同樣點選「儲存」按鈕進行儲存，生成的 JSON 檔案儲存在 %FR_HOME%\webapps\webroot\WEB-INF\assets\map\image 目錄下。

3.3 注意事項

問題描述：

自訂圖片的地圖，在範本預覽時，圖片不顯示

原因分析：

圖片快取在檔案伺服器的/WEB-INF/assets/temp_attach下

由於伺服器網路環境異常等因素，導致工程節點與檔案伺服器連結失敗，進而無法讀取到資源檔案

解決方案：

超級管理者可透過「fine_conf_entity視覺化配置插件」設定臨時資源附件儲存位置。重啟伺服器後設定生效。

注：修改 FineDB 資料庫表欄位值的方法請參考 fine_conf_entity視覺化配置 。

GIS 圖層包含了世界範圍內諸如省市區行政劃分、道路交通、邊框劃分等資訊，且不同的 GIS 圖層對應的地圖風格不同。

在決策系統中支援自訂 GIS 圖層，可以作用於當前伺服器下的所有地圖。

自訂 GIS 圖層有以下 4 種方式：

5.1 資源下載

此處提供一些自訂的 JSON 資源可直接下載copy到對應目錄下使用，檔案中包含 FineReport 自帶的一些 JSON 和使用者自願上傳的 JSON。

如果使用者自訂 JSON 資源時，只自訂了其中一個 JSON 檔案，需手動新增另一個 JSON 檔案，再到地圖配置中「同步地理檔案」。

此處提供兩個空的 JSON 檔案：空JSON檔案.zip，使用時將名稱修改為自已定義的名稱即可。

注：如果有自願提供自己自訂的 JSON 地圖的，可在 論壇發帖 ，若被採納會給予 F 幣獎勵。 

5.2 JSON 檔案格式

除了在前端製作地圖的方式外，還可以後台直接編寫，具體 JSON 格式如下所示：

注：若使用者自己編寫地圖 JSON，需要注意：地圖中心點計算規則 。

5.2.1 區域地圖

5.2.2 點地圖

5.3 載入資源

1）將JSON檔案放在工程webapps\webroot\WEB-INF\assets\map\image資料夾下

2）在數據決策系統中，點選「管理系統>地圖配置>同步地理檔案」即可。

6.1 遷移舊地圖到新工程

舊伺服器上的地圖自訂過背景、圖層時，若希望把舊伺服器上的地圖遷移到新部署的伺服器，可將舊伺服器中%FR_HOME%\webapps\webroot\WEB-INF\assets中所有檔案複製貼上到新伺服器相同路徑下，在「決策系統>地圖配置」中點選「同步地理檔案」即可。

6.2 地市內區縣資訊消失

如果如下圖修改了地市名，那麼地市內的區縣資訊都會消失。

此時可以參考文檔  地圖檔案資源更新 獲取新的 map 檔案資源並更換。 

6.3 其他

• 內建中國地圖 JSON 檔案行政劃分獲取的是國家統計局程式碼：http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/2020/index.html
  其中台灣省、香港特別行政區和澳門特別行政區，獲取的是民政部資料：http://xzqh.mca.gov.cn/map

• 如果所在地有新的行政劃分，但國家統計局還未更新資料，請先自訂 JSON 處理，並在文檔下方評論或反饋給技術支援，每個季度將進行一次統一反饋到 JSON 廠商處理。