Description from extension meta
自動擷取 Google Maps 路線截圖。
Image from store
Description from store
# 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`。