Location-Tracker/README.md

# Location Tracker App

A comprehensive .NET MAUI application that tracks user location and displays it as an interactive heat map using OpenStreetMap integration and SQLite database storage.

## Application Overview

The Location Tracker App is a cross-platform mobile application built with .NET MAUI that provides real-time location tracking with advanced heat map visualization. The app uses OpenStreetMap for map display, eliminating the need for Google Maps API keys while providing rich, interactive mapping capabilities.

## Key Features

- **Interactive Maps**: OpenStreetMap integration with Leaflet.js for detailed map display
- **Real-time Location Tracking**: Continuous GPS tracking with configurable accuracy
- **Heat Map Visualization**: Color-coded intensity display based on location frequency
- **SQLite Database**: Local data persistence with Entity Framework Core
- **Location Analytics**: Track and analyze movement patterns
- **Modern UI**: Clean, intuitive interface with responsive design
- **Privacy-Focused**: No external API dependencies for map display
- **Cross-Platform**: Works on Android, iOS, and macOS
- **Data Management**: Clear data, load data, and session management
- **No API Keys Required**: Free map service without Google Maps dependencies
- **Background Tracking**: Continuous location monitoring with battery optimization
- **Export Capabilities**: Share location data and routes

## Application Screenshots

### Main Application View
![Map View](assets/Map%20view.png)
*The main application interface showing the interactive map with location tracking controls*

### Location Found Dialog
![Center Map](assets/Center%20map.png)
*Location detection and map centering functionality with coordinate display*

### App Demo
![App Working](assets/App%20working.gif)
*Animated demonstration of the application's core features and functionality*

### Additional Screenshots
![App Screenshot](assets/app_screenshot.png)
*Application running on Android emulator*

![Heat Map](assets/final_heatmap_screenshot.png)
*Complete heat map display*

![Cleared Demo](assets/cleared_demo_screenshot.png)
*Application after clearing demo data*

![Updated UI](assets/updated_ui_screenshot.png)
*Updated user interface with new controls*

![OpenStreetMap](assets/openstreetmap_screenshot.png)
*OpenStreetMap integration*

![OpenStreetMap Centered](assets/openstreetmap_centered_screenshot.png)
*Map centered on current location*

## Technical Architecture

### Technology Stack
- **Framework**: .NET MAUI (.NET 9.0)
- **Database**: SQLite with Entity Framework Core
- **Maps**: OpenStreetMap with Leaflet.js
- **Architecture**: MVVM (Model-View-ViewModel)
- **Dependency Injection**: Built-in .NET DI container
- **Background Processing**: Non-blocking location updates
- **Event-Driven Architecture**: Real-time location events

### Project Structure
```
LocationTrackerApp/
├── Components/           # Custom map components
│   └── OpenStreetMapView.cs
├── Data/                # Database context
│   └── LocationDbContext.cs
├── Models/              # Data models
│   └── LocationData.cs
├── Services/            # Business logic services
│   ├── ILocationService.cs
│   ├── LocationService.cs
│   ├── IConfigurationService.cs
│   └── ConfigurationService.cs
├── ViewModels/          # MVVM view models
│   └── MainViewModel.cs
├── Views/               # UI views
│   ├── MainView.xaml
│   └── MainView.xaml.cs
├── Platforms/           # Platform-specific configurations
│   ├── Android/
│   └── iOS/
├── MainPage.xaml        # Main application page
├── MainPage.xaml.cs     # Main page code-behind
└── Configuration files  # appsettings.json, etc.
```

### Key Components

#### LocationData Model
Represents a location data point with:
- Latitude/Longitude coordinates
- Accuracy, altitude, and speed
- Timestamp and session ID
- Optional notes

#### LocationService
Handles location tracking with:
- Continuous location updates
- Permission management
- Background tracking capabilities
- Event-driven architecture

#### OpenStreetMapView
Custom map component featuring:
- Heat map visualization with intensity-based coloring
- Interactive map controls
- Real-time location pins
- WebView-based rendering with Leaflet.js

#### MainViewModel
MVVM view model providing:
- Command bindings for UI interactions
- Property change notifications
- Location tracking state management
- Data persistence operations

## Getting Started

### Prerequisites
- Visual Studio 2022 or Visual Studio Code
- .NET 9.0 SDK
- .NET MAUI workload
- Android SDK (API level 34+)
- Xcode (for iOS development)

### Installation
1. Clone the repository
2. Open the solution in Visual Studio
3. Restore NuGet packages
4. Build the application
5. Run on your preferred platform

### Building for Android
```bash
dotnet build -f net9.0-android
dotnet build -f net9.0-android -t:Install
```

## Usage Guide

### Main Features

#### 1. Location Tracking
- **Start Tracking**: Begin continuous GPS location monitoring
- **Stop Tracking**: Pause location collection
- **Real-time Updates**: Live location pins on the map

#### 2. Map Interaction
- **Center Map**: Automatically center on current location
- **Zoom Controls**: Standard map zoom in/out functionality
- **Interactive Navigation**: Pan and explore different areas

#### 3. Heat Map Visualization
- **Demo Heat Map**: Display pre-loaded San Francisco Bay Area data
- **Color Coding**: 
  - Red: High intensity (many location points)
  - Yellow: Medium-high intensity
  - Cyan: Medium-low intensity
  - Blue: Low intensity (fewer location points)
- **Intensity Calculation**: Based on location frequency and density

#### 4. Data Management
- **Clear Demo**: Remove all demo location data
- **Reset Map**: Return to default map view
- **Location Count**: Real-time display of tracked locations

## Sample Data

The application includes 30 dummy location points around the San Francisco Bay Area:

- **Golden Gate Bridge** (5 points) - High frequency
- **Financial District** (6 points) - High frequency  
- **Fisherman's Wharf** (3 points) - Medium frequency
- **Union Square** (3 points) - Medium frequency
- **SOMA** (4 points) - Medium frequency
- **Chinatown** (3 points) - Medium frequency
- **Mission District** (2 points) - Low frequency
- **Castro District** (1 point) - Low frequency
- **North Beach** (1 point) - Low frequency
- **Marina District** (1 point) - Low frequency
- **Presidio** (1 point) - Low frequency

## Configuration

### OpenStreetMap Integration
The app uses OpenStreetMap tiles with Leaflet.js for map display:
- **Tile Provider**: [OpenStreetMap](https://www.openstreetmap.org/about) - Community-driven, open-source map data
- **Attribution**: © OpenStreetMap contributors
- **No API Keys Required**: Completely free map service
- **Open Data**: Free to use for any purpose with proper attribution

### Configuration Files
The app supports configuration files for managing settings:

#### Files Created:
- `appsettings.json` - Base configuration
- `appsettings.Development.json` - Development-specific configuration

#### Configuration Priority:
The configuration is loaded in this order:
1. Environment variables
2. `appsettings.json` file
3. Default values (for development)

#### Environment Variables:
You can set configuration values as environment variables:

**On macOS/Linux:**
```bash
export APP_SETTING="your_value_here"
```

**On Windows (PowerShell):**
```powershell
$env:APP_SETTING = "your_value_here"
```

#### Security Notes:
- Never commit sensitive configuration to version control
- Use different settings for development and production
- Consider using environment variables for production deployments

### Database Configuration
- **Database**: SQLite local storage
- **Location**: `FileSystem.AppDataDirectory/location_tracker.db`
- **Framework**: Entity Framework Core 9.0.9

### Database Schema
The SQLite database stores location data in the `LocationData` table:

```sql
CREATE TABLE LocationData (
    Id INTEGER PRIMARY KEY AUTOINCREMENT,
    Latitude REAL NOT NULL,
    Longitude REAL NOT NULL,
    Accuracy REAL DEFAULT 0.0,
    Altitude REAL,
    Speed REAL,
    Timestamp TEXT NOT NULL,
    SessionId TEXT,
    Notes TEXT
);
```

## User Interface

### Color Scheme
- **Primary**: Purple (#8B5CF6) - Header and heat map button
- **Success**: Green (#10B981) - Start tracking
- **Danger**: Red (#EF4444) - Stop tracking
- **Info**: Blue (#3B82F6) - Center map
- **Warning**: Orange (#F59E0B) - Clear demo
- **Secondary**: Gray (#6B7280) - Reset map

### Layout
- **Header**: Application title with purple background
- **Map Area**: Full-screen interactive map
- **Controls**: Two-row button layout with status display
- **Status Bar**: Location count and system information

## Platform Support

### Android
- **Minimum SDK**: API level 21 (Android 5.0)
- **Target SDK**: API level 34 (Android 14)
- **Permissions**: 
  - `ACCESS_FINE_LOCATION`: Precise location access
  - `ACCESS_COARSE_LOCATION`: Approximate location access
  - `ACCESS_BACKGROUND_LOCATION`: Background location tracking

### iOS
- **Minimum Version**: iOS 15.0
- **Permissions**: 
  - `NSLocationWhenInUseUsageDescription`: Location access when app is in use
  - `NSLocationAlwaysAndWhenInUseUsageDescription`: Always location access
  - `NSLocationAlwaysUsageDescription`: Background location access
- **Capabilities**: Background location updates

### macOS
- **Minimum Version**: macOS 12.0
- **Architecture**: Apple Silicon and Intel

## Privacy & Security

- **Local Storage**: All data stored locally on device
- **No Cloud Sync**: No data transmitted to external servers
- **Open Source Maps**: No tracking by commercial map providers
- **Permission-Based**: Location access only when explicitly granted

## Performance

### Optimization Features
- **Efficient Rendering**: WebView-based map rendering
- **Memory Management**: Proper disposal of resources
- **Background Processing**: Non-blocking location updates
- **Responsive UI**: Smooth interactions and animations

### System Requirements
- **RAM**: Minimum 2GB recommended
- **Storage**: 50MB for app and data
- **Network**: Internet required for map tiles
- **GPS**: Location services enabled

## Troubleshooting

### Common Issues

1. **Map Not Loading**
   - Check internet connection
   - Verify OpenStreetMap tile availability
   - Restart the application

2. **Location Not Found**
   - Ensure location permissions are granted
   - Check GPS/Location services are enabled
   - Verify device location settings

3. **Performance Issues**
   - Clear demo data if too many points
   - Restart the application
   - Check available device memory

### Build Issues

#### Android Build Issues
- Ensure Android SDK API level 34+ is installed
- Accept Android SDK licenses
- Set correct Android SDK path in project file

#### iOS Build Issues
- Ensure Xcode 16.4+ is installed
- Set up iOS development certificates
- Configure provisioning profiles

#### Location Permissions
- Grant location permissions when prompted
- Check device location settings
- Ensure location services are enabled

## Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

## License

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

For production use, consider:
- Adding comprehensive error handling
- Implementing proper logging
- Adding unit tests
- Optimizing battery usage
- Adding privacy controls

## Acknowledgments

- **OpenStreetMap**: Free, open-source map data
- **Leaflet.js**: Interactive map library
- **.NET MAUI**: Cross-platform framework
- **Entity Framework Core**: Data access framework

## Support

For questions, issues, or feature requests:
- Create an issue in the repository
- Check the documentation
- Review the troubleshooting guide

## Disclaimer

This repository was created as part of the coursework for the **Master’s in Information Technology** program at the **University of the Cumberlands**, for the course **Software Engineering and Multiplatform App Development**.

**Student Information:**
- **Name:** Carlos Gutierrez
- **University Email:** cgutierrez44833@ucumberlands.edu
- **Personal Email**: carlos.gutierrez@carg.dev

This project was developed for educational purposes only and is not intended for commercial use. All code and materials are submitted as part of the academic requirements for the course.

---

**Built with .NET MAUI and OpenStreetMap**