imagen grupo datos abiertos

JSON-stat

El formato JSON-stat es un formato ligero para la publicación de datos en forma tabular. En este modelo de cubo los conjuntos de datos están organizados en dimensiones y las dimensiones están organizadas en categorías. A continuación se describe la construcción y la salida de las peticiones URL:

https://servicios.ine.es/wstempus/jsstat/{idioma}/{función}/{input}[?parámetros]

Los campos que aparecen entre llaves, { }, son obligatorios.

Los campos que aparecen entre corchetes, [ ], son opcionales y cambian en relación a la función considerada.

Descripción de cada uno de ellos. 

{idioma}

https://servicios.ine.es/wstempus/jsstat/{idioma}/{función}/{input}[?parámetros]

Puede tomar los siguientes valores:

  • - ES: español
  • - EN: inglés
{función}

https://servicios.ine.es/wstempus/jsstat/{idioma}/{función}/{input}[?parámetros]

Al ser JSON-stat un formato para difundir cubos o tablas estadísticas, la función implementada es la siguiente:

  • - Datos: DATASET  (Muestra los datos y metadatos de una tabla)
{inputs}

https://servicios.ine.es/wstempus/jsstat/{idioma}/{función}/{input}[?parámetros]

El input será el identificador de la tabla estadística. Veamos cómo obtenerlo:

Navegando a través de IneBase, se accede a la tabla en la que se está interesado.

Por ejemplo, la tabla "Población por sexo y grupo de edad. Valores absolutos y porcentajes respecto del total de cada sexo"  de la encuesta de polación activa.

Tabla fuente PcAxis

De la URL resultante de la navegación, en el ejemplo:

https://www.ine.es/jaxiT3/Tabla.htm?t=4028&L=0 obtenemos el parámetro t , que identifica a la tabla de manera única t=4028.

 

[?parámetros]

https://servicios.ine.es/wstempus/jsstat/{idioma}/{función}/{input}[?parámetros]

Pasamos parámetros en la URL a partir del símbolo ?

Para pasar más de un parámetro usamos como separador el símbolo &

Parámetros disponibles :

Petición de datos JSON-STAT

Se puede obtener datos utilizando la siguiente función:

  • DATASET

Veamos algunos ejemplos:

Obtener los n últimos datos de una tabla

  • Consulta: Obtener los 4 últimos datos de la tabla "Flujo de inmigración procedente del extranjero por semestre, sexo y edad"
  • https://servicios.ine.es/wstempus/jsstat/ES/DATASET/24387?nult=4
  • {función} = DATASET
  • {inputs} = código identificativo de la tabla (t=24387).
  • {?parámetro} = Número de datos o de periodos que se quieren visualizar. En este caso, los 4 últimos datos, por tanto el parámetro nult tomará el valor 4. 
  • {output} =
    • versión: 2.0  
    • class: dataset
    • label: título de la tabla  ("Flujo de migraciones procedente del extranjero por semestre, sexo y edad")
    • note:  unidades , notas ("Unidades: Movimientos migratorios")
    • source: Operación estadística, capítulo correspondiente en Inebase ("Estadística de Migraciones / Resultados Nacionales")
    • update: fecha última actualización de los datos de la tabla
    • Id: contiene una lista ordenada de los identificadores de los grupos o combos de selección que definen la tabla ("sexo, edad, Per")
    • size: contiene el número de valores contenidos en cada uno de los grupos anteriores. Tiene la misma cantidad de elementos y el mismo orden que el campo Id ("3,92,19")
    • role: se usa para asignar roles especiales a los grupos. Los posibles roles son: time, geo y metric. ("metric: [sexo, edad], time:[Per]")
    • value: contiene los datos ordenados según los grupos de valores de la tabla
    • status: estado de cada dato. Puede ser: definitivo (D), provisional (P), estimado (E), ...
    • dimension:  contiene información sobre los grupos que definen la tabla
      • label: nombre del grupo
      • category:  nombres y codificación de los valores contenidos en el grupo

Obtener los n últimos datos de una tabla filtrando por metadata

  • Consulta: Obtener los 2 últimos datos de las series contenidas en la tabla "Parados por sector económico y comunidad autónoma" filtrando por:
    • ¿Comunidades y Ciudades Autónomas ¿ =  "13 Madrid, comunidad de" y "09 Cataluña"
    • "Sector económico¿  = ¿Servicios¿  

       Para obtener el campo metadata con los códigos de selección en una tabla será necesario realizar la siguiente consulta:

  • https://servicios.ine.es/wstempus/jsstat/ES/DATASET/3979?tv=comunidadesyciudadesautonomas:13&tv=comunidadesyciudadesautonomas:09&tv=sectoreconomico:servicios
  • {función} = DATASET
  • {input} = Código identificativo de la tabla (t=3979) y códigos de selección (los obtenemos consultando la tabla completa: https://servicios.ine.es/wstempus/jsstat/ES/DATASET/3979)
    • ¿Comunidades y Ciudades Autónomas ¿ (id=comunidadesyciudadesautonomas) = "13 Madrid, comunidad de" (codigo=13)  ¿  tv=comunidadesyciudadesautonomas:13
    • ¿Comunidades y Ciudades Autónomas¿ (id=comunidadesyciudadesautonomas)  = ¿09 Cataluña¿ (codigo=09)  ¿  tv=comunidadesyciudadesautonomas:09
    • "Sector económico¿ (id=sectoreconomico) = ¿Servicios¿ (codigo=servicios)  ¿ tv=sectoreconomico:servicios
  • {?parámetro} = Número de datos o de periodos que se quieren visualizar. En este caso, los 2 últimos datos, por tanto el parámetro nult tomará el valor 2.
  • {output} =
    • versión: 2.0  
    • class: dataset
    • label: título de la tabla ("Parados por sector económico y comunidad autónoma")
    • note:  unidades , notas  ("Unidades: Miles de Personas")
    • source: Operación estadística, capítulo correspondiente en Inebase  ("Encuesta de Población Activa/Parados")
    • update: fecha última actualización de los datos de la tabla 
    • Id: contiene una lista ordenada de los identificadores de los grupos o combos de selección que definen la tabla ("comunidadesyciudadesautonomas, sectoreconomico, Per")
    • size:contiene el número de valores contenidos en cada uno de los grupos anteriores. Tiene la misma cantidad de elementos y el mismo orden que el campo  Id ("20,6,40")
    • role: se usa para asignar roles especiales a los grupos. Los posibles roles son: timegeo metric  ("geo:[comunidadesyciudadesautonomas], metric: [sectoreconomico], time:[Per]")
    • value:  contiene los datos ordenados según los grupos de valores de la tabla
    • status: estado de cada dato. Puede ser: definitivo (D), provisional (P), estimado (E), ...
    • dimension:  contiene información sobre los grupos que definen la tabla
      • label: nombre del grupo
      • category:  nombres y codificación de los valores contenidos en el grupo

Información importante sobre cookies

Este sitio web utiliza cookies propias y de terceros para recopilar información que ayuda a optimizar su visita. Las cookies no se utilizan para recoger información de carácter personal. Si continúa navegando se considera que acepta su uso.