{"id":27248589,"url":"https://github.com/lacegiovanni17/air_quality_nodejs","last_synced_at":"2026-04-11T10:32:22.443Z","repository":{"id":191961535,"uuid":"685085452","full_name":"lacegiovanni17/Air_Quality_NodeJS","owner":"lacegiovanni17","description":"The goal of this project is to create a REST API responsible for exposing “the air quality information” of a nearest city to GPS coordinates using iqair :","archived":false,"fork":false,"pushed_at":"2023-09-01T01:07:37.000Z","size":114,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-07-30T19:58:39.376Z","etag":null,"topics":["expressjs","javascript","mongodb","mongoose","nodejs","postman","typescript"],"latest_commit_sha":null,"homepage":"https://www.iqair.com/fr/commercial/air-quality-monitors/airvisual-platform/api","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lacegiovanni17.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-08-30T13:39:29.000Z","updated_at":"2023-09-01T01:10:20.000Z","dependencies_parsed_at":"2023-09-01T19:12:40.003Z","dependency_job_id":"b12ede5f-3ea1-4584-9df1-7d249dafc8ef","html_url":"https://github.com/lacegiovanni17/Air_Quality_NodeJS","commit_stats":null,"previous_names":["lacegiovanni17/air_quality_nodejs"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lacegiovanni17%2FAir_Quality_NodeJS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lacegiovanni17%2FAir_Quality_NodeJS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lacegiovanni17%2FAir_Quality_NodeJS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lacegiovanni17%2FAir_Quality_NodeJS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lacegiovanni17","download_url":"https://codeload.github.com/lacegiovanni17/Air_Quality_NodeJS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248317731,"owners_count":21083525,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["expressjs","javascript","mongodb","mongoose","nodejs","postman","typescript"],"created_at":"2025-04-10T23:40:24.854Z","updated_at":"2025-12-30T19:15:27.323Z","avatar_url":"https://github.com/lacegiovanni17.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Air_Quality_NodeJS\nThe goal of this project is to create a REST API responsible for exposing “the air quality information” of a nearest city to GPS coordinates using iqair :\n\n![Capture37](https://github.com/lacegiovanni17/Air_Quality_NodeJS/assets/30509335/5326f288-ae7d-4a05-94a5-557686242d66)\n\n![Capture38](https://github.com/lacegiovanni17/Air_Quality_NodeJS/assets/30509335/f0a51dd2-9188-4428-9380-08ef6f37c99b)\n\n### [Live Site]()\n\n\n## About\n* 👋 Hi, I’m Chidike Henry \n* 😎 I’m a MERN fullstack engineer\n* 💻 This is a backend code for getting the air quality information of a location\n* 💞️ I’m looking to collaborate on JS projects \n* 📫 How to reach me chidike.henry@gmail.com\n\n\n## Introduction\nThe purpose of this assessment is to evaluate my abilities in creating a backend application using REST API to expose “the air\nquality information” of a nearest city to GPS coordinates using iqair : `https://www.iqair.com/fr/commercial/air-quality-monitors/airvisual-platform/api.`\nThis project will allow you to assess my proficiency in backend development, API integration, and my problem-solving approach.\n\n## Technologies Used\n* NodeJS\n* ExpressJS\n* Javascript\n* Typescript\n* Jest\n* Postman\n* MongoDB \n\n## Project Description: Mini-project “AIR QUALITY”\nGoal:\nBuilding REST API using Node Js.\n\nContext:\nThe goal of this project is to create a REST API responsible for exposing “the air\nquality information” of a nearest city to GPS coordinates using iqair :\nhttps://www.iqair.com/fr/commercial/air-quality-monitors/airvisual-platform/apiTasks:\n● Configuration:\n- register on “iqair” and create your API KEY (\nhttps://www.iqair.com/fr/dashboard/api )\n- NOTE: the activation of the key can take a few minutes (about 5\nminutes).\n- Fetch “air quality “ with this URL ( https://api-docs.iqair.com/ par\nlongitude/latitude ) using postman or another platform to test the API.\n- Test the endpoint “ v2/nearest_city” of iqair API.\n● Integration:\n- Build Node Js REST API ( feel free to choose the framework )\n- Create an endpoint( give a coherent name of your Route )\nparams: longitude, latitude.\n- In this endpoint, make a call to IQAIR API to get “air quality “ for the\ngiven zone ( read documentation : “nearest_city”) and return the\nresult as below :\n \n\n{\n  \"Result\": {\n    \"Pollution\": {\n      \"ts\":\"\"2019-08-04T01\":\"00\":00.000Z\",\n      \"aquis\":55,\n      \"mainus\":\"p2\",\n      \"aqicn\": 20,\n      \"maincn\":\"p2\"\n    }\n  }\n}\n\n● CRON:\n● Implement CRON JOB to check “ air quality “ for the Paris zone ( latitude:\n48.856613 ,longitude: 2.352222) every 1 minute than save them in the\ndatabase ( add date and time when saving the air quality)\n● (optionnel:) add an endpoint to get datetime( date and time ) where the paris\nzone is the most polluted ( based on your CRON JOB results).\nYour data should be stored in a database (feel free to choose technology)\nAdd :\n● Documentation\n● Unit tests / integration\n\n\n## Getting Started\n## Mini-project “AIR QUALITY” Backend App Setup Guide\nFollow these steps to set up and run the Mini-project “AIR QUALITY” Backend App:\n\n## Prerequisites\n1. Ensure you have Node.js installed on your machine. You can download it from nodejs.org.\n## Installation\n1. Clone the repository: `git clone \u003crepository-url\u003e`\n2. Navigate to the project directory: `cd air_filter_nodejs`\n3. Install dependencies: `npm install`\n4. note: mongodb and mongoose is used in this project and you can access the DB with MongodDB Compass on your PC\n\n## Running the App from your terminal\n1. From the root directory change to the src folder by running the following command `cd src`\n2. From the src folder run the following command to start the backend server: `npm run dev`\n3. The backend server will be running at http://localhost:8899.\n   \n## Endpoints\n1. GET\n\n\n\n## Usage\nTo retrieve available , make a GET request to \n\nTo confirm a  \n\nPlease use postman to test endpoints\n\n## Documentation\nAccess documentation here - https://documenter.getpostman.com/view/25014777/2s9Y5crfD9\n\n## Error Handling\nThe application provides appropriate error handling for invalid inputs and unexpected scenarios.\n\n## Testing\nThe application includes comprehensive unit tests to ensure reliability and functionality. Run tests using the following command: `npm test`\n\nWith these instructions, developers and users will be able to quickly set up and run the Flight Booking Backend App for testing and development purposes.\n\n## Author\n\n#### 👤 Author1\n- GitHub: [@lacegiovanni17]https://github.com/lacegiovanni17\n- Twitter: [@ChidikeC] https://twitter.com/ChidikeC\n- LinkedIn: [LinkedIn]https://www.linkedin.com/in/chidike-chizoba-25628a40/\n\n## Contributing \nContributions, issues, critics and feature requests are welcome!\n\n## Show your support\nPlease give a ⭐️ if you like this project! \n\n## Acknowledgments\n- Hat tip to Yassir \n- Inspiration\n- etc\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flacegiovanni17%2Fair_quality_nodejs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flacegiovanni17%2Fair_quality_nodejs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flacegiovanni17%2Fair_quality_nodejs/lists"}