Consumir datos de la API de Aragón Open Data desde cero

Cuando trabajamos con datos abiertos, muchas veces necesitamos consultar información actualizada sin tener que descargar archivos continuamente. Aragón Open Data ofrece una forma sencilla de acceder a determinados datos de forma automatizada mediante GA_OD_Core.

¿Qué es GA_OD_Core?

GA_OD_Core (Gobierno de Aragón Open Data Core) permite extraer los datos directamente desde la fuente original. Esto permite consultar siempre la información más reciente y utilizarla en páginas web, informes, cuadros de mando o pequeñas aplicaciones.

La URL base para hacer la consulta es: https://opendata.aragon.es/GA_OD_Core.

A partir de esta dirección se pueden realizar distintas consultas para visualizar información, descargar datos o aplicar filtros para mostrar únicamente los resultados que interesen.

Cómo acceder a los datos

La consulta básica para visualizar el conjunto de datos es la siguiente:

https://opendata.aragon.es /GA_OD_Core/preview?view_id={view_id}

Al sustituir {view_id} por el identificador correspondiente, la consulta devuelve la información disponible.

Para saber el view_id podemos consultar todos los conjuntos de datos disponibles en GA_OD_Core mediante el enlace https://opendata.aragon.es/GA_OD_Core/views o en el portal de Open Data podemos copiar el enlace del recurso. Cabe destacar que no todos los recursos están disponibles mediante GA_OD_Core, podremos identificarlo por la URL.

• /download: permite descargar los datos
• /preview: devuelve una lista con los resultados de la consulta. Si necesitas ajustar los datos que se muestran, se pueden usar filtros para personalizar la búsqueda según las necesidades.

Cómo filtrar los datos

El volumen de datos de un recurso puede ser extenso. Para visualizar únicamente la información que sea de nuestro interés podemos aplicar filtros. Para ello, después del view_id debemos añadir &filters en el enlace y, a continuación, detallar el filtro que queremos aplicar.

La forma más básica de filtrado es buscar valores concretos en una columna. Es decir, pedir que los datos estén filtrados por que coinciden exactamente con un valor.

Para el filtro de igualdad, después de filters= dentro de las llaves {}, hay que poner el nombre de la columna entre comillas, dos puntos, y el valor exacto que buscas entre comillas.

Cómo elegir formato y descargar los datos

Una vez que hemos comprobado que la consulta devuelve la información deseada, podemos descargar nuestros datos filtrados para utilizarlos en otras herramientas. Cabe destacar que no siempre es necesario descargar los datos, como veremos en el ejemplo de uso en este post, en algunas herramientas se puede utilizar el enlace de la previsualización (preview).

Para descargar los datos, debemos reemplazar preview por download y, además, debemos indicar el formato en el que queremos descargar los datos utilizando format.

Después de format=, dentro de las llaves {} tenemos que especificar el formato de descarga, como por ejemplo: csv, xlsx o json.

Ejemplo real de uso

Imagina que quieres desarrollar un visor con información sobre los centros de salud en tu provincia. En lugar de descargar manualmente los datos cada semana, la aplicación consulta directamente la API GA_OD_Core para obtener siempre la información actualizada. Es decir, que utilizaremos una URL con filtros como origen de los datos de nuestro visor.

1. Consultar las vistas disponibles:

https://opendata.aragon.es/GA_OD_Core/views

2. Consultar datos de una vista concreta

https://opendata.aragon.es//GA_OD_Core/preview?view_id=286

3. Filtrar por provincia

https://opendata.aragon.es//GA_OD_Core/preview?view_id=286&filters={"provincia":"HUESCA"}

4. Cargar los datos en una herramienta para hacer las visualizaciones, por ejemplo, en PowerBI.

Se puede consultar información más detallada sobre el uso de GA_OD_Core en /GA_OD_Core/ui o en el apartado de herramientas para usuarios y desarrolladores. Además, la interfaz Swagger disponible en https://opendata.aragon.es/GA_OD_Core/ui/  facilita las pruebas y consultas de la API, ya que permite construir filtros y ejecutar peticiones de forma visual sin necesidad de crear manualmente la URL desde cero.

Operaciones Avanzadas

Además de la igualdad estricta, también se pueden utilizar otros filtros, que permiten definir condiciones más específicas como, por ejemplo, mayor o igual. En concreto los operadores son:

• $gt: Mayor que.
• $gte: Mayor o igual que.
• $lt: Menor que.
• $lte: Menor o igual que.
• $eq: Igual a.
• $ne: Distinto de.

Para ello, el filtro se construye de la misma forma que el anterior, con la diferencia que delante del valor añadiremos uno de los operadores listados anteriormente seguido de dos puntos y el valor. Por ejemplo, para buscar un valor menor usaremos:

En ocasiones, un solo filtro no es suficiente para obtener la información exacta que necesitamos. Por ello se pueden combinar varios criterios en una misma consulta para realizar búsquedas más complejas y específicas.

Los operadores lógicos que permiten combinar múltiples criterios son:

• $and: Todas las condiciones deben cumplirse.
• $or: Al menos una condición debe cumplirse.
• $not: La condición no debe cumplirse.

Para combinar filtros, el operador lógico se coloca al principio, después de la primera llave {, entre comillas y después de dos puntos se añaden las condiciones que se agrupan dentro de corchetes [], separadas por una coma:

Para aterrizar la teoría en un ejemplo ficticio de una situación muy cotidiana: cuando entramos a una tienda de ropa online y usamos los menús para buscar una prenda. Aunque no los veamos, la web utiliza filtros por detrás para esconder los miles de abrigos o pantalones que no nos interesan y mostrarnos solo lo que queremos comprar.

Si trasladamos los códigos anteriores a nuestro inventario ficticio de ropa, los filtros se aplicarían de la siguiente forma:

• Para buscar un artículo exacto: Si solo queremos ver las camisetas de la tienda, le pedimos al sistema que busque en la columna "prenda" el valor exacto "camiseta". El enlace quedaría así: ...&filters={"prenda": "camiseta"}
• Para buscar por precio (Menor que): Si tenemos un presupuesto ajustado y queremos ver únicamente la ropa que cuesta menos de 15€, usamos el código $gt (mayor que) en la columna "precio":  …&filters={"precio": {"$lt": “15”}}
• Para buscar camisetas de menos de 15€: Si queremos buscar únicamente camisetas y con la condición de que sean baratas: ...&filters={"$and": [{"prenda": {"$eq": "camiseta"}}, {"precio": {"$lt": 15}}]}