Serveis per a desenvolupadors

En aquest apartat posem a la disposició dels usuaris els serveis per a desenvolupadors següents:

  1. APIs per a l'accés a dades
  2. APIs per a l'accés als recursos estructurals (actius semàntics)
  3. Connector a Tableau

L'ús d'aquests serveis és obert i gratuït, però estan subjectes a certes condicions d'ús que es poden consultar en el nostre avís legal.

1.APIs per a l'accés a dades

L'IBESTAT ha desenvolupat diferents interfícies de programació d'aplicacions (APIs) a fi de facilitar l'accés i reutilització de dades dinàmiques per part de tercers.

Si bé totes les dades publicades per l'IBESTAT són accessibles mitjançant APIs, les característiques de les mateixes dependran del sistema de difusió en el qual estiguin emmagatzemats les dades. Actualment l'IBESTAT disposa de dos sistemes de difusió diferents:

  • Repositori de fitxers Pc-Axis: és actualment el principal repositori de dades de l'IBESTAT i està sent substituït gradualment per eDades.
  • eDades: és la nova infraestructura a la qual s'està migrant la informació primària de l'IBESTAT

Pot consultar aquí més informació sobre els dos sistemes de difusió actualment existents i com determinar en quin estan emmagatzemats unes dades determinades.

1.1 APIs per a accés a dades emmagatzemades en el Repositori de fitxers Pc-Axis

En aquest cas les APIs disponibles són meres urls úniques i fixes per a cada taula estadística. Aquestes urls no són parametrizables pel que només és possible descarregar la taula estadística completa (amb tots els períodes i valors d'encreuament que conté), sent tan sols és possible especificar el format de descàrrega.

Els possibles formats de descàrrega són: JSON, JSON-stat, CSV i Pc-AxisPc-Axis. És important recalcar que a vegades el format JSON no estarà disponible a causa de la grandària d'aquest. Per això motiu recomanem que el format de descàrrega emprat sigui JSON-stat.

En la següent guia pot consultar com obtenir les urls fixes associades a cada taula estadística.

1.2 APIs per a accés a dades emmagatzemades en eDades

Si una operació estadística ja ha estat migrada a eDades, tots els recursos d'informació estadística estaran emmagatzemats en el banc de dades de cubs estadístiques que denominem e-Cubs.

Els recursos d'informació estadística existents són els següents:

  • Publicacions: una publicació la conformen el conjunt de taules o cubs estadístiques associades a una operació estadística. Cada operació estadística migrada a eDatos disposarà almenys d'una publicació.
  • Cubs estadístics: una galleda estadística és una taula de dades.
  • Consultes estadístiques: es tracta de consultes realitzades sobre cubs estadístiques, aplicant filtres que redueixen la quantitat d'informació mostrada.

Els mètodes de l'API de e-cubs faciliten l'accés a cubs o taules estadístiques, publicacions i també a consultes sobre cubs estadístiques. Els formats de descàrrega possible són XML, JSON, JSON-stat i CSV.

Teniu disponible una píndola formativa sobre l'ús de les APIs d'eDades a on podeu consultar de manera ràpida i visual com fer-les servir.

En la següent pàgina pot consultar la Documentació Swagger de l'API de e-Cubs.

També és possible accedir a les taules o cubs estadístics emprant la denominada API d'exportacions, en aquest cas els formats de descàrrega disponibles són: text pla, Excel, Pc-Axis i com a imatges.

En la següent pàgina pot consultar la Documentació Swagger de l'API d'exportacions.

2.APIs per a l'accés als recursos estructurals (actius semàntics)

La infraestructura eDades dóna cobertura a la gestió i manteniment de la interoperabilitat semàntica de les dades estadístiques publicades per l'IBESTAT. En concret, quan una operació està migrada a eDades tots els recursos estructurals que conté (conceptes, variables i classificacions estadístiques emprades, etc.) s'emmagatzemen en el banc de recursos estructurals denominat e-Semàntica.

És possible accedir, consultar i reutilitzar els actius semàntics disponibles de dues maneres diferents:

Els mètodes de l'API de e-Semàntica permeten l'accés als següents recursos estructurals o actius semàntics:

  • Esquema d'organitzacions i les seves organitzacions
  • Esquema de temes i temes estadístics
  • Esquema de conceptes i els seus conceptes
  • Famílies de variables, variables i els seus elements de variables
  • Famílies de classificacions, classificació i codis
  • Definicions d'estructures de dades (DSD)

En la següent pàgina pot consultar la Documentació Swagger de l'API de e-Semàntica.

3.Connector a Tableau

Tableau és una eina que permet crear de manera ràpida visualitzacions dinàmiques sobre qualsevol conjunt de dades. Amb aquesta eina podràs crear els teus propis quadres de comandament aprofitant la potència que brinda Tableau utilitzant diferents fonts de dades com xls, ods, txt,... i, en particular, els Web Data Connector (WDC).

Un WDC és una url que extreu automàticament les dades d'un determinat banc de dades i les bolca a Tableau establint una connexió interoperable entre tots dos de manera que l'anàlisi i les visualitzacions seran fàcilment actualitzables quan la informació del banc de dades s'actualitzi.

L'Institut d'Estadística de les Illes Balears (IBESTAT) ha desenvolupat el seu popi conjunt de Web Data Connectors per a Tableau per simplificar la reutilització de la informació que publica.

3.1 Quina informació puc connectar

Des dels connectors disponibles podeu accedir a la següent informació:

  • Indicadors. Permet obtenir dades de qualsevol indicador i/o instància d'indicador que publica l'IBESTAT.
  • Cubs. Permet obtenir dades de qualsevol dataset i/o consulta publicada per l'IBESTAT.
    Les taules estadístiques (anomenades també cubs o datasets) que publica l'IBESTAT al seu portal estan en un dels dos sistemes de difusió existents(consultar mes informació aquí) i l'ús del connector varia en funció del sistema:
    • Repositorio de ficheros Pc-Axis: en aquest cas només és possible emplear la url de descàrrega de la taula de dades completa en format jsonstat.
    • eDades: en aquest cas és possible emprar url parametritzables i també és possible fer una cerca per operació estadística i seleccionar la taula de dades d'interès.
  • Classificacions. Permet obtenir qualsevol classificació utilitzada per l'IBESTAT per codificar els seus datasets i consultes

3.2 Com utilitzar el connector

Els Web Data Connectors són invocats des de Tableau Desktop i permeten importar automàticament les dades per a la seva posterior anàlisi visual. Tableau Desktop té una versió gratuïta i per aprendre a fer les trucades als connectors de dades podeu consultar  guia d'ús de connectors de Tableau o aquesta guia específica per als nostres connectors.