Skip to content

A React web app for locating Hong Kong public hospital services, with real-time data from the HK Hospital Authority API.

Notifications You must be signed in to change notification settings

qwerac388/medi-finder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MediFinder

Overview

MediFinder is a React-based web application designed to help users find 24-hour emergency rooms, specialist services, and general medical services in nearby Hong Kong public hospitals. Utilizing real-time data fetched directly from the Hong Kong Hospital Authority's API, our platform provides accurate, up-to-date information and real-time geolocation services to ensure you can quickly find the nearest medical assistance. This integration with the official API is a cornerstone feature that ensures reliability and relevance of the medical information provided.

Features

  • Powered by Hong Kong Hospital Authority API: All three main pages of MediFinder—emergency room locator, specialist services information, and general medical services—use the Hong Kong Hospital Authority's API for real-time data fetching, ensuring the information is current and accurate.

  • Geolocation Services: Detect your current location to find the closest emergency room and specialist services available.

  • 24-Hour Emergency Room Locator: Search for emergency rooms that are open around the clock in proximity to your location.

  • HKTaxi App Integration for Mobile Version: Introduced a special floating icon on the emergency room locator page. This allows users to download the HKTaxi App and book a taxi with ease, ensuring quick and convenient transportation to the hospital.

  • Urgent Hotlines: Quick access to emergency contact numbers with the functionality to call directly from the app.

    24-Hour Emergency Room Locator Page Preview


  • Specialist Services Information: Get information about specialist outpatient clinic schedules and waiting times near you.

  • HA Go App Integration For Mobile Version: Guided mobile experience with prompts to download the HA Go app, allowing users to make reservations for specialist and general medical services right from their smartphone.

    Specialist Services Information Page Preview


  • General Medical Services: Locate general health services based on your current geographical position.

  • Search and Filter Functionality: Integrated search and filter functions to find relevant healthcare services.

  • Interactive Maps: Visualize the location of hospitals on an easy-to-navigate map. Provided with alternative buttons to open the location in Google Maps and Apple Maps.

    General Medical Services Page Preview

Error Handling

  • Page Not Found: In case a user navigates to an unknown route, our PageNotFound component provides a user-friendly message, guiding them back to the functional parts of the application.

    PageNotFound Preview

  • Location Permissions: If a user declines to share their geolocation, the application will display a custom error message prompting them to allow location access to utilize geolocation services fully.

    ErrorMsg Preview

Usage

Visit MediFinder at https://qwerac388.github.io/MediFinder/ to start finding healthcare services near you. Navigate through the different sections using the menu. The search bar can be utilized to quickly locate specific hospitals. Interactive maps provide a visual guide to hospital locations and information. OG Preview

Built With

  • React : The web framework used.
  • Material-UI : For UI components.
  • react-router-dom: For routing.
  • react-slick : For carousel components.

About

A React web app for locating Hong Kong public hospital services, with real-time data from the HK Hospital Authority API.

Resources

Stars

Watchers

Forks