Descarga de información. APIs

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 dos Interfaz 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 dos 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.

APIs disponibles:
  • Descarga de tablas
    • Acceso a la interfaz
    • Método HTTP: GET
    • Modelo de URL: http://www.ige.eu/igebdt/igeapi/datos/{código de la tabla}/[parámetros de selección]
    • Formato de respuesta: csv, json
  • Descarga de Indicadores
    • Acceso a la interfaz
    • Método HTTP: GET
    • Modelo de URL: http://www.ige.eu/igebdt/igeapi/datosindi/{codigo indicador}
    • Formato de respuesta: csv, json

Formatos de respuesta

Csv

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: http://www.ige.eu/igebdt/igeapi/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

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: http://www.ige.eu/igebdt/igeapi/json/datos
  • 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: