https://github.com/jrmontag/co-covid-ww

A JSON data API for querying Colorado's COVID-19 Wastewater data
https://github.com/jrmontag/co-covid-ww

colorado covid-19 rest-api

Last synced: 1 day ago
JSON representation

A JSON data API for querying Colorado's COVID-19 Wastewater data

• Host: GitHub
• URL: https://github.com/jrmontag/co-covid-ww
• Owner: jrmontag
• License: mit
• Created: 2022-11-18T23:10:53.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-07-22T03:13:04.000Z (2 months ago)
• Last Synced: 2024-07-22T19:56:35.586Z (2 months ago)
• Topics: colorado, covid-19, rest-api
• Language: Python
• Homepage: http://wastewater.jrmontag.xyz/
• Size: 68.4 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Queryable Colorado COVID wastewater data

The state has [an arcgis dashboard](https://cdphe.maps.arcgis.com/apps/dashboards/d79cf93c3938470ca4bcc4823328946b) that's pretty sweet if you have a computer. It is also a bit heavy and clunky for mobile users (ok, it's actually *terrible* for mobile users). 

This application creates a queryable API for this data at `http://wastewater.jrmontag.xyz` that updates shortly after the official data is updated.

## How can I use this API?

A mobile-friendly Streamlit frontend for this API [can be found here](https://colorado-covid-wastewater.streamlit.app/).

A basic commandline app to query this API is in `tools/report_app.py` and works with the Python 3.9+ stdlib and `requests`. Additionally, there is basic API documentation [available here](http://wastewater.jrmontag.xyz/docs/). If you create something using this API, please share it by opening an Issue on this repo or [tweeting at me](http://www.twitter.com/jrmontag)!

# FAQ

**Isn't this application a bit over-engineered given that the data from the portal is a few MB in size?**

Yes, it totally is. You could fetch the entire timeseries each time and hold it in memory for whatever data display applications you had in mind. This application wasn't designed to be maximally efficient! It was intended as a learning opportunity to create something real and online using some recent frameworks and libraries like FastAPI and Streamlit. 

# Credits

This application is made possible thanks to the lovely Colorado state [Open Data Portal](https://data-cdphe.opendata.arcgis.com/datasets/CDPHE::cdphe-covid19-wastewater-dashboard-data/about).