SkillAgentSearch skills...

Covid 19 Open Data

Datasets of daily time-series data related to COVID-19 for over 20,000 distinct locations around the world.

Install / Use

npx skills add GoogleCloudPlatform/covid-19-open-data

Installs into whichever agent you are using.

About this skill

Quality Score

0/100

Supported Platforms

Universal

README

Official Site

Please refer to the official site for this repository for visualizations and other relevant information: https://health.google.com/covid-19/open-data/

Repository No Longer Updated

As of September 15, 2022, we will be turning off real-time updates in this repository, and converting the repository to a retrospective one. The data will continue to be available without interruption for the foreseeable future at the existing location, but it will not be updated further. Users who wish to continue to receive updates are encouraged to inspect our data sources, or clone the code and run the data pipelines locally.

COVID-19 Open-Data

This repository attempts to assemble the largest Covid-19 epidemiological database in addition to a powerful set of expansive covariates. It includes open, publicly sourced, licensed data relating to demographics, economy, epidemiology, geography, health, hospitalizations, mobility, government response, weather, and more. Moreover, the data merges daily time-series, +20,000 global sources, at a fine spatial resolution, using a consistent set of region keys. All regions are assigned a unique location key, which resolves discrepancies between ISO / NUTS / FIPS codes, etc. The different aggregation levels are: The different aggregation levels are:

  • 0: Country
  • 1: Province, state, or local equivalent
  • 2: Municipality, county, or local equivalent
  • 3: Locality which may not follow strict hierarchical order, such as "city" or "nursing homes in X location"

There are multiple types of data:

  • Outcome data Y(i,t), such as cases, tests, hospitalizations, deaths and recoveries, for region i and time t
  • Static covariate data X(i), such as population size, health statistics, economic indicators, geographic boundaries
  • Dynamic covariate data X(i,t), such as mobility, search trends, weather, and government interventions

The data is drawn from multiple sources, as listed below, and stored in separate tables as CSV files grouped by context, which can be easily merged due to the use of consistent geographic (and temporal) keys as it is done for the aggregated table.

| Table | Keys<sup>1</sup> | Content | URL | Source<sup>2</sup> | | ----- | ---------------- | ------- | --- | ------------------ | | Aggregated | [key][date] | Flat, compressed table with records from (almost) all other tables joined by date and/or key; see below for more details | aggregated.csv | All tables below | | Index | [key] | Various names and codes, useful for joining with other datasets | index.csv, index.json | Wikidata, DataCommons, Eurostat | | Demographics | [key] | Various (current<sup>3</sup>) population statistics | demographics.csv, demographics.json | Wikidata, DataCommons, WorldBank, WorldPop, Eurostat | | Economy | [key] | Various (current<sup>3</sup>) economic indicators | economy.csv, economy.json | Wikidata, DataCommons, Eurostat | | Epidemiology | [key][date] | COVID-19 cases, deaths, recoveries and tests | epidemiology.csv, epidemiology.json | Various<sup>2</sup> | | Emergency Declarations | [key][date] | Government emergency declarations and mitigation policies | lawatlas-emergency-declarations.csv | LawAtlas Project | | Geography | [key] | Geographical information about the region | geography.csv, geography.json | Wikidata | | Health | [key] | Health indicators for the region | health.csv, health.json | Wikidata, WorldBank, Eurostat | | Hospitalizations | [key][date] | Information related to patients of COVID-19 and hospitals | hospitalizations.csv, hospitalizations.json | Various<sup>2</sup> | | Mobility | [key][date] | Various metrics related to the movement of people.<br/><br/>To download or use the data, you must agree to the Google Terms of Service. | mobility.csv, mobility.json | Google | | Search Trends | [key][date] | Trends in symptom search volumes due to COVID-19.<br/><br/>To download or use the data, you must agree to the Google Terms of Service. | google-search-trends.csv | Google | | Vaccination Access | [place_id] | Metrics quantifying access to COVID-19 vaccination sites.<br/><br/>To download or use the data, you must agree to the Google Terms of Service. | facility-boundary-us-all.csv | Google | | Vaccination Search | [key][date] | Trends in Google searches for COVID-19 vaccination information. <br/><br/> To download or use the data, you must agree to the Google Terms of Service.| Global-vaccination-search-insights.csv | Google | | Vaccinations | [key][date] | Trends in persons vaccinated and population vaccination rate regarding various Covid-19 vaccines.<br/><br/> | vaccinations.csv | Google | | Government Response | [key][date] | Government interventions and their relative stringency | oxford-government-response.csv, oxford-government-response.json | University of Oxford | | Weather | [key][date] | Dated meteorological information for each region | weather.csv | NOAA | | WorldBank | [key] | Latest record for each indicator from WorldBank for all reporting countries | worldbank.csv, worldbank.json | WorldBank | | By Age | [key][date] | Epidemiology and hospitalizations data stratified by age | by-age.csv, by-age.json | Various<sup>2</sup> | | By Sex | [key][date] | Epidemiology and hospitalizations data stratified by sex | by-sex.csv, by-sex.json | Various<sup>2</sup> |

<sup>1</sup> key is a unique string for the specific geographical region built from a combination of codes such as ISO 3166, NUTS, FIPS and other local equivalents.
<sup>2</sup> Refer to the data sources for specifics about each data source and the associated terms of use.
<sup>3</sup> Datasets without a date column contain the most recently reported information for each datapoint to date.

For more information about how to use these files see the section about using the data, and for more details about each dataset see the section about understanding the data.

Why another dataset?

There are many other public COVID-19 datasets. However, we believe this dataset is unique in the way that it merges multiple global sources, at a fine spatial resolution, using a consistent set of region keys in a way we hope facilitate ease of usage. Most importantly, we are committed to transparency regarding open, public, and licensed data sources. Lastly, the code for ingesting and merging the data is easy to understand and modify.

Explore the data

A simple visualization tool was built to explore the Open COVID-19 datasets, the [Open COVID-19 Explorer][12]: <img src="https://github.com/open-covid-19/explorer/raw/master/screenshots/explorer.png" alt="drawing" width="200"/> <br> A variety of other community contributed visualization tools are listed below.

| | | | | --- | --- | --- | | See the COVID19 Data Block made

Related Skills

View on GitHub
GitHub Stars488
CategoryDevelopment
Updated16d ago
Forks132

Languages

Python

Security Score

95/100

Audited on Jul 23, 2026

No findings