SAICA Ebro es una red de control de calidad de las aguas en tiempo real.
Está compuesta de una serie de estaciones de control automatizadas y desasistidas que analizan de forma continua la calidad del agua en distintos puntos de la cuenca, y envían la información al centro de control ubicado en la sede central de la CHE.
La información recibida se pone a disposición pública a través de este sitio web.
Debido a las características de las instalaciones (automáticas y desasistidas) los resultados recibidos y publicados tienen carácter de provisionalidad, y están sujetos a tareas de revisión y validación.
Está compuesta de una serie de estaciones de control automatizadas y desasistidas que analizan de forma continua la calidad del agua en distintos puntos de la cuenca, y envían la información al centro de control ubicado en la sede central de la CHE.
La información recibida se pone a disposición pública a través de este sitio web.
Debido a las características de las instalaciones (automáticas y desasistidas) los resultados recibidos y publicados tienen carácter de provisionalidad, y están sujetos a tareas de revisión y validación.
- Inicio
- >>
- Consulta datos formato JSON
Consulta de datos en formato JSON
Introducción y objetivos
Se han recibido peticiones, por parte de distintos usuarios, expresando interés en poder
acceder a los resultados generados por SAICA-Ebro en formatos que permitan incorporarlos en
su propios sistemas.
Para facilitar el acceso a la información se han programado tres páginas de consulta, que permiten obtener resultados de sendas entidades.
Para facilitar el acceso a la información se han programado tres páginas de consulta, que permiten obtener resultados de sendas entidades.
- Estaciones de control implantadas en el sistema
- Señales asociadas a las estaciones de control
- Medidas recibidas de una señal en un periodo de fechas
Consulta de las estaciones de control implantadas en el sistema
Página:
https://saica.chebro.es/query_estaciones_json.php
Parámetros GET: No admite
Parámetros GET: No admite
| Campo | Tipo | Descripción contenido |
|---|---|---|
| estacion_codigo | Numérico | Código único asignado a la estación |
| estacion_descripcion | Texto | Nombre identificativo |
| estacion_activa | Numérico (0/1) | ¿Está activa? (Sí - 1 / No - 0) |
| estacion_longitud | Numérico | Ubicación: longitud (en grados) |
| estacion_latitud | Numérico | Ubicación: latitud (en grados) |
| estacion_comentario | Texto | Comentario general asociado |
Consulta de las señales asociadas a las estaciones de control
Página:
https://saica.chebro.es/query_tags_json.php
Parámetros GET. Admite el parámetro opcional estacion, cuyo valor debe corresponderse con el código de una de las estaciones del sistema.
Si la llamada se realiza sin parámetro, devuelve las señales configuradas para todas las estaciones de control.
Si el código de la estación suministrado es incorrecto, se devuelve un JSON con la parte de datos vacía.
Ejemplo de llamada (recuperar las señales para la estación de código 903):
https://saica.chebro.es/query_tags_json.php?estacion=903
Parámetros GET. Admite el parámetro opcional estacion, cuyo valor debe corresponderse con el código de una de las estaciones del sistema.
Si la llamada se realiza sin parámetro, devuelve las señales configuradas para todas las estaciones de control.
Si el código de la estación suministrado es incorrecto, se devuelve un JSON con la parte de datos vacía.
Ejemplo de llamada (recuperar las señales para la estación de código 903):
https://saica.chebro.es/query_tags_json.php?estacion=903
| Campo | Tipo | Descripción contenido |
|---|---|---|
| tag_codigo | Numérico | Código único asignado a la señal |
| tag_estacion | Numérico | Código de la estación |
| tag_activo | Numérico (0/1) | ¿Está la señal actualmente activa? (Sí - 1 / No - 0) |
| tag_descripcion | Texto | Descripción de la señal, incluyendo las unidades de medida |
Consulta de las medidas quinceminutales correspondientes a una señal de una estación para un periodo de fechas determinado
Página:
https://saica.chebro.es/query_data_json.php
Parámetros GET. Es obligatorio pasar a la llamada un parámetro relacionado con la señal:
https://saica.chebro.es/query_data_json.php?tag=7380&fini=2023-04-17&ffin=2023-04-19
En el encabezado del fichero JSON se incluye información en formato descriptivo de la señal (estación a que corresponde, descripción de la señal y unidades de medida, así como el significado de los distintos códigos de estado de validación).
Parámetros GET. Es obligatorio pasar a la llamada un parámetro relacionado con la señal:
- el código de la señal (parámetro tag)
- la fecha inicial de consulta (parámetro fini)
- la fecha final de consulta (parámetro ffin)
https://saica.chebro.es/query_data_json.php?tag=7380&fini=2023-04-17&ffin=2023-04-19
Las fechas deben suministrarse a la llamada en formato YYYY-MM-DD.
En la cadena de fecha se admite cualquier otro separador distinto del guión.
Solo se gestionan las fechas a nivel de día. Cualquier marca de hora adicional incluida no genera error, pero es ignorada.
Las fechas iniciales y finales se interpretan como fecha-hora a las 00:00:00, no como días completos.
En la cadena de fecha se admite cualquier otro separador distinto del guión.
Solo se gestionan las fechas a nivel de día. Cualquier marca de hora adicional incluida no genera error, pero es ignorada.
Las fechas iniciales y finales se interpretan como fecha-hora a las 00:00:00, no como días completos.
| Campo | Tipo | Descripción contenido |
|---|---|---|
| fecha | Fecha-hora | Fecha-hora a que corresponde la medida |
| valor | Numérico | Valor de la medida |
| validez | Numérico | Código que indica el estado de validez asignado a la medida (0: pendiente de validar, 1: válido, >1: no válido |
En el encabezado del fichero JSON se incluye información en formato descriptivo de la señal (estación a que corresponde, descripción de la señal y unidades de medida, así como el significado de los distintos códigos de estado de validación).
En la versión actual de las consultas no se han introducido restricciones, ni a nivel de identificación de usuario,
ni de control de volumen de datos consultados.
En el caso de que la monitorización del sistema detectara usos que pudieran considerarse abusivos, o que la utilización de estas consultas creciera hasta llegar a afectar el rendimiento general del sistema, en posteriores versiones se implementarían controles, de una u otra naturaleza dependiendo de las anomalías detectadas (asignación de key a usuarios, limitación en volumen de datos, en número de consultas, control de direcciones IP, ...)
En el caso de que la monitorización del sistema detectara usos que pudieran considerarse abusivos, o que la utilización de estas consultas creciera hasta llegar a afectar el rendimiento general del sistema, en posteriores versiones se implementarían controles, de una u otra naturaleza dependiendo de las anomalías detectadas (asignación de key a usuarios, limitación en volumen de datos, en número de consultas, control de direcciones IP, ...)
Fecha de actualización: abril de 2023