API para obtener datos acerca de contagios de coronavirus (COVID-19) en Chile. Utiliza los datos oficiales del Gobierno de Chile y el Ministerio de Salud. Los datos se manejan en el repositorio hermano covid19-data y se actualizan prácticamente en tiempo real. Para más información, revisar otros datos interesantes sobre el coronavirus en Chile o revisar cómo se realiza el scraping, referir a ese repositorio.
Esta API es abierta y puede ser utilizada en cualquier proyecto. Se solicita que, en caso de utilizarla, me contactes por Telegram para poder linkear el proyecto a este repositorio y llevar un mejor manejo de en dónde se está utilizando. También me puedes enviar un correo
Cualquier persona es libre de colaborar con este proyecto. Simplemente se debe hacer un fork, añadir la característica y hacer un Pull Request bien documentado de lo que se quiere añadir. Se agradece contactarme por Telegram o mail.
Por otra parte, se agradece que reportes un bug si lo encuentras mientras estás utilizando esta API. Asimismo, también se agradece la solicitud de nuevas features. Para ambas cosas, sencillamente déjanos una Github Issue.
A continuación se detallan todas las formas para poder consumir la API acompañado del dato que se entrega. Cabe destacar que los endpoints v2 y v1 han sido deprecados.
| GET Request | Output |
|---|---|
| https://chile-coronapi.herokuapp.com/api/v3/historical/nation | Se obtienen los datos, desde el 7 de marzo hasta el día de hoy, de contagiados confirmados, muertes y "recuperados" (según el gobierno al menos, ese dato sigue siendo bastante cuestionable). Estos datos corresponden al total a nivel país. |
| https://chile-coronapi.herokuapp.com/api/v3/historical/regions | Se obtienen los datos históricos de contagiados y muertes por región. En el caso de los contagiados, los datos están disponibles desde el 7 de marzo hasta el día de hoy. Para el caso de las muertes, los datos están sólo disponibles desde el 1 de abril, que es desde dónde el Gobierno tiene publicadas las cifras oficiales. |
| https://chile-coronapi.herokuapp.com/api/v3/historical/regions?id={region-id} | Se obtienen los datos de contagiados y muertes por región de la misma forma que en el endpoint anterior, sin embargo, si se entrega el parámetro de region-id (sin los corchetes) se reciben los datos para la región indicada. Los códigos de las regiones corresponden al antiguo sistema de regiones numeradas (e.g, Metropolitana es 13.) Se pueden consultar todos los códigos de regiones disponibles utilizando el Endpoint de models que se detalla más abajo. |
| https://chile-coronapi.herokuapp.com/api/v3/historical/communes | Se obtienen los datos históricos que el Gobierno ha publicado para todas las comunas. Estos datos son entregados por parte del ministerio con poca frecuencia, usualmente cada un par de días o un poco más. Para este caso, sólo están disponibles los contagiados confirmados, que es lo único que el gobierno ha entregado de forma oficial. Usualmente un 0 representa que no hay datos significativos para esta comuna. |
| https://chile-coronapi.herokuapp.com/api/v3/historical/communes?id={commune-id} | Se obtienen los datos de la misma forma que en el endpoint anterior, sin embargo, al igual que con las regiones, se puede obtener para una comuna en específico, entregando el commune-id, sin los corchetes. La lista de los IDs de comuna está disponible en el endpoint de models de más abajo. |
| https://chile-coronapi.herokuapp.com/api/v3/latest/nation | Se obtienen los datos de contagiados, muertes y recuperados para el último día en que el gobierno ha realizado un reporte. El gobierno actualmente realiza un reporte todas las mañanas, con los datos cortados hasta el día anterior a las 21:00 hrs. |
| https://chile-coronapi.herokuapp.com/api/v3/latest/regions | Datos de regiones para el último día reportado por el ministerio. Con este endpoint se obtiene el último reporte para todas las regiones. |
| https://chile-coronapi.herokuapp.com/api/v3/latest/regions?id={region-id} | Datos de regiones para el último día reportado por el ministerio. Con este endpoint se obtiene el último reporte para la región señalada en el region-id. |
| https://chile-coronapi.herokuapp.com/api/v3/latest/communes | Datos de comunas para el último día reportado por el ministerio. Con este endpoint se obtiene el último reporte para todas las comunas. |
| https://chile-coronapi.herokuapp.com/api/v3/latest/communes?id={commune-id} | Datos de comunas para el último día reportado por el ministerio. Con este endpoint se obtiene el último reporte para la comuna señalada en el commune-id. |
| https://chile-coronapi.herokuapp.com/api/v3/models/regions | Se obtiene una lista de todas las regiones junto a su ID respectivo. |
| https://chile-coronapi.herokuapp.com/api/v3/models/communes | Se obtiene una lista con todas las comunas del país, junto a su ID y a qué región del país pertenecen. |
Los datos son las cifras oficiales publicadas por el Gobierno de Chile y el Ministerio de Salud en sus respectivos sitios web. Para los datos que se utilizan en esta API, la actualización es prácticamente en tiempo real, por medio de scraping. Esta API consume los datos directamente desde ese repositorio, por lo que los tiempos de respuesta son bastante buenos y suele ser menor a los 500 milisegundos.
En general, los datos son obtenidos desde el sitio del gobierno, que actualiza muchísimo más rápido que el sitio del ministerio de salud, a excepción de los datos respectivos a casos contagiados, que sólo se publican en el sitio del Minsal.
Los datos de las regiones son obtenidos desde el sitio del INE e incluyen datos como:
- Nombre de la región
- Información de la región como:
- Código de región, que corresponde al antiguo sistema de regiones numeradas(Ej. Metropolitana es 13).
- Latitud y Longitud
- Población de la región
- Área geográfica en km² de la región
Los datos son obtenidos mayoritariamente desde el sitio de la biblioteca del congreso nacional e incluyen:
- Nombre de la comuna
- Información de la comuna tal como
- Id o CUT (Código Único Territorial)
- Área geográfica en km² de la comuna
- Índice de desarrollo humano (Hay unas comunas que su valor es 0, pues no hay datos de ellas).
- Número de habitantes de la comuna
- Región y código de ésta que corresponde al antiguo sistema de regiones numeradas
Aquí se actualizan las cosas en las que actualmente se está trabajando. En este momento no se está trabajando en nada en particular. Recuerda que puedes solicitar características por medio de Github Issues.
Basta con clonar el repositorio, e instalar los requerimientos:
pip install requirements.txt
Luego usar los archivos .template para generar el setup.py y el .env. Vienen configurados con las variables por defecto para trabajar en development. Se debe especificar una SECRET_KEY sólo en producción. Esto se puede hacer, por ejemplo, ejecutando en la consola de python:
import uuid
uuid.uuid4().hexPara correr la aplicación en un servidor local, se puede hacer simplemente ejecutando flask run en la raíz del proyecto.
- Cristóbal Mesías @cmesiasd. Ha trabajado principalmente en la implementación del scraping y solución de bugs de la API.
- Fabián Villena @fvillena. Ha agregado información por comuna, como el área geográfica, el indice de desarrollo humano y la cantidad de población de ellas.