Skip to content

wiris316/AQI-location-viewer

Repository files navigation

AQI Location Viewer

Project Overview:

The application integrates the WAQI (World Air Quality Index) API to offer real-time air quality monitoring across 1,000+ city-level data points. It provides users with real-time Air Quality Index (AQI) information for their current location and enables them to search for other cities to view their respective AQI data. Utilizing the AQICN scale, the application categorizes AQI levels into color-coded indicators, providing standardized air quality assessments.

Category Description
Good (Green) Indicates low levels of air pollution with minimal health risks.
Moderate (Yellow) Suggests moderate levels of air pollution that may pose health concerns for sensitive individuals.
Unhealthy for Sensitive Groups (Orange) Indicates elevated levels of pollutants that may affect individuals with respiratory or cardiovascular conditions, children, and the elderly.
Unhealthy (Red) Signifies high levels of pollution that can have adverse health effects on the general population, with increased risks of respiratory and cardiovascular issues.
Very Unhealthy (Purple) Indicates severe air pollution levels that may cause significant health problems for everyone, with increased risks of respiratory and cardiovascular diseases.
Hazardous (Maroon) Represents extremely high levels of pollution that pose immediate and severe health risks, requiring immediate action to mitigate exposure.

Key Features

  • Current Location AQI Display: The application fetches and displays the AQI for the user's current location, providing instant access to local air quality information.
  • City Selection: Users can search for and select other cities to view their respective AQI levels, allowing for easy comparison and assessment of air quality across different locations.
  • Color-Coded Categorization: The AQI data is categorized according to the AQICN scale, with color-coded indicators representing different levels of air pollution. This visual representation helps users quickly interpret and gauge air quality conditions.

Typescript React NodeJS Express.js Vite SCSS

Prerequisites

To run this application, you will need to obtain an API token from here. Create a ".env" file in the root directory and add the API token in the following format.

AQI_TOKEN="YOUR_TOKEN_HERE"

Getting Started

# Clone the repository
gh repo clone your-username/AQI-location-viewer

# Navigate to the project directory
cd AQI-location-viewer

# Install the dependencies
npm install

# Start the development server
npm start

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published