eGov España - API de acceso a datos púbicos
¿Te entra la risa floja cuando oyes hablar de transformación digital? ¿Ya no crees en promesas de datos abiertos? ¿Crees que está feo dilapidar dinero público en "portalitos"? Estás en el sitio adecuado.
El plan es construir APIs decentes que consulten fuentes de datos públicas (por ejemplo, páginas web) para poder utilizar los servicios de la administración de forma programática.
Prueba a consultar algunos ejemplos en una demo real:
- Ubicación geográfica del código postal "09400".
- Antenas de telefonía de Aranda de Duero.
- Señales de Televisión de Villadiego.
- Cobertura 4G a 800MHz en Aranda de Duero.
- Listado de radares de tráfico.
Faltan muchos servicios por incluir y no voy a poder hacerlo solo. ¡Colabora!
Organización del proyecto
El proyecto se divide en varios paquetes:
- packages/egov-api-server: Servidor que expone un API GraphQL para acceder a los datos públicos.
- packages/egov-data-providers: Contiene los servicios de consulta que extraen datos de fuentes públicas. El
egov-api-serverutiliza este paquete. - packages/egov-examples: Ejemplos de uso programático de los servicios de consulta.
egov-api-server
Servidor HTTP que expone un API GraphQL para acceder a datos públicos reales (probar demo). Está desarrollado en Node.js (TypeScript) con Apollo GraphQL y es la forma más sencilla de acceder a los datos.
Puedes consultar el esquema de datos. He empezado con datos de localizaciones geográficas y de servicios de telecomunicaciones disponibles en la zona (antenas, canales de televisión digital, redes disponibles).
Instalación local
Sólo necesitas Node.js 10+. Debes inicializar el proyecto después de clonarlo por primera vez:
git clone [email protected]:palmerabollo/egov.git
cd egov
npm install
Y ejecutarlo:
npm run start:api-server
En http://localhost:4000 tendrás la interfaz web de acceso al API GraphQL para ejecutar tus consultas. Si te apetece cacharrear, hay más detalles sobre el proceso de desarrollo en la guía para colaboradores.
Nota: algunas administraciones tienen servidores inseguros, afectados por vulnerabilidades (CVE-2009-3555) desde hace más de una década. Esto impide el soporte de Node.js >16 / OpenSSL 3.x. Hay que investigar si se puede ignorar con la variable
SSL_OP_LEGACY_SERVER_CONNECT.
egov-data-providers
Incluye la implementación de los proveedores de datos: servicios de consulta que extraen datos de fuentes públicas. Algunos servicios consultan datos cuando se solicitan (online) y otros utilizan datos locales (offline).
Crear un nuevo servicio es muy sencillo. Actualmente están desarrollados los siguientes. Echa un vistazo y propón nuevas ideas en las issues o envía tu pull request con nuevos servicios. Es muy fácil.
| Servicio | Clase | Origen de los datos | Online |
|---|---|---|---|
| Búsqueda de poblaciones y códigos postales Categoría: General |
PostalCodeService |
geonames.org | (local file) |
| Localización de antenas de telefonía móvil Categoría: Telco |
AntennaService |
geoportal.minetur.gob.es | (api) |
| Comprobación de cobertura 4G a 800MHz Categoría: Telco |
NetworkService |
www.llega800.es | (api) |
| Señales de televisión por ubicación geográfica Categoría: Telco |
DigitalTelevisionService |
www.televisiondigital.gob.es | (html) |
| Radares de tráfico Categoría: Tráfico |
TrafficRadarService |
www.dgt.es | (html, pdf) |
| Información de vehículos Categoría: Tráfico |
TrafficVehicleService |
www.dgt.es | (html, pdf) |
egov-examples
Ejemplos de uso programático de los servicios de consulta disponibles en egov-data-providers.
import * as egov from '@egov/data-providers';
let service = new egov.AntennaService();
let antennas = await service.findAntennas(41.73, -5.32);
console.table(antennas, ['code', 'latitude', 'longitude']);
// output
// ┌─────────┬───────────────────────────────────┬───────────┬───────────┐
// │ (index) │ code │ latitude │ longitude │
// ├─────────┼───────────────────────────────────┼───────────┼───────────┤
// │ 0 │ 'VODAFONE ESPAÑA, S.A. - 144588' │ 41.471472 │ -4.989911 │
// │ 1 │ 'VODAFONE ESPAÑA, S.A. - 144589' │ 41.479806 │ -5.048222 │
// │ 2 │ 'ORANGE ESPAGNE, SAU - CYLR2147A' │ 41.471472 │ -4.989911 │
// │ 3 │ 'ORANGE ESPAGNE, SAU - CYLR2223B' │ 41.479806 │ -5.048222 │
// └─────────┴───────────────────────────────────┴───────────┴───────────┘Incubator
Adaptadores. Soporte de múltiples lenguajes de programación
El código de eGov está desarrollado en Node.js (TypeScript). Quienes quieran contribuir con nuevos proveedores de datos en otros lenguaje de programación, tienen la posibilidad de que se ejecuten como procesos independientes que expongan un interfaz HTTP. Estos procesos adaptadores pueden obtener los datos, procesarlos y ofrecerlos a eGov a través de ese interfaz HTTP.
Hay una prueba de concepto para obtener los radares de tráfico con un proceso Python que hace scraping de los datos de radares de la DGT. Este proceso se está ejecutando como una función serverless en AWS Lambda.
data-provider --(http)--> adapter --(http scrape)--> datasource
¿Por qué serverless? Porque es la manera de hacer el proyecto económicamente sostenible, sin tener que pedir dinero por ahora.
LICENSE
Copyright 2019 - Guido García (guido.garcia AT protonmail DOT com)
Licensed under the GNU Affero General Public License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
Third parties
Some information about postal codes is provided by geonames under a Creative Commons Attribution 4.0 License.