📍 GeoSentry

Location-Based Alarm System with AI-Powered Place Search

An intelligent location-based alarm system that helps you monitor proximity to places and get notified when you're near your destinations.

---

✨ Features

• 🗺️ AI-Powered Place Search - Use Google Gemini AI to search and find locations
• 📡 Real-Time GPS Tracking - Continuous location monitoring with high accuracy
• 🎯 Distance-Based Alarms - Set alarms based on distance (meters)
• ⏱️ Time-Based Alarms - Set alarms based on estimated travel time (walking/driving)
• 📊 Visual Radar Display - Interactive radar view showing all monitored locations
• 🔔 Smart Notifications - Browser notifications when alarms trigger
• 🔊 Audio Alerts - Sound alerts for proximity warnings
• 📱 Progressive Web App - Works on mobile and desktop browsers
• 🌙 Dark Theme UI - Beautiful dark-themed interface
• 📍 Google Maps Integration - Direct links to view places on Google Maps

🚀 Getting Started

Prerequisites

• Node.js (v18 or higher)
• npm or yarn
• Google Gemini API Key (Get one here)

Installation

1. Clone the repository

   git clone https://github.com/toozuuu/GeoSentry.git
   cd GeoSentry

2. Install dependencies

   npm install

3. Configure API Key

   Get a Gemini API key from Google AI Studio

   Create src/environments/environment.ts (it's in .gitignore for security):

   export const environment = {
     production: false,
     apiKey: 'YOUR_GEMINI_API_KEY_HERE'
   };

   For production builds, also create src/environments/environment.prod.ts:

   export const environment = {
     production: true,
     apiKey: 'YOUR_GEMINI_API_KEY_HERE'
   };

4. Run the development server

   npm run dev

   The app will be available at http://localhost:3000

Building for Production

npm run build

The production build will be in the dist/geosentry/browser directory.

📖 Usage

1. Allow Location Access - Grant the browser permission to access your location
2. Search for Places - Use the search bar to find locations using AI-powered search
3. Select a Destination - Click on a search result to select it
4. Set Alarm Type - Choose between:
   • Distance: Trigger when within X meters
   • Walking Time: Trigger when X minutes away by walking
   • Driving Time: Trigger when X minutes away by driving
5. Adjust Threshold - Use the slider to set your desired distance/time
6. Set Alarm - Click "Set Alarm" to start monitoring
7. Monitor - Watch the radar display and receive notifications when approaching

🏗️ Project Structure

geosentry/
├── src/
│   ├── app/
│   │   ├── components/
│   │   │   └── radar/          # Radar visualization component
│   │   ├── home/               # Home page component
│   │   ├── services/
│   │   │   ├── geo.service.ts  # Geolocation services
│   │   │   └── gemini.service.ts # AI place search service
│   │   ├── app.component.ts    # Root component
│   │   └── app.routes.ts       # Route configuration
│   ├── assets/                 # Static assets
│   ├── environments/           # Environment configurations
│   ├── types.ts               # TypeScript type definitions
│   ├── index.html             # Application entry point
│   └── main.ts                # Application bootstrap
├── angular.json               # Angular configuration
├── package.json               # Dependencies and scripts
└── tsconfig.json             # TypeScript configuration

🛠️ Tech Stack

• Angular 18 - Application framework
• Ionic 8 - UI component library
• TypeScript - Programming language
• Google Gemini AI - AI-powered place search
• RxJS - Reactive programming
• Tailwind CSS - Utility-first CSS framework

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Google Gemini AI for the powerful place search API
• Ionic Framework for the amazing UI components
• Angular team for the robust framework

🔒 Security

See SECURITY.md for security policy and vulnerability reporting guidelines.

📚 Additional Documentation

• Contributing Guide - Guidelines for contributing
• Code of Conduct - Community behavior standards
• Changelog - Version history and updates

🤔 FAQ

Q: Does this work offline?
A: Basic location tracking works, but place search requires an internet connection for the Gemini API.

Q: How accurate is the GPS tracking?
A: Accuracy depends on your device's GPS capabilities. The app uses high-accuracy mode for best results.

Q: Can I use this without an API key?
A: No, the Gemini API key is required for the AI-powered place search feature.

Q: Is my location data stored?
A: No, all location data is processed locally in your browser. No location data is sent to external servers except for place search queries.

📧 Contact

Project Link: https://github.com/toozuuu/GeoSentry

Issues: https://github.com/toozuuu/GeoSentry/issues

---

Made with ❤️ using Angular and Ionic

⭐ Star this repo if you find it helpful!