RouteSnap

# Google Maps 路線擷取工具 (RouteSnap) 此小工具能幫助您從 Excel 上讀取「起始地點、目的地點」的列表，然後自動在 Google Maps 開啟每一組路線頁面、擷取截圖，並可額外抓取「最小里程數」，將其加到檔名中一起存檔。如此就不需手動切換地圖頁面、手動截圖或命名。 ## 功能特色 1. **批次處理**：從 Excel 讀取多組（檔名、起始地點、目的地點），一次開啟多個 Google Maps 分頁並擷取。 2. **自動命名**：截圖檔名可包含自訂名稱及（可選）抓取的「最小公里數」。 3. **自動關閉分頁**：截完圖後不會留一堆 Google Maps 分頁。 4. **免背景程式**：主要邏輯都在選項頁 (options.html) 執行，操作簡單直接。 --- ## 如何使用 1. **安裝與權限設定** - 在 Chrome 瀏覽器中，開啟 `chrome://extensions/`。 - 點擊「載入未封裝項目」或「重新載入」(若您已經載入過此擴充)，選擇包含 `manifest.json`、`options.html`、`popup.html`、`options.js`、`popup.js` 等檔案的資料夾。 - 確保在 `manifest.json` 中宣告了必要的權限（例如 `"activeTab"`, `"tabs"`, `"host_permissions"`）並已經 **重新載入** 擴充功能。若需要額外權限，Chrome 會請您手動允許。 2. **打開選項頁 (options.html)** - 點擊瀏覽器右上角的擴充功能圖示 → 會出現 `popup.html` → 裡面僅有按鈕「開啟選項頁」(或其他介面)。 - 按下按鈕後，瀏覽器將打開 `options.html`。 - 請勿關閉此頁，在這裡可以長時間執行批次程式，避免像 popup 一樣被切走就關閉。 3. **上傳 Excel** - 在 `options.html` 裡，點「選擇檔案 (Excel)」按鈕 (`uploadExcel`)。 - 選擇一份 **.xlsx** 格式的檔案，該檔案內容至少包含三欄（「檔名」、「起始地點」、「目的地點」）。 - 例如： ``` | 檔名 | 起始地點 | 目的地點 | |--------|-----------|-----------| | route1 | 台北車站 | 高雄火車站 | | route2 | 台中 | 日月潭 | ``` - 成功讀取後，網頁會顯示 `✅ 成功讀取 X 筆地址！`。 4. **執行批次擷取** - 按下「開始擷取」按鈕 (`startCapture`)。 - 工具會一次開啟多個 Google Maps 分頁（每個分頁對應一組「起始地點 → 目的地點」）。 - 依序切換到各個分頁、擷取截圖(並可抓取最小里程)，最後自動關閉分頁。 - 處理完成後，網頁會顯示「全部截圖完畢！」，同時您可以在下載資料夾中看到多張 PNG 圖檔。 5. **查看截圖結果** - 在瀏覽器預設的「下載」資料夾，您會發現擷取到的 PNG 檔案。 - 如果有抓取「最小里程數」，會以 `檔名_公里數.png` 的方式命名，例如 `route1_24.8.png`。