An open API service indexing awesome lists of open source software.

https://github.com/alok-devforge/realtime-time-location-tracking-and-alert-system

🌍 Real-time wildlife tracking & visitor monitoring system with GPS, WebSocket technology, proximity alerts, and interactive maps for University of Engineering and Management National Park
https://github.com/alok-devforge/realtime-time-location-tracking-and-alert-system

express geolocation gps-tracking interactive-maps javascript leaflet location-tracking nodejs openstreetmap real-time socket-io tracking-system websocket wildlife-tracking

Last synced: 10 days ago
JSON representation

🌍 Real-time wildlife tracking & visitor monitoring system with GPS, WebSocket technology, proximity alerts, and interactive maps for University of Engineering and Management National Park

Awesome Lists containing this project

README

          

# 🌍 Real-Time Location Tracking & Wildlife Alert System


Status
Node.js
License
WebSocket


🦎 A sophisticated real-time wildlife tracking and monitoring system for University of Engineering and Management National Park

---

## πŸš€ Live Demo

🌐 Live Application

uem-kolkata-wildlife-tracker.onrender.com

πŸ“ Location

University of Engineering and Management, Kolkata

22.5603Β° N, 88.4903Β° E

## πŸ“‹ Overview

This cutting-edge project leverages **WebSocket technology** to provide real-time wildlife tracking and visitor monitoring for University of Engineering and Management National Park. The system features an interactive map interface with live animal simulation, proximity alerts, and comprehensive safety monitoring.

## ✨ Key Features

| 🎯 **Real-Time Tracking** | 🦌 **Wildlife Simulation** | 🚨 **Safety Alerts** | πŸ—ΊοΈ **Interactive Maps** |
|:---:|:---:|:---:|:---:|
| Live GPS tracking with WebSocket | 10 realistic animal species | Proximity-based warnings | OpenStreetMap & Leaflet.js |
| Multi-visitor support | Territory-based movement | 3-tier alert system | Park boundaries & zones |

### πŸ”₯ Advanced Features

- **🌐 Real-time visitor tracking** using GPS and WebSocket technology
- **🦎 Comprehensive wildlife simulation** with 10 different animal species
- **⚠️ Intelligent proximity alerts** with distance-based warning system
- **πŸ—ΊοΈ Interactive map interface** with multiple view modes
- **🏞️ Multi-zone monitoring** including park boundaries and visitor centers
- **πŸ”” Real-time safety notifications** with customizable alert levels
- **πŸ“Š Live dashboard** with visitor statistics and wildlife monitoring
- **🎨 Modern responsive UI** with smooth animations and transitions

## πŸ› οΈ Technology Stack


Frontend
Backend
WebSocket

| Technology | Purpose | Version |
|:---:|:---:|:---:|
| **Node.js** | Server Runtime | v18+ |
| **Express.js** | Web Framework | v4.18+ |
| **Socket.IO** | WebSocket Communication | v4.7+ |
| **Leaflet.js** | Interactive Maps | Latest |
| **OpenStreetMap** | Map Data Provider | - |
| **Geolocation API** | GPS Tracking | Browser Native |

## 🦌 Wildlife Simulation System

🎯 Click to view all 10 animal species

### πŸ”΄ High Threat Animals
| Animal | Scientific Name | Habitat | Danger Zone | Warning Zone |
|:---:|:---:|:---:|:---:|:---:|
| πŸ… **Raja the Tiger** | *Panthera tigris* | Dense forests | 50m | 100m |
| 🐘 **Ganesha the Elephant** | *Elephas maximus* | Open grasslands | 30m | 75m |
| πŸ† **Shera the Leopard** | *Panthera pardus* | Rocky outcrops | 40m | 80m |
| 🐊 **Sobek the Crocodile** | *Crocodylus palustris* | Water bodies | 45m | 85m |

### 🟑 Medium Threat Animals
| Animal | Scientific Name | Habitat | Danger Zone | Warning Zone |
|:---:|:---:|:---:|:---:|:---:|
| 🐻 **Baloo the Sloth Bear** | *Melursus ursinus* | Forest undergrowth | 35m | 70m |
| πŸ— **Pumba the Wild Boar** | *Sus scrofa* | Dense undergrowth | 25m | 50m |

### 🟒 Low/No Threat Animals
| Animal | Scientific Name | Habitat | Warning Zone |
|:---:|:---:|:---:|:---:|
| 🦌 **Bambi the Spotted Deer** | *Axis axis* | Open meadows | 20m |
| 🦚 **Mayur the Peacock** | *Pavo cristatus* | Forest clearings | 15m |
| 🦜 **Zazu the Hornbill** | *Buceros rhinoceros* | Tall canopy | 10m |
| πŸ’ **Hanuman the Monkey** | *Macaca mulatta* | Tree canopies | 25m |

### οΏ½ Alert System

| Alert Level | Icon | Description | Action Required |
|:---:|:---:|:---:|:---:|
| **🚨 DANGER** | Red | Animal within danger radius | **Immediate evacuation** |
| **⚠️ WARNING** | Yellow | Animal within warning radius | **Maintain safe distance** |
| **πŸ“ INFO** | Blue | General park information | **Stay informed** |
| **βœ… SAFE** | Green | No immediate threats | **Continue safely** |

## πŸš€ Deployment Guide

### πŸ“¦ Quick Deploy to Render

[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com)

### πŸ“‹ Prerequisites

- βœ… **Node.js** v18 or higher
- βœ… **Git** installed and configured
- βœ… **GitHub/GitLab account** for repository hosting
- βœ… **Render account** (free tier available)

### πŸ”§ Step-by-Step Deployment

1️⃣ Repository Setup

```bash
# Clone your repository
git clone https://github.com/alok-devforge/realtime-time-location-tracking-and-alert-system.git
cd realtime-time-location-tracking-and-alert-system

# Install dependencies
npm install

# Test locally
npm start
```

2️⃣ Render Configuration

1. 🌐 Go to [render.com](https://render.com) and sign up
2. πŸ”— Connect your GitHub account
3. βž• Click **"New +"** β†’ **"Web Service"**
4. πŸ“‚ Select your repository
5. βš™οΈ Configure settings:
- **Name**: `uem-wildlife-tracker`
- **Environment**: `Node`
- **Build Command**: `npm install`
- **Start Command**: `node server.js`
- **Plan**: `Free` (or upgrade as needed)

3️⃣ Environment Configuration

| Setting | Value | Description |
|:---:|:---:|:---:|
| **Port** | `process.env.PORT` | Auto-configured by Render |
| **Node Version** | `18+` | Specified in package.json |
| **Auto-Deploy** | `Enabled` | Deploy on git push |

### 🌟 Deployment Features

- **πŸ”„ Automatic deployments** on git push
- **🌐 WebSocket support** for real-time features
- **πŸ“Š Built-in monitoring** and logging
- **⚑ Global CDN** for fast loading
- **πŸ”’ Free SSL certificates** included
- **πŸ“ˆ Easy scaling** options available

## πŸ’» Local Development

### πŸ”§ Installation

```bash
# 1. Clone the repository
git clone https://github.com/alok-devforge/realtime-time-location-tracking-and-alert-system.git

# 2. Navigate to project directory
cd realtime-time-location-tracking-and-alert-system

# 3. Install dependencies
npm install

# 4. Start the development server
npm start
```

### 🌐 Usage

1. **πŸš€ Start the server**: Run `npm start`
2. **🌍 Open browser**: Navigate to `http://localhost:3000`
3. **πŸ“ Allow location**: Grant location permissions when prompted
4. **πŸ‘€ Enter name**: Input your name to join the tracking system
5. **🦌 Monitor wildlife**: View real-time animal locations and receive alerts

### πŸ“ Project Structure

```
πŸ“¦ realtime-time-location-tracking-and-alert-system/
β”œβ”€β”€ πŸ“„ server.js # Main server file (Express + Socket.IO)
β”œβ”€β”€ πŸ“„ package.json # Dependencies and scripts
β”œβ”€β”€ πŸ“„ Procfile # Deployment configuration
β”œβ”€β”€ πŸ“„ index.html # Main HTML file
β”œβ”€β”€ πŸ“‚ public/ # Client-side assets
β”‚ β”œβ”€β”€ πŸ“‚ images/ # Image assets
β”‚ β”œβ”€β”€ πŸ“‚ scripts/ # JavaScript files
β”‚ β”‚ β”œβ”€β”€ πŸ“„ script.js # Main application logic
β”‚ β”‚ β”œβ”€β”€ πŸ“„ methods.js # Utility functions
β”‚ β”‚ β”œβ”€β”€ πŸ“„ coords.js # Park boundaries & coordinates
β”‚ β”‚ β”œβ”€β”€ πŸ“„ control.js # UI controls & interactions
β”‚ β”‚ └── πŸ“„ userMarkers.js # User marker management
β”‚ └── πŸ“‚ styles/ # CSS stylesheets
β”‚ β”œβ”€β”€ πŸ“„ style.css # Main styles
β”‚ β”œβ”€β”€ πŸ“„ modern-panels.css # Panel styles
β”‚ └── πŸ“„ tooltip.css # Tooltip styles
└── πŸ“„ README.md # Project documentation
```

## πŸ›‘οΈ Safety Guidelines

> ⚠️ **Important Disclaimer**: This is a demonstration system for educational purposes.

### πŸ“‹ Real Wildlife Park Guidelines

- πŸ‘₯ **Always follow park ranger instructions**
- πŸ“ **Maintain recommended distances from all wildlife**
- 🚫 **Never attempt to feed or approach animals**
- πŸ“ž **Report any wildlife sightings to park authorities**
- 🚢 **Stay on designated trails and paths**
- πŸ“± **Keep emergency contacts readily available**

## 🀝 Contributing

We welcome contributions! Here's how you can help:

| πŸ› **Bug Reports** | πŸ’‘ **Feature Requests** | πŸ”§ **Code Contributions** |
|:---:|:---:|:---:|
| [Open an Issue](../../issues) | [Request Feature](../../issues) | [Create Pull Request](../../pulls) |

### πŸ“ Contribution Guidelines

1. **🍴 Fork** the repository
2. **🌿 Create** a 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](LICENSE) file for details.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## πŸ‘¨β€πŸ’» Author & Contact

**alok-devforge**

[![GitHub](https://img.shields.io/badge/GitHub-alok--devforge-black?style=for-the-badge&logo=github)](https://github.com/alok-devforge)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-alok--devforge-blue?style=for-the-badge&logo=linkedin)](https://linkedin.com/in/alok-devforge)

---


🌟 If you found this project helpful, please give it a star! ⭐


Made with ❀️ for wildlife conservation and education