datos-cuarentenaBO

Propósito

Con el crecimiento de los casos confirmados de coronavirus, desde el 22 de marzo rige en nuestro país una cuarentena total dictada por el gobierno nacional, con limites finales inciertos. La medida tiene como objetivo frenar los contagios vía restricciones en el desplazamiento y las reuniones, pero al mismo tiempo existe cierta incertidumbre en cuanto al abastecimiento de productos alimenticios, la atención de servicios de salud y otros. Algunos ciudadanos no contamos con la suficiente información para viabilizar de forma más cercana y efectiva esas necesidades básicas.

¿Por qué datos abiertos?

Porque son la base para fomentar un ecosistema de actores que genere productos informativos como visualizaciones, apps, análisis de datos, investigaciones, toma de decisiones ciudadanas y políticas, planificación territorial, etc. En nuestro país aun no existen muchas iniciativas de datos abiertos por parte de los gobernantes. En nuestra propia búsqueda para desarrollar apps y analisis de datos no hemos encontrando disponibilidad de datos en repositorios gubernamentales, por lo que hemos emprendido esta iniciativa ciudadana.

Metodología

Hemos realizado tres formas de recolección de los datos aquí agrupados. Primero, hemos transcrito manualmente los mensajes de ayuda e imagenes en Facebook, Twitter y WhatsApp que nos llegaban. Segundo, hemos buscado y filtrado datos geográficos disponibles. Tercero, hemos hecho scraping de algunos sitios web con información pública relevante, cuando era posible. Posteriormente hemos limpiado un poco esa información y la hemos transformado en formatos abiertos para mayor fácilidad de uso de las diversas iniciativas ciudadanas. Las fuentes consultadas se enlistan al final.

Valga aclarar que este es un trabajo aún en curso, todo aporte o corrección es bienvenido.

Versionado

La versión 1 (v1) de este repositorio tiene diferentes modelos de datos, pues los datos provienen de diversas fuentes. Si uno busca datos sobre mercados, por ejemplo, algunas fuentes estarán más completas que otras, tanto en atributos como en extensión. La versión 2 (v2) de la API cuenta con un sólo modelo general para todas la fuentes y es una base más limpia, aunque la cantidad de campos se reduce a 8. Pueden usar la versión que más les convenga, la v2 sin embargo es mucho más uniforme y clara.

API v2 (¡NUEVA!)

7558 registros disponibles a nivel Bolivia. Esta es la versión más limpia y unificada de la API. Los campos para todas las fuentes disponibles son:

Y se usa null para los datos no disponibles, ya no NA.

Sobre la URL de base https://lab-tecnosocial.github.io/datos-cuarentenaBO, se ha simplificado las solicitudes a tres:

Para más ejemplos: Ver la documentación de la v2.

Esta es una visualización general de los puntos disponibles:

API v1 (antigua)

Cantidad de registros

Departamento Número de registros
La Paz Abastecimiento: 150
  Entidades financieras: 779
  Farmacias: 470
  Servicios de salud: 202
Santa Cruz Abastecimiento: 331
  Servicios de salud: 77
Cochabamba Mercados: 112
  Servicios de salud: 152
Bolivia Mercados en Bolivia (GeoBolivia 2017): 629
  Farmacias, bancos, servicios de salud (OpenStreetMap): 3680
  Alimentos (diversas fuentes web): 381
  Servicios(diversas fuentes web): 367
  Salud (diversas fuentes web) :129

Uso

La URL de base es https://lab-tecnosocial.github.io/datos-cuarentenaBO. Dado que es una API estática solo soporta solicitudes GET sin parametros.

La /v1/ tiene la siguiente estructura con sus respectivos endpoints:

├── gamcb
├── gamlp
│   ├── Abasto.csv
│   ├── Abasto.json
│   ├── CentrosDesarrolloSocial.csv
│   ├── CentrosDesarrolloSocial.json
│   ├── EntidadesFinancieras.csv
│   ├── EntidadesFinancieras.json
│   ├── EstacionesServicio.csv
│   ├── EstacionesServicio.json
│   ├── Farmacias.csv
│   ├── Farmacias.json
│   ├── Mercados.csv
│   ├── Mercados.json
│   ├── ModulosPoliciales.csv
│   ├── ModulosPoliciales.json
│   ├── PuntosVerdes.csv
│   ├── PuntosVerdes.json
│   ├── Salud.csv
│   ├── Salud.json
│   ├── Supermercados.csv
│   └── Supermercados.json
├── gamsc
│   ├── abastecimiento-emergencia
│   │   ├── Mercados.csv
│   │   ├── Mercados.json
│   │   ├── MercadosMovil.csv
│   │   ├── MercadosMovil.json
│   │   ├── Supermercados.csv
│   │   └── Supermercados.json
│   ├── edificios-administrativos
│   │   ├── Edificio_adm_salud.json
│   │   └── Sub_alcaldias_distritales.json
│   ├── infraestructura-social
│   │   ├── CentroAdultoMayor.csv
│   │   ├── CentroAdultoMayor.json
│   │   ├── GuarderiaMunicipal.csv
│   │   └── GuarderiaMunicipal.json
│   ├── salud
│   │   ├── Centro_salud_12hrs.csv
│   │   ├── Centro_salud_12hrs.json
│   │   ├── Centro_salud_24hrs.csv
│   │   ├── Centro_salud_24hrs.json
│   │   ├── Hospital_2do_nivel.csv
│   │   └── Hospital_2do_nivel.json
│   ├── secretaria-municipal
│   │   └── Secretarias_municipales.json
│   └── seguridad-ciudadana
│       ├── CentroSeguridad.csv
│       ├── CentroSeguridad.json
│       ├── EstacionesPoliciales.csv
│       └── EstacionesPoliciales.json
├── geobo
│   ├── Mercados2017.csv
│   └── Mercados2017.json
├── osm
│   ├── Bank.csv
│   ├── Bank.json
│   ├── Clinic.csv
│   ├── Clinic.json
│   ├── Doctors.csv
│   ├── Doctors.json
│   ├── Hospital.csv
│   ├── Hospital.json
│   ├── Pharmacy.csv
│   └── Pharmacy.json
├── rmk
│   ├── Mercados.csv
│   ├── Mercados.json
│   ├── Salud.csv
│   └── Salud.json
└── web
    ├── Alimentos.csv
    ├── Alimentos.json
    ├── Salud.csv
    ├── Salud.json
    ├── Servicios.csv
    └── Servicios.json

Por ejemplo, para solicitar los datos de alimentos se agrega la terminación /v1/web/alimentos.json a la url de base. Notese que todos los endpoints empiezan con mayuscula y necesariamente deben contar con la extensión final .json. Para una explicación con más ejemplos puede verse la documentación v1. No todos los datos están georeferenciados o están completos; para los casos donde no se tienen los datos disponibles pusimos la marca de NA, mientras que para los datos no relevantes para un caso null.

Proyectos que usan este repositorio

Los siguientes proyectos hacen uso de este repositorio:

ALICIA (Asistente en Línea de Información sobre el COVID-19 usando Inteligencia Artificial) es un asistente virtual inteligente que se presenta en las aplicaciones de Facebook y Whatsapp. Está disponible las 24 horas del día para responder preguntas frecuentes, mostrar los casos de COVID-19 en Bolivia, contactarte con un médico en línea y brindar una guía para ayudar a los demás en caso de ser un doctor.

Si estas utilizando los datos de este repositorio, avisanos para incluir un enlace a tu proyecto en este espacio y también te ayudaremos a promocionar tu proyecto en nuestros canales sociales.

Soporte y aporte

Si necesitas ayuda con estos datos para integrarlos a tu aplicación o análisis, o encuentras errores, bugs, o quieres aportar con más datos, ideas o código, nos encontramos en el siguiente servidor de Discord. Estaremos activos minimamente hasta que terminen las medidas de cuarentena. El repositorio se encuentra aquí. Si quieres un Google Sheet de los datos lo puedes encontrar aquí.

Fuentes