足跡

兩個版本 ​

• 官方疆界底圖（頁面上方內嵌的就是這張）：高德地圖瓦片，國界按中國官方標準，藏南、阿克賽欽、南海諸島完整；點位在頁面內自動做 WGS-84 → GCJ-02 對齊，換成其他底圖時再自動還原。
• OSM 底圖：OpenStreetMap 標準瓦片，國際通用畫法（藏南按麥克馬洪線繪製），點位為 WGS-84 原樣。

兩份都是單檔 HTML（Leaflet 與全部點位資料內嵌，約 230 KB），可以直接下載保存、離線打開；只有底圖瓦片需要連網。右上角圖層按鈕可在三種底圖間切換（高德／OSM／Esri 衛星）。

地圖操作 ​

• 年份滑桿：16 檔（2012年7月前、2012…2026）。播放 每年自動前進一格，回到起點 重頭看。
• 當年新增是紅色脈衝大圓點，之前的年份是彩色小圓點（顏色＝首訪年份，見圖例）。
• 點任一圓點看地名、首次到訪日期、省份與合併說明；滑過可看名稱。

資料來源與規則 ​

• 行程：行程表.xlsx「主表 (2)」。年份向下填充，月份／日期只在同一年度內填充（跨年不繼承），刪空行，繁轉簡，去 * 與空格。
• 地點鍵：地級＋縣級；縣級為空則用地級；國外保留原名。
• 中國縣級邊界：銳多寶（CTAmap）；國外縣級：GADM 4.1 ADM2；兩者都對不上時用 Nominatim 地理編碼（請求間隔 1 秒並快取）。
• 點位：縣級面內代表點（equivalent of ArcGIS 的 Feature to Point），不是行政中心，所以會落在多邊形內部。
• 時間分檔：2012 年 7 月以前統一歸入「2012年7月前」。

怎麼更新 ​

1. 改 行程表.xlsx 後，在 D:\Zcodeproject\footstep_work 依次跑 step1_clean.py → step3_match_china.py → step3b_download_counties.py → step6_build_outputs.py（其餘步驟有快取，通常不用重跑）。
2. 把新產生的 footstep_points.json 覆蓋到本站 tools/footstep/。
3. 在專案根目錄跑 py tools/footstep/build-map-html.py docs/public/footstep，兩個版本會一起重新生成。