Skip to content

jrmontag/co-covid-ww

Repository files navigation

Queryable Colorado COVID wastewater data

The state has an arcgis dashboard 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.

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. If you create something using this API, please share it by opening an Issue on this repo or tweeting at me!

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.