GPS-Case

📍 GPS-Case — Unity GPS Mini-Map & Movement Simulation

A Unity project built for the CodeMiner Technical Assessment, showcasing real-time GPS-based character movement inside a 3D environment.  

Experience live location updates, a mini-map overlay, FPS camera mode, and mobile testing support — all directly in your browser via WebGL.

---

✨ Features

- 🌍 1:1 Scaled 3D World (10,000 m² real-world area)  

- 👤 Character Simulation (180 cm tall, updated every 3 seconds via GPS)  

- 🧭 Mini-Map Overlay with:  

  - Current Coordinates (live per-frame)  

  - Last Updated Coordinates (stable 3-second updates)  

- 🎥 First-Person Camera for immersive testing  

- 🔄 Reset Location Button — snap back to your starting GPS point  

- 📱 Mobile Ready — tested on Android & iOS  

- 🛠️ Accuracy Handling — filters jitter & snaps to paths when GPS is weak  

---

🎮 How to Play

1. Click Run Game above.  

2. Allow location permissions in your browser.  

3. Walk or move around — your in-game character updates every 3 seconds.  

4. Use the mini-map to track your position.  

5. Hit the Reset Location button if you get lost.  

⚠️ Note: On desktop browsers without GPS, a mock GPS provider feeds test data. On mobile, your real location is used.

---

🚀 Tech

- Unity: 2022.3.62f1 LTS  

- Language: C#  

- Platforms: WebGL, Android, iOS  

- Architecture: SOLID, composition-first, dependency injection  

---

🔧 Troubleshooting

- Character jitter while stationary → raise GPS jitter cutoff in config  

- No GPS updates → ensure location permissions are enabled  

- WebGL errors → confirm browser supports GPS & WebGL2  

---

🙌 Credits

- Developed for the CodeMiner Technical Assessment 

- Powered by Unity 2022.3 LTS

- Community & Unity Docs for support  

👉 [Source Code on GitHub]