Datos gov

Este módulo permite conectar y evaluar desde el código los metadatos del Portal de Datos Abiertos y descargar las bases de datos a dataframes.

Advertencia

El módulo de Datos gov utiliza la API de Socrata. Esta permite hacer peticiones para la descarga de datos sin utilizar un token de identificación. Sin embargo, se recomienda crear una cuenta y su respectivo token para evitar que las descargas tengan limitaciones de tamaño y cantidad en los conjuntos de datos.

La cuenta de usuario puede ser creada desde el portal de Datos Abiertos de Colombia. Es posible solicitar su token con el siguiente enlace Solicitud token Socrata o también puede tener acceso desde la documentación de API de algún conjunto de datos.

datos_gov.cargar_base(api_id, token=None, limite_filas=1000000000)

Se conecta al API de Socrata y retorna la base de datos descargada del Portal de Datos Abiertos como dataframe. Ver ejemplo

Advertencia

Al descargar una base de datos utilizando el API de Socrata, esta omitirá cualquier columna que no contenga registros, lo cual puede generar inconsistencias con la información descrita en el portal de datos abiertos.

Parámetros:
  • api_id – (str) Identificación de la base de datos asociado con la API de Socrata.
  • token – (str) opcional - token de usuario de la API Socrata.
  • limite_filas – (int) (valor mayor a 0), indica el número máximo de filas a descargar de la base de datos asociada al api_id. El límite está pensado para bases de gran tamaño que superen la capacidad del computador.
Devuelve:

base de datos en formato dataframe.
datos_gov.filtrar_tabla(columnas_valor, token=None)

Permite filtrar la base de datos de tabla de inventario de acuerdo con diferentes términos de búsqueda. Como son fechas, textos y otros. Ver ejemplo

Parámetros:
  • columnas_valor – (diccinario) {“nombre de columna”:”valor a buscar o rangos”}. Corresponde al nombre de la columna a consultar y el valor a buscar.
  • token – (str) opcional - token de usuario de la API Socrata.
Devuelve:

dataframe Asset Inventory filtrado con los términos de búsqueda).
datos_gov.tabla_inventario(token=None, limite_filas=1000000000)

Se conecta al API de Socrata y retorna la base de datos Asset Inventory descargada del Portal de Datos Abiertos como dataframe. Este conjunto de datos es un inventario de los recursos en el sitio. Ver ejemplo

Parámetros:
  • token – (str) opcional - token de usuario de la API Socrata.
  • limite_filas – (int) (valor mayor a 0), indica el número máximo de filas a descargar de la base de datos asociada al api_id. El límite está pensado para bases de gran tamaño que superen la capacidad del computador.
Devuelve:

base de datos en formato dataframe.