Ayuda

Ayuda - Portal de Datos Abiertos EMUASA

1. ¿Qué es este portal?

El Portal de Datos Abiertos de EMUASA es una plataforma que permite acceder, consultar y reutilizar información pública generada por la entidad. Su objetivo es fomentar la transparencia, la innovación y la reutilización de datos por parte de ciudadanos, empresas y desarrolladores.

Los datos están disponibles en formatos abiertos y reutilizables, bajo licencia abierta (Creative Commons Attribution - CC BY), lo que permite su uso incluso con fines comerciales, siempre que se cite la fuente.

2. ¿Cómo usar el portal?

Buscar información

Puedes buscar conjunto de datoss utilizando el buscador principal introduciendo palabras clave relacionadas con la información que necesitas (por ejemplo, "energía", "consumo" o "instalaciones"). El sistema mostrará resultados relevantes que puedes explorar directamente.

También puedes navegar por las distintas categorías o verticales temáticas del portal, que agrupan los datos según su ámbito (por ejemplo, ciudadanía, energía o gestión de aguas). Esta opción es especialmente útil si no tienes claro qué conjunto de datos concreto buscas y prefieres explorar la información disponible de forma guiada.

Filtrar resultados

Los conjunto de datoss pueden filtrarse utilizando distintas opciones que te ayudarán a encontrar la información de forma más rápida y precisa:

Temática: permite acotar los resultados según el ámbito (por ejemplo, energía, ciudadanía o aguas residuales).
Formato: útil si necesitas trabajar con un tipo de archivo concreto (CSV para Excel, JSON para desarrollo, Shapefile para GIS, etc.).
Etiquetas: palabras clave asociadas al conjunto de datos que facilitan localizar información específica.

Puedes combinar varios filtros a la vez para refinar la búsqueda. Por ejemplo, podrías buscar conjunto de datoss de "energía" en formato CSV y ordenarlos por fecha para obtener los más recientes. Esto resulta especialmente útil cuando el portal contiene un gran volumen de información.

Acceder a un conjunto de datos

Dentro de cada conjunto de datos encontrarás varios elementos que te ayudarán a entender y utilizar la información correctamente:

Descripción: explica el contenido del conjunto de datos, su propósito y el tipo de información que incluye. Es el primer punto que debes revisar para saber si el conjunto de datos se ajusta a lo que necesitas.
Recursos disponibles (archivos o APIs): son los datos en sí. Un mismo conjunto de datos puede contener varios recursos en distintos formatos (por ejemplo, CSV para análisis en Excel, JSON para desarrollo o servicios API para consultas automáticas). Cada recurso puede representar una vista distinta de la información.
Información adicional (metadatos): incluye detalles técnicos y contextuales como la fecha de actualización, periodicidad, cobertura geográfica, responsable del conjunto de datos o licencias de uso. Esta información es clave para evaluar la calidad y actualidad de los datos.

Se recomienda revisar estos tres apartados antes de descargar o reutilizar la información, para asegurarse de que el conjunto de datos es adecuado para el uso que se le quiere dar.

Descargar datos

Cada conjunto de datos incluye uno o varios recursos que pueden descargarse directamente desde el propio portal.

Los datos están disponibles en distintos formatos adaptados a diferentes usos:

CSV (valores separados por comas): recomendado para análisis en herramientas como Excel o LibreOffice. Es el formato más sencillo para usuarios no técnicos.
JSON: orientado a desarrolladores y aplicaciones. Permite integrar los datos fácilmente en sistemas externos o realizar procesamientos automáticos.
Formatos geográficos (como Shapefile): utilizados para representar información sobre mapas en herramientas como QGIS.

En muchos casos, un mismo conjunto de datos ofrece varios formatos para un mismo recurso. Se recomienda elegir el formato en función del uso que se le quiera dar: análisis manual, desarrollo de aplicaciones o visualización geográfica.

Formatos disponibles: habitualmente encontrarás CSV (ideal para Excel), JSON (para desarrollo) o formatos geográficos como Shapefile.
Descarga individual: puedes descargar cada recurso por separado según el formato que necesites.
Elección del formato: si solo quieres analizar datos rápidamente, elige CSV; si vas a integrarlos en una aplicación, JSON suele ser más adecuado.

Antes de descargar, revisa la descripción y los metadatos para asegurarte de que el recurso contiene exactamente la información que necesitas.

Puedes compartir cualquier conjunto de datos o recurso mediante enlaces directos:

Enlace al conjunto de datos: permite compartir la página completa con toda la información y sus recursos.
Enlace a un recurso concreto: útil si quieres que otra persona acceda directamente a un archivo específico.

Esto facilita la colaboración y el intercambio de información, ya sea entre equipos internos o con terceros, sin necesidad de enviar archivos manualmente.

3. Visualización de datos

Algunos conjunto de datoss incluyen gráficos interactivos que facilitan la interpretación de la información sin necesidad de descargar los datos.

Estos gráficos permiten analizar la información desde diferentes perspectivas según el tipo de datos disponible. Por ejemplo, las series temporales (líneas) muestran la evolución de un indicador a lo largo del tiempo, lo que resulta útil para detectar tendencias, estacionalidad o cambios relevantes. Los gráficos de barras permiten comparar valores entre distintas categorías (como instalaciones o zonas), mientras que los gráficos de barras apiladas ayudan a entender cómo se compone un total a partir de varias partes.

En otros casos, los gráficos de áreas permiten visualizar volúmenes acumulados a lo largo del tiempo, y los gráficos de dispersión (scatter) muestran la relación entre dos variables, siendo especialmente útiles para identificar correlaciones o valores atípicos. Para representaciones más simples, los gráficos circulares (pie o donut) muestran la proporción de cada categoría dentro de un total.

Cuando el conjunto de datos incluye información geográfica, pueden utilizarse mapas, que permiten analizar la distribución espacial de los datos de forma visual.

El tipo de visualización disponible dependerá de la estructura del conjunto de datos, pero en todos los casos los gráficos están diseñados para facilitar una comprensión rápida e intuitiva de la información.

4. API y reutilización de datos

El portal permite acceder y reutilizar la información de forma automatizada mediante una API. Esto facilita la integración de los datos en aplicaciones externas, cuadros de mando, procesos de análisis o sistemas de terceros.

¿Qué es la API?

La API (Interfaz de Programación de Aplicaciones) es un conjunto de endpoints que permiten consultar los datos del portal sin necesidad de usar la interfaz web. A través de peticiones HTTP, es posible listar conjuntos de datos, acceder a sus recursos y realizar consultas sobre la información publicada.

Documentación de la API

El portal dispone de una documentación interactiva accesible en:

Acceder a la documentación de la API

En esta sección podrás:

Explorar todos los endpoints disponibles
Ver los parámetros de cada operación
Ejecutar pruebas directamente desde el navegador
Consultar ejemplos de respuestas

Se recomienda utilizar esta documentación como punto de partida para cualquier integración.

Ejemplos de uso habituales

Listar conjuntos de datos:

/api/3/action/package_list

Consultar un conjunto de datos concreto:

/api/3/action/package_show?id=identificador_del_conjunto

Acceder a recursos y datos: Permite obtener la información contenida en los recursos asociados a un conjunto de datos.

Estos endpoints pueden utilizarse desde herramientas como Postman, scripts en Python o aplicaciones web.

Reutilización de datos

La API permite construir soluciones sobre los datos publicados, como:

Integraciones en aplicaciones propias
Dashboards o cuadros de mando
Procesos automáticos de análisis
Servicios basados en datos abiertos

API Key

Algunas operaciones pueden requerir autenticación mediante API Key. En esos casos, será necesario incluir la clave en las cabeceras de la petición para poder acceder a determinadas funcionalidades o datos protegidos.

Si necesitas obtener una API Key o tienes dudas sobre cómo utilizarla, puedes ponerte en contacto con nosotros a través de la página de contacto.

5. Formatos de datos

Los conjuntos de datos del portal están disponibles en distintos formatos abiertos, diseñados para adaptarse a diferentes tipos de uso, desde análisis básicos hasta integraciones técnicas avanzadas.

CSV (valores separados por comas): es el formato más sencillo y extendido. Permite trabajar con los datos en herramientas como Excel o LibreOffice, realizar filtros, tablas dinámicas o análisis básicos sin necesidad de conocimientos técnicos. Es la opción recomendada para la mayoría de usuarios.
JSON: es un formato estructurado orientado a desarrollo. Se utiliza principalmente para integrar los datos en aplicaciones, scripts o servicios externos. Permite trabajar con los datos de forma automatizada y es habitual en entornos web y APIs.
Shapefile (u otros formatos geográficos): se utiliza cuando los datos tienen componente espacial (por ejemplo, localización de instalaciones). Estos formatos permiten visualizar y analizar la información sobre mapas utilizando herramientas como QGIS.

Es habitual que un mismo conjunto de datos disponga de varios formatos para un mismo recurso, lo que permite elegir el más adecuado según el uso que se le quiera dar.

¿Qué formato debo elegir?

Si quieres consultar o analizar datos de forma sencilla, utiliza CSV.
Si necesitas integrar los datos en una aplicación o automatizar procesos, utiliza JSON o la API.
Si vas a trabajar con información geográfica o mapas, utiliza Shapefile.

Elegir correctamente el formato facilita el trabajo y evita conversiones innecesarias.

Herramientas recomendadas

CSV: Excel, LibreOffice Calc
JSON: herramientas de desarrollo, editores de código o scripts (por ejemplo, Python)
Shapefile: QGIS u otras herramientas GIS

Antes de trabajar con los datos, se recomienda revisar la descripción y los metadatos del conjunto de datos para entender su estructura, significado y posibles limitaciones.

6. Preguntas frecuentes (FAQ)

¿Puedo reutilizar los datos?

Sí. Los datos se publican bajo licencia abierta Creative Commons Attribution (CC-BY), lo que permite su uso, modificación y redistribución, incluso con fines comerciales, siempre que se cite la fuente (EMUASA). Se recomienda revisar en cada conjunto de datos la licencia específica y cualquier nota adicional sobre uso.

¿Los datos están actualizados?

La actualización depende de cada conjunto de datos y de su fuente de origen. En la sección de metadatos podrás consultar la fecha de última actualización y, en algunos casos, la periodicidad (diaria, mensual, anual, etc.). Si necesitas confirmar la vigencia de un dato concreto, revisa estos metadatos antes de utilizarlo.

¿Puedo solicitar nuevos datos?

Sí. Si no encuentras la información que necesitas, puedes solicitar la publicación de nuevos conjuntos de datos o la ampliación de los existentes.

Puedes hacerlo a través de la página de contacto.

Además, en cada conjunto de datos dispones de una sección de comentarios, donde puedes plantear solicitudes o sugerencias específicas relacionadas con ese contenido. Este canal es especialmente útil para peticiones concretas sobre un conjunto de datos ya publicado.

¿Qué hago si encuentro un error?

Si detectas errores, inconsistencias o problemas en los datos, puedes comunicarlos para su revisión.

Tienes dos vías principales:

A través de la página de contacto: Contactar con EMUASA
Mediante la sección de comentarios del propio conjunto de datos, donde puedes describir el problema de forma específica (por ejemplo, un valor incorrecto, un formato erróneo o falta de actualización).

Indicar el mayor detalle posible (conjunto de datos, recurso, campo afectado, etc.) ayudará a resolver la incidencia más rápidamente.