Workflow Note · 數位人文工具手記

把「籍貫」
變成一組經緯度

這個小工具的使用流程—— 比對地名規範資料庫的 XML 節點,把籍貫編碼轉換成可標繪於地圖上的座標, 最後輸出一份補齊經緯度欄位的 Excel。

來源
DILA 開放內容專案
資料格式
XML / TEI → Excel
核心欄位
籍貫編碼 → 經度・緯度
籍貫
座標
提取
STEP 01
下載地名規範資料庫 XML
STEP 02
準備含籍貫編碼的 Excel
STEP 03
上傳工具,自動比對座標
STEP 04
匯出經緯度結果 Excel
§ MAP 畫面對畫面:檔案該丟進哪一格

不必憑空猜測欄位怎麼對應——下載回來的 XML、手邊的 Excel,各自該拖進工具的哪一個匯入框, 直接用畫面連起來看最清楚。

authority_place.zip → E 欄「籍貫編碼」→
下載回來的 authority_place.zip(地名規範資料庫 XML)解壓縮後,拖進工具左側「XML 檔案」框。
含有「籍貫編碼」欄位(E 欄,如 PL000000010197)的原始 Excel,拖進工具右側「Excel 檔案」框。
§ 01–04 操作流程

整個流程分成四個階段:先取得官方地名規範資料庫,再確認手邊 Excel 已含籍貫編碼, 接著交給比對工具自動處理,最後拿回一份補上座標的成果檔。

01
DOWNLOAD SOURCE

下載地名規範資料庫(Place Authority)

至 DILA 開放內容專案的 Downloads 頁面,在「Place Authority」區塊下載當月版本的 authority_place.zip,解壓縮後即為 XML/TEI 格式的地名規範資料, 每筆地名節點皆以 <place xml:id="..."> 標記,並可能內含 <geo cert="high"> 座標資訊。

Open Content Project Downloads 頁面,標示人名與地名規範資料庫下載位置
Open Content Project · Downloads — Place Authority
02
PREPARE EXCEL

確認 Excel 內含籍貫編碼欄位

工具比對的關鍵是「籍貫編碼」——形如 PL000000010197 的地名規範碼。 只要來源 Excel 中有這一欄,工具就能拿它去 XML 中查找對應的地名節點, 人名與人名規範碼欄位則不影響比對,可一併保留於原表。

Excel 表格範例,欄位包含人名、人名規範碼、籍貫、籍貫編碼
來源 Excel 範例 — 人名 · 人名規範碼 · 籍貫 · 籍貫編碼
B 欄 人名 C 欄 人名規範碼 D 欄 籍貫 E 欄 籍貫編碼 ← 比對依據
03
MATCH & EXTRACT

上傳工具,執行自動比對

開啟「籍貫座標提取工具」,分別匯入 Step 01 的 XML 檔案與 Step 02 的 Excel 檔案, 選定包含籍貫編碼的欄位後,工具即依編碼自動查找、擷取座標並整理成預覽表。

籍貫座標提取工具介面,左右兩側分別上傳 XML 檔案與 Excel 檔案
籍貫座標提取工具 — 匯入介面
  • 匯入檔案 分別上傳 XML 檔案與 Excel 檔案
  • 選擇欄位 上傳 Excel 後,選擇包含籍貫編碼(如 PL000000010197)的欄位
  • 自動比對 依編碼於 XML 中查找對應的 <place xml:id="..."> 節點
  • 提取座標 優先擷取 <geo cert="high"> 中的經緯度數值
  • 顯示統計 列出總筆數、成功比對數、未找到數
  • 預覽結果 表格顯示籍貫編碼、地名、經度、緯度
  • 匯出 Excel 下載含經度、緯度欄位的結果檔
  • 貼回大表 將結果貼入原始 Excel 的大表當中
04
EXPORT RESULT

匯出結果,回填籍貫經緯度

點擊「匯出 Excel」下載比對結果,內容涵蓋籍貫編碼、地名、經度、緯度四欄, 可直接貼回原始大表,讓每一位人物的籍貫從此有了可標繪於地圖上的座標。

§ RESULT 最終成果:籍貫經緯度對照表

四個步驟結束後,原本只有地名文字的籍貫欄位,多了一組可供地理標繪、 空間分析使用的經緯度數值。

人名 籍貫 籍貫編碼 經度 緯度
真覺 昆山 PL000000010197 120.9756 31.3826
藕益智旭 木瀆 PL000000010106 120.4536 31.2661
袾宏 仁和 PL000000011507 120.1551 30.2741
示意數值僅供版面呈現,實際經緯度以工具依 XML 中 <geo cert="high"> 節點擷取之結果為準。