{"id":19711383,"url":"https://github.com/pastelsky/covid-19-mobility-tracker","last_synced_at":"2025-04-29T17:31:41.764Z","repository":{"id":40790667,"uuid":"253020317","full_name":"pastelsky/covid-19-mobility-tracker","owner":"pastelsky","description":"Google Mobility Reports, reverse-engineered into a JSON / CSV API","archived":false,"fork":false,"pushed_at":"2022-12-11T00:17:22.000Z","size":2198,"stargazers_count":85,"open_issues_count":13,"forks_count":16,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-05T18:52:00.732Z","etag":null,"topics":["api","covid-19","covid19-data"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pastelsky.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"liberapay":"pastelsky"}},"created_at":"2020-04-04T14:37:23.000Z","updated_at":"2022-12-07T07:02:34.000Z","dependencies_parsed_at":"2023-01-26T12:31:23.987Z","dependency_job_id":null,"html_url":"https://github.com/pastelsky/covid-19-mobility-tracker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pastelsky%2Fcovid-19-mobility-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pastelsky%2Fcovid-19-mobility-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pastelsky%2Fcovid-19-mobility-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pastelsky%2Fcovid-19-mobility-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pastelsky","download_url":"https://codeload.github.com/pastelsky/covid-19-mobility-tracker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251549268,"owners_count":21607378,"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":["api","covid-19","covid19-data"],"created_at":"2024-11-11T22:11:16.807Z","updated_at":"2025-04-29T17:31:38.068Z","avatar_url":"https://github.com/pastelsky.png","language":"JavaScript","funding_links":["https://liberapay.com/pastelsky"],"categories":[],"sub_categories":[],"readme":"# Covid-19 Mobility Tracker\n\n![last synced from source](https://badgen.net/badge/last%20synced%20from%20source/April%2022th/green) ![last update from google](https://badgen.net/badge/last%20update%20from%20google/April%2016th/blue)\n\n### Note\n**Note**: Google recently started publishing raw CSV data\nfor this, and following it is recommended for all future updates.\n\nThis project would still continue update sources, but it might not be\nas realtime.\n\n\n[Google Mobility Reports](https://www.google.com/covid19/mobility/) show aggregate activity in each country,\nand how it changes in response to policies aimed at combating COVID-19. However, it is only published as a PDF\nand the data isn't available in a machine-readable format that could enable more richer analysis.\n\n**This is an effort to reverse-engineer the PDFs into vectors and ultimately into time-series data available as a JSON Rest API.**\n\n![alt text](https://github.com/pastelsky/covid-19-mobility-tracker/raw/master/code.png)\n\n## Usage\n\n#### Country-level data\n\nCountry level JSON is available for use at –\n\n```\nhttps://pastelsky.github.io/covid-19-mobility-tracker/output/\u003cISO-COUNTRY-CODE\u003e/mobility.json\n```\n\n**For eg India**: https://pastelsky.github.io/covid-19-mobility-tracker/output/IN/mobility.json\n\n#### US State-level data\n\nUS state level JSON is available at –\n\n```\nhttps://pastelsky.github.io/covid-19-mobility-tracker/output/US/\u003cUS-STATE-CODE\u003e/mobility.json\n```\n\n**For eg: New York**: https://pastelsky.github.io/covid-19-mobility-tracker/output/US/NY/mobility.json\n\n### Accessing data as CSV\n\nIf you prefer to use CSVs instead, you can go to -\n\n```\nhttps://pastelsky.github.io/covid-19-mobility-tracker/output/\u003cISO-COUNTRY-CODE\u003e/mobility-\u003csocial-place\u003e.csv\n```\n\nWhere social place is one of `parks` | `residential` | `retail-and-recreation` | `transit-stations` | `workplaces` | `grocery-and-pharmacy`\n\nFor eg. parks data for India in CSV - https://pastelsky.github.io/covid-19-mobility-tracker/output/IN/mobility-parks.csv\n\nFor US states, just add the state code after the country code.\n\n#### Data structure\n\nEach data element consists of `date` and `value` (which represents mobility change in percentage)\n\n## Limitations\n\n- Expected error range is ±2%, though errors in activity percentanges\n  should be rare given the methodolgy used to extract data.\n- As of now, this only indexes country-level data and US state level data. State / Province level breakup for other countries is yet to be added.\n- Data sources will be updated once / day and is incumbent upon google publishing updated reports\n- It assumes that the same scale (-80% to +80%) is used in all PDFs and they are structured similarly.\n\n## Contributing\n\n1. Run `yarn install` to install dependencies.\n2. Install `Inkscape 1.1-dev` for your OS, and make sure the `inkscape` is available\n   as in your path as a command line utility.\n   You can test this using `inkscape --version`\n\n3. Run `yarn build` to begin downloading reports form google, and parsing it into the `ouput` folder.\n\n## Credits\n\nAll data made available for use is by taken from Google Mobility Reports.\nThis project does not claim any ownership over this data, and is not reponsible\nfor guaranteeing accuracy of this data.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpastelsky%2Fcovid-19-mobility-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpastelsky%2Fcovid-19-mobility-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpastelsky%2Fcovid-19-mobility-tracker/lists"}