📍 iPhone GPS 路線模擬器

免費、免越獄、免 iTunes，在 Windows 上模擬 iPhone GPS 定位的桌面工具。支援 iOS 17 / 18 / 26+。

---

✨ 功能

• 🗺 路線移動模式 — 設定多個座標點，讓 iPhone 沿路線緩慢移動
• 📌 固定定位模式 — 將 iPhone 定位釘在指定座標不動
• ⭐ 最愛地點 — 儲存常用地點或路線，下次一鍵載入
• 🚶 速度調整 — 支援步行、慢跑、騎車、開車等速度預設
• 🔄 循環模式 — 路線走完自動從頭再走
• 📊 即時進度 — 顯示目前座標與完成百分比

---

📋 系統需求

項目	需求
作業系統	Windows 10 / 11
Python	3.11 64-bit 以上
iPhone	iOS 17 / 18 / 26+
連線方式	USB（不需 iTunes）

---

🚀 安裝步驟

1. 安裝 Python 3.11 64-bit

前往 python.org 下載並安裝，記得勾選 Add Python to PATH。

2. 安裝相依套件

pip install pymobiledevice3

3. 下載本專案

git clone https://github.com/你的帳號/iphone-gps-simulator.git
cd iphone-gps-simulator

---

▶️ 使用方式

Step 1：iPhone 開啟開發者模式

設定 → 隱私與安全性 → 開發者模式 → 開啟（需重開機）

Step 2：啟動 tunneld（需系統管理員）

以系統管理員開啟命令提示字元：

pymobiledevice3 remote tunneld

等到出現以下訊息後保持視窗開著：

INFO: Uvicorn running on http://127.0.0.1:49151

Step 3：執行 App

開新的命令提示字元：

python gps_app.py

---

🖥️ 介面說明

路線移動模式

1. 在座標表格中輸入路線點（緯度、經度、備註）
2. 選擇移動速度
3. 按「▶ 開始模擬」
4. 按「⏹ 停止」恢復真實定位

固定定位模式

1. 切換到「📌 固定定位」模式
2. 輸入緯度/經度，或使用快速選擇
3. 按「📌 固定定位」
4. 按「⏹ 停止」恢復真實定位

最愛地點

• 點「＋ 儲存目前路線」或「＋ 儲存目前座標」儲存
• 點「載入」一鍵套用
• 資料儲存於 gps_favorites.json，重開 App 後保留

---

📁 檔案結構

iphone-gps-simulator/
├── gps_app.py          # 主程式（GUI App）
├── requirements.txt    # 相依套件
├── gps_favorites.json  # 最愛地點資料（自動產生）
└── README.md

---

⚠️ 注意事項

• 本工具僅供學習、測試用途
• 部分遊戲或 App 有反作弊機制，使用需自行承擔風險
• 停止模擬後 iPhone 會自動恢復真實定位

---

🛠️ 技術說明

本專案使用 pymobiledevice3 與 iPhone 通訊。

iOS 17+ 需透過 RemoteXPC tunnel 連線，因此需要先啟動 tunneld 服務建立加密通道，再透過 DVT（Developer Tools）的 LocationSimulation 服務注入模擬座標。

---

📄 License

MIT License