This repo is not maintained.
An API to query the location data for COVID-19 diagnosed cases. Built during the COVID-19 Global Hackathon
This project pivoted to a contact tracing app and backend.
Tracking the spread of the virus is immensly valuable. But if everyone rolls their own solution for collecting this data its value is diminished. By being API only we make the data set easy to access and easy to contribute too. Giving other devs a head start on their solution building.
To kick things off we've provided a simple website any COVID-19 positive users can use to anonymously submit their location data to help track the spread.
Please use our API to get COVID-19 patient's historic location data or to submit location history. Use it ethically to build solutions to help fight the virus. Please share it, let's build a single source of truth with critical mass.
Alternatively feel free to fork this if you need to roll your own solution.
Postman collection here.
Get location data for COVID-19 patients.
Method: GET
| Name | Required | Description |
|---|---|---|
| geo-within | Yes | A valid Geo JSON geometry object |
| skip | No | An integer, skip the first n records |
| limit | No | Get up to this many records back, max limit is 500 |
Returns a Geo JSON FeatureCollection
Example url path.
/location-history?geo-within=%7B%22type%22%3A%22Polygon%22%2C%22coordinates%22%3A%5B%5B%5B100%2C-20%5D%2C%5B110%2C-20%5D%2C%5B110%2C-30%5D%2C%5B100%2C-30%5D%2C%5B100%2C-20%5D%5D%5D%7D
Submit location history for a diagnosed COVID-19 patient. All location history must be stored as a GeoJSON Feature Collection.
Method: POST
| Name | Required | Description |
|---|---|---|
| type | Yes | Accepts only a value of "FeatureCollection" |
| features | Yes | An array of Geo JSON Feature records |
e.g.
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
50.123,
51.321,
0
]
}
}
]
}