Para mejorar el acceso a los datos y fomentar la innovación, el Instituto Galego de Estatística expone su información a través de tres interfaces de Programación de Aplicaciones (APIs).
De esta manera los datos están accesibles a los desarrolladores de software a través de una petición HTTP GET. A partir de estas los desarrolladores pueden obtener información del Instituto e integrarla en sus propios servicios.
La utilización de cualquiera de las APIs conlleva la aceptación de las condiciones de uso del servicio que se explican al final de esta página.
En las APIs, el IGE ofrece en su web la posibilidad de configurar la información que cada usuario precise. En esa misma aplicación web se le muestra cuál es la URL desde la cual se puede tener acceso a esa selección y que su aplicación puede utilizar directamente.
Toda la información que especifica la petición está contenida en la url, por lo que basta con copiarla. También se puede contruír urls similares para obtener otras extracciones de datos cambiando algún parámetro.
Para el caso de la dimensión temporal, ya está habilitada la posibilidad de pedir, no una serie de períodos concreta, sino también los últimos que existan en las bases de datos del IGE.
- Acceso a la interfaz
- Método HTTP: GET
- Modelo de URL: https://www.ige.gal/igebdt/igeapi/datos/{código de la tabla}/[parámetros de selección]
- Formato de respuesta: CSV, JSON, JSON-stat
- Acceso a la interfaz
- Método HTTP: GET
- Modelo de URL: https://www.ige.gal/igebdt/igeapi/datosindi/{código del indicador}
- Formato de respuesta: CSV, JSON
- Acceso a la interfaz
- Método HTTP: GET
- Modelo de URL: https://www.ige.gal/igebdt/igeapi/datosindi/{código de la serie}
- Formato de respuesta: CSV, JSON
Se ofrece esta posibilidad por ser el CSV un formato muy simple, abierto, bien conocido y soportado por todos los programas de hojas de cálculo y adecuado para la información de carácter tabular.
La estructura del fichero es la siguiente:
- La primera línea contiene los nombres de las variables y las líneas siguientes contienen los clasificadores
- Está separado por comas
- Las variables tipo alfanuméricas van entre comillas
- Las dos últimas columnas contienen los datos en formato numérico y alfanumérico, respectivamente
- El campo DatoN se corresponde con los datos en formato numérico. Cuando el dato no se encuentra disponible este campo aparecerá en blanco y el campo DatoT contendrá la explicación por la quel ese dato está en blanco: secreto estadístico, no procede, .... El campo DatoT también puede aportar información sobre el dato numérico contenido en el campo DatoN
- El campo DatoT se corresponden con los datos en formato texto. En este campo puede aparecer la siguiente simbología:
- * : secreto estadístico
- .. : sin datos o no consta
- - : no procede incluir datos
Se presenta un ejemplo a continuación:
- URL de descarga: https://www.ige.gal/igebdt/igeapi/csv/datos/1552/1:0,9912:12,T[all:a]
- Respuesta:
"CodTempo","Tempo","Poboación e densidade","CodEspazo","Espazo","DatoN","DatoT"
1900,"1900","Poboación","12","12 Galicia",2073638,"2.073.638"
1910,"1910","Poboación","12","12 Galicia",2231753,"2.231.753"
1920,"1920","Poboación","12","12 Galicia",2342545,"2.342.545"
1930,"1930","Poboación","12","12 Galicia",2466599,"2.466.599"
1940,"1940","Poboación","12","12 Galicia",2638557,"2.638.557"
1950,"1950","Poboación","12","12 Galicia",2701803,"2.701.803"
1960,"1960","Poboación","12","12 Galicia",2730996,"2.730.996"
1970,"1970","Poboación","12","12 Galicia",2676403,"2.676.403"
1981,"1981","Poboación","12","12 Galicia",2811912,"2.811.912"
1991,"1991","Poboación","12","12 Galicia",2731669,"2.731.669"
2001,"2001","Poboación","12","12 Galicia",2695880,"2.695.880"
2011,"2011","Poboación","12","12 Galicia",2772928,"2.772.928"
JSON es un formato ligero para el intercambio de datos. Es simple y ampliamente empleado y apoyado, los principales lenguajes de programación pueden manejar JSON.
La estructura del fichero es la siguiente:
- La primera parte contiene los nombres de las variables y la segunda parte contiene los clasificadores
- El campo DatoN se corresponde con los datos en formato numérico. Cuando el dato no se encuentra disponible este campo aparecerá en blanco y el campo DatoT contendrá la explicación por la quel ese dato está en blanco: secredo estadístico, no procede, .... El campo DatoT también puede aportar información sobre el dato numérico contenido en el campo DatoN.
- El campo DatoT se corresponde con los datos en formato texto. En este campo puede aparecer la siguiente simbología:
- * : secreto estadístico
- .. : sin datos o no consta
- - : no procede incluir datos
Se presenta un ejemplo a continuación:
- URL de descarga: https://www.ige.gal/igebdt/igeapi/json/datos/1552/1:0,9912:12,0:1981:1991:2001:2011
- Respuesta:
{"variables" : ["CodTempo","Tempo","Poboación e densidade","CodEspazo","Espazo","DatoN","DatoT"]
, "datos" : [[1981,"1981","Poboación","12","12 Galicia","2811912","2.811.912"]
,[1991,"1991","Poboación","12","12 Galicia","2731669","2.731.669"]
,[2001,"2001","Poboación","12","12 Galicia","2695880","2.695.880"]
,[2011,"2011","Poboación","12","12 Galicia","2772928","2.772.928"]
]} - Ejemplo de tratamiento del formato JSON con Javascript:
JSON-stat es un formato de difusión JSON sencillo y ligero, el más adecuado para la visualización de datos, aplicaciones móviles o iniciativas de datos abiertos, que ha sido diseñado para todo tipo de difusores. Más información en JSON-stat.org
- El IGE ofrece sus datos en un formato legible por máquinas a través de APIs. Este servicio se ofrece sujeto a estas condiciones de uso y a las condiciones contenidas en el Aviso legal de esta página.
- Los servicios que empleen las APIs del IGE tienen que mostrar el siguiente aviso dentro de la aplicación: "Este producto emplea la API de datos del Instituto Galego de Estatística (IGE), pero no está certificado o aprobado por el IGE".
- Al presentar los datos proporcionados por las APIs no está autorizado a modificar o editar datos, metadatos o los enlaces proporcionados.
- El uso de las APIs proporcionadas por el IGE no supone ningún tipo de apoyo, relación o afiliación entre el sitio web que las emplea y el IGE.
- El IGE se reserva el derecho a limitar las peticiones repetidas desde un mismo origen para garantizar el acceso al servicio de todo el mundo. Si desea hacer este tipo de peticiones póngase en contacto con el IGE.
- La cesión, empleo y explotación de las APIs deberá cumplir las estipulaciones contenidas en la legislación vigente y siempre se vinculará a usos legítimos.
- En caso de vulnerar estas condiciones, el IGE se reserva el derecho a bloquear su acceso a las APIs. Usted será responsable de los daños que pueda suponer la explotación indebida de esta información.
- El IGE se reserva el derecho a modificar estas condiciones en cualquier momento, así como, de terminar esta relación y cancelar su uso.