Skip to content

Latest commit

 

History

History
235 lines (166 loc) · 10.7 KB

README.md

File metadata and controls

235 lines (166 loc) · 10.7 KB

🚑 AmbuFlow


🚑 A Mobile Application built with HTML, CSS, JavaScript, and Google API, designed to notify patients of nearby hospitals and provide estimated ambulance arrival times. 🏥 It offers hospitals and ambulance drivers critical details like the patient’s location 📍 and enhances GPS route management with real-time traffic data 🚦 for scheduled routes, ensuring efficient navigation.

🌟 Stars 🍴 Forks 🐛 Issues 🔔 Open PRs 🔕 Close PRs
Stars Forks Issues Open Pull Requests Close Pull Requests

This project is now OFFICIALLY accepted for

GSSoC 2024 Extd
Hacktober fest 2024

Table of Contents

DESCRIPTION

A mobile app using HTML, CSS, JavaScript, and Google API that helps users find nearby hospitals and track ambulances in real-time. It shows hospital locations, provides directions, and helps manage ambulance routes based on traffic and distance.

Please check out the Screenshots.md for more clarity on the description of the project.

Why We Need This Application

  1. Quick Emergency Response: Ensures patients receive timely medical assistance by locating the nearest hospitals and ambulances.
  2. Real-Time Tracking: Provides real-time updates on ambulance locations and traffic conditions, optimizing route management.
  3. Enhanced Communication: Facilitates seamless communication between patients, hospitals, and ambulance drivers.
  4. Resource Management: Helps hospitals manage their resources efficiently by providing critical information and analytics.
  5. User-Friendly Interface: Designed for ease of use, ensuring that even in high-stress situations, users can navigate the app effortlessly.

Problem Statement

While having the name and address of a hospital is useful, visualizing it on a map with precise directions is even more effective. This app aims to bridge that gap by delivering real-time location data and navigation assistance, ensuring users find the nearest hospital quickly and with ease. 🚑

🌟 Quick Access to Hospitals

In emergencies, time is of the essence. Quickly identifying the nearest hospital can be life-saving. This app provides that immediate support.

🗺️ Locate Hospitals on a Map

Visual information is key. Beyond just showing names and addresses, the app provides a map view with directions, offering users an intuitive way to locate nearby hospitals with ease.

Solution

🚑 Quick Access to Hospitals

This app offers a comprehensive list of nearby hospitals with essential details such as addresses, contact numbers, and user ratings. Users can filter based on hospital specialties, helping them find the appropriate medical help efficiently.

🗺️ Map-Based Hospital Location

The built-in map feature shows exact hospital locations, provides directions, and highlights landmarks and real-time traffic conditions. This ensures users can navigate unfamiliar areas and choose the fastest route to get the care they need, right when they need it.

Key Features

🚑 Operator Interface

  • 🔐 Registration & Sign-In: Operators can create accounts and securely log in for system access.
  • 📍 Location Sharing: Operators can share their real-time location for precise tracking and coordination.

👥 User Interface

  • 🚨 Service Request: Users can request ambulance services with just a few taps.
  • 🏥 Hospital Info: Retrieve details on nearby hospitals and available ambulances.
  • 📊 Real-Time Ambulance Tracking: Users can track the availability of ambulances to ensure timely assistance.

📈 Additional Features

  1. 📡 GPS-Enabled Tracking: Monitors ambulances in real-time for optimal tracking and coordination.
  2. 🔔 Hospital Alerts: Sends patients notifications about nearby hospitals for quicker medical assistance.
  3. 🚦 Distance & Traffic Analysis: Calculates the fastest routes based on real-time traffic and distance.
  4. 🧑‍💼 Driver Management: Streamlines driver schedules and activities for efficient ambulance deployment.

Contributing

We welcome all contributions from the open-source community! If you'd like to contribute, follow these steps:

  1. Fork the repository:
git clone https://github.com/yourusername/AmbuFlow.git
  1. Create a new feature branch:
git checkout -b feature/your-feature-name
  1. Commit your changes:
git add .
git commit -m "Add feature description"
  1. Push to the branch:
git push origin feature/your-feature-name
  1. Open a Pull Request: Go to your forked repo on GitHub and click "New Pull Request."

How to run the project:

  1. Go to Backend folder and run command:
npm install
  1. Make mongodb database.

  2. Go to server.js file and give your mongodb connection URL.

  3. Run command:

node server.js
  1. Split terminal and go to index.html and open it with live server.

  2. make sure that both Backend and index.html file run togethere.

Contribution Guidelines:

We welcome all contributions to improve AmbuFlow! If you would like to contribute, please follow the Contributing.md to know how to get started.

To maintain quality and consistency, please follow these best practices:

  1. Code Style: Write clean, readable code following the project's coding style. Comments are highly appreciated.
  2. Commits: Use meaningful commit messages that clearly describe the purpose of the changes.
  3. Pull Requests: Keep PRs focused, well-explained, and reference any relevant issues.
  4. Testing: Ensure all changes are thoroughly tested locally and do not break existing functionality.

Refer to CODE_OF_CONDUCT.md for details on our community guidelines.

Tech Stack



  • Google API Keys 🔑: These are also used to access various Google services programmatically, such as Google Maps, Google Drive, etc.

User-Friendly Experience

This app is designed to be user-friendly, ensuring a seamless experience for both patients and ambulance drivers. The intuitive interface and real-time updates make it easy to navigate and use, even in high-stress situations.

Future Enhancements

  • Integration with Emergency Services for faster response times.
  • Real-Time Communication between patients and ambulance drivers.
  • Advanced Analytics for hospitals to manage resources efficiently.

Our Valuable Contributors:

Contributors

Team

Mansi Ruhil
Mansi Ruhil
Project Admin
LinkedIn

⭐️ Support the Project

If you find this project helpful, please consider giving it a star on GitHub! Your support helps the project grow and reach more contributors.

Keep learning 📚, exploring 🌍, and contributing 🤝 to make a difference in the world!