pytrend

La librería Python for Itrend (pytrend) permite acceder a los distintos conjuntos de datos de la Plataforma de Datos de Itrend. La librería es completamente abierta, pero para acceder a los datos se requieren credenciales de acceso administradas por Itrend propiamente tal.

• Autor: Sebastián Castro
• Version: 1.0.1
• Fecha: 04 de Enero de 2024

Otras versiones, tanto anteriores como de desarrollo, están publicadas en la sección Releases.

Requisitos

• Python 3.7+
• urllib
• requests

Para acceder a la descarga de datos y metadatos se requieren credenciales de acceso, las cuales se obtienen a través de la Plataforma de Datos.

Ejemplos

Configuración de credenciales

import pytrend

session = pytrend.itrend_developer_tools()

session.set_credentials(
    access_key_id = '',    # Ingresa tu access_key_id
    secret_access_key = '' # Ingresa tu secret_access_key
)

Obtener formatos disponibles de un conjunto de datos

dataset_id = '492F65B350AAF9D1' # Base de datos histórica de cicatrices de incendios chilenos - 1. Resumen
formats = session.get_dataset_formats(dataset_id)

Obtener formatos disponibles de los elementos de una colección

dataset_id = 'ZW5TFERBT8B0GMQ' # Registro de eventos sísmicos significativos
element_formats = session.get_element_formats(dataset_id)

Descargar un conjunto de datos

dataset_id = '40JUKMAQLGUV53P' # División Política Administrativa a nivel comunal
fmt = 'shp'
response = session.download_file(dataset_id, fmt)
filename = response.get('filename')
delimiter = response.get('delimiter') # Útil cuando se descarga un csv

Descargar un elemento de una colección

dataset_id = '472AE6E9AD343E6' # Modelos de fallas finitas del USGS
collection_id = 'ID'
fmt = 'csv'

# Descargamos y leemos la tabla
response = session.download_file(dataset_id, fmt)
filename = response.get('filename')
delimiter = response.get('delimiter')
df = pd.read_csv(filename, delimiter)

# Descargamos un elemento
element_formats = session.get_element_formats(dataset_id)
efmt = element_formats[0] # Escoger el formato que más le acomode

for r, row in df.iterrows():
    element_id = str(row[collection_id])
    element_response = session.download_file(dataset_id, efmt, element_id)
    break