Saltar al contenido principal

El municipio en cifras. API RSS

Esta API da acceso a información estadística básica comparativa de municipios, comarcas y Cataluña. El Idescat difunde esta misma información en la sección El municipio en cifras.

La utilización de este servicio comporta la aceptación de las condiciones de uso de las API del Idescat.

Resumen
URI base https://api.idescat.cat/emex/v1/{operación}.{formato}[?parámetros]
Método HTTP GET
Formatos de la respuesta xml, json, php
Versión 1.00 (02/12/2010)
Atajos Petición, Respuesta
Operaciones dades, nodes

1. Petición

1.1. Características básicas

Toda petición debe especificar obligatoriamente el servicio, la versión, la operación y el formato. Versión y operación son características específicas de cada servicio. Este servicio soporta los formatos de respuesta generales de las API del Idescat. Para más información, consulte el apartado Anatomía de las peticiones en la documentación general de las API del Idescat.

1.1.1. Identificador del servicio y versión

El identificador de este servicio es emex.

https://api.idescat.cat/emex/v1/{…}?lang=es

1.1.2. Operaciones

Este servicio admite dos tipos de operaciones:

  • dades: Devuelve estadísticas básicas del ámbito territorial seleccionado (municipio o comarca) y la misma información para los ámbitos superiores previstos (comarca y Cataluña). 
    https://api.idescat.cat/emex/v1/dades.{…}?lang=es
  • nodes: Devuelve los ámbitos territoriales previstos en el servicio. 
    https://api.idescat.cat/emex/v1/nodes.{…}?lang=es

1.2. Parámetros específicos

Este servicio soporta los parámetros generales (idioma y codificación) de las API del Idescat. Además de los idiomas aceptados con carácter general, este servicio admite el occitano (lang=oc).

Los parámetros específicos permiten escoger la información que devolverá una determinada operación del servicio. Se pueden especificar como parámetros individuales o en un único parámetro p (forma compacta).

1.2.1. Operación dades

La operación dades devuelve estadísticas básicas del ámbito territorial seleccionado (municipio o comarca) y la misma información para los ámbitos superiores previstos (comarca y Cataluña).

1.2.1.1. Filtro id

Este parámetro sirve para especificar el ámbito territorial (municipio o comarca) según su código oficial.

Ej. 1: Información estadística básica de Abella de la Conca (250019), el Pallars Jussà y Cataluña
https://api.idescat.cat/emex/v1/dades.xml?id=250019&lang=es

Para obtener la relación de municipios y comarcas de Cataluña y sus códigos oficiales, utilice la operación nodes.

1.2.1.2. Filtro i

Si no se necesita toda la información de un ámbito territorial, se puede utilizar el parámetro i para especificar, separados por comas, los indicadores que se tienen que incluir en la respuesta.

Ej. 2: Datos de población total, masculina y femenina de Abrera, el Baix Llobregat y Cataluña
https://api.idescat.cat/emex/v1/dades.xml?id=080018&i=f171,f36,f42&lang=es

Los identificadores de los indicadores aparecen en el atributo id de los elementos f de la respuesta completa (es decir, sin especificación del parámetro i) de la operación dades.

También se pueden solicitar los datos de un número limitado de indicadores (5) para todos los ámbitos territoriales.

Ej. 3: Datos de población total, masculina y femenina de todos los municipios, comarcas y Cataluña
https://api.idescat.cat/emex/v1/dades.xml?i=f171,f36,f42&lang=es

Hay que tener en cuenta que algunos indicadores pueden disponer de diversas fuentes. Debido a que esta API utiliza siempre la fuente común a los ámbitos incluidos en la respuesta, la fuente de un determinado indicador para un determinado municipio puede no ser la misma en peticiones en que los ámbitos territoriales seleccionados son diferentes.

La operación dades debe incluir obligatoriamente el parámetro id o bien el parámetro i. Si no se incluye ninguno de los dos, no se retornarán datos de ningún indicador.

1.2.1.3. Filtro tipus

El parámetro tipus puede utilitzarse en peticiones sin parámetro id para limitar los ámbitos incluidos en la respuesta de acuerdo con la tipología siguiente:

  • cat: Cataluña
  • com: Comarcas
  • mun: Municipios

Estos valores se pueden concatenar separados por comas. Por defecto, tipus es igual a cat,com,mun.

1.2.2. Operación nodes

La operación nodes devuelve los ámbitos territoriales previstos en el servicio y permite conocer los valores válidos del parámetro id de la operación dades.

Ej. 4: Lista jerárquica de ámbitos territoriales (Cataluña, comarcas, municipios) y sus códigos en formato JSON
https://api.idescat.cat/emex/v1/nodes.json?lang=es
1.2.2.1. Filtro tipus

El parámetro tipus en la operación nodes tiene el mismo significado y acepta los mismos valores que en la operación dades.

Ej. 5: Lista de comarcas de Cataluña y sus códigos en formato JSON
https://api.idescat.cat/emex/v1/nodes.json?tipus=com&lang=es

1.3. Invocación sin operación

Por razones de amigabilidad, esta API admite peticiones con una sintaxis que no requiere especificar operaciones (véase, en la documentación general de las API del Idescat, el apartado 1.4. Invocación sin operación).

  • Lista de los ámbitos territoriales disponibles en formato XML 
    https://api.idescat.cat/emex/v1/geo.xml?lang=es
  • Lista de las comarcas de Cataluña en formato XML 
    https://api.idescat.cat/emex/v1/geo.xml?tipus=com&lang=es
  • Información del indicador f171 (población) de Cataluña y sus comarcas en formato JSON 
    https://api.idescat.cat/emex/v1/geo.json?i=f171&tipus=cat,com&lang=es
  • Información completa del ámbito territorial 01 (Alt Camp) en formato XML 
    https://api.idescat.cat/emex/v1/geo/01.xml?lang=es
  • Información completa del ámbito territorial 170010 (Agullana) en formato JSON 
    https://api.idescat.cat/emex/v1/geo/170010.json?lang=es
  • Información de los indicadores f328 (longitud) y f329 (latitud) del ámbito territorial 170010 (Agullana) en formato PHP serializado 
    https://api.idescat.cat/emex/v1/geo/170010.php?i=f328,f329&lang=es

2. Respuesta

Para conocer los códigos de respuesta HTTP devueltos y los formatos soportados por cualquier servicio, consulte el apartado 2 de las API del Idescat.

2.1. El elemento raíz (fitxes)

El elemento raíz (fitxes) aparece en todas las respuestas, cualquiera que sea la operación. Incluye los siguientes atributos:

  • version: versión del servicio.
  • lang: idioma general del documento. Este servicio admite el valor oc, además de ca (valor por defecto), es y en.
  • o: operación solicitada.
  • p: valores asignados a los parámetros específicos, si procede.
Ej. 6: Atributos del elemento raíz en una operación dades
<fitxes
   version="1.00"
   lang="es"
   o="dades"
   p="id=080155"
>

2.2. Operación dades

La estructura de la respuesta de la operación dades depende de si se ha especificado una lista de indicadores (i) o no. En ambos casos, la respuesta contiene el elemento cols.

2.2.1. Columnas (cols)

El elemento cols contiene información de los ámbitos territoriales para los cuales se incluye información estadística. Para cada ámbito, este elemento contiene un elemento col con un código (valor del atributo id) y una denominación (contenido del elemento). El nivel territorial se especifica en el atributo scheme: municipio (mun), comarca (com) o Cataluña (ca).

Ej. 7: Elemento cols en una operación dades
<cols>
   <col id="080155" scheme="mun">Badalona</col>
   <col id="13" scheme="com">Barcelonès</col>
   <col id="09" scheme="ca">Cataluña</col>
</cols>

2.2.2. Respuesta con todos los indicadores

2.2.2.1. Grupos (g), tablas (t), filas (f), denominaciones (c) y vectores de valores (v)

Cuando se solicitan todos los indicadores disponibles para un ámbito determinado, estos se incluyen en un elemento gg (conjunto de grupos). Dentro de este elemento, la información se presenta agrupada en diferentes niveles: grupos, tablas y filas.

Cada grupo (g) dispone de un identificador (atributo id), de una denominación (c) y, o bien de un conjunto de tablas (tt) o bien de un nuevo conjunto de grupos (gg). Esta segunda posibilidad no se utiliza actualmente en la API del municipio en cifras. Cada tabla (t) dispone de un identificador (atributo id), de una denominación (c) y de un conjunto de filas (o indicadores) (ff). Y cada fila (f) dispone de un identificador (atributo id), de una denominación (c) y de un vector de valores (v).

El vector de valores (v) contiene tantas cifras separadas por comas como columnas (col). Los decimales se indican con punto y los valores que faltan con "_".

Ej. 8: Un grupo g y sus niveles inferiores
<g id="g158">
    <c>Movimiento de la población</c>
    <tt>
        <t id="t164">
            <c>Nacimientos. Por sexo</c>
            <ff>
                <f id="f185">
                    <c>Niños</c>
                    <v>1386,12043,45984</v>
                    ...
                </f>
                <f id="f186">
                    <c>Niñas</c>
                    <v>1348,11160,43040</v>
                    ...
                </f>
                <f id="f187">
                    <c>Total</c>
                    <v>2734,23203,89024</v>
                    ...
                </f>
            </ff>
            ...
        </t>
        ...
    </tt>
</g>
2.2.2.2. Denominación alternativa (calt)

Los nombres (c) de tablas (t) y filas (f) pueden tener una denominación alternativa (calt). En el caso de las tablas, calt ofrece una denominación, en general más breve que c, apropiada para una lista de contenidos del grupo. Con respecto a las filas, como c ya ofrece una denominación que solo es comprensible en el contexto de una tabla, calt proporciona una denominación breve útil para presentar las filas por separado (como indicadores), en lugar de agrupadas en una tabla.

Ej. 9: El elemento calt de tablas (t) y filas (f)
<t id="t164">
    <c>Nacimientos. Por sexo</c>
    <calt>Nacimientos</calt>
    <ff>
        <f id="f185">
            <c>Niños</c>
            <calt>Nacimientos de niños</calt>
            <v>1386,12043,45984</v>
        </f>
        <f id="f186">
            <c>Niñas</c>
            <calt>Nacimientos de niñas</calt>
            <v>1348,11160,43040</v>
        </f>
        <f id="f187">
            <c>Total</c>
            <calt>Nacimientos</calt>
            <v>2734,23203,89024</v>
        </f>
    </ff>
    ...
</t>
2.2.2.3. Unidades (u), referencia temporal (r) y fecha de actualización (updated)

El vector de valores (v) de cada fila (f) de la tabla (t) está expresado en unidades (u), se refiere a un periodo temporal (r) y tiene una fecha de actualización (updated).

Habitualmente, las filas de una tabla comparten el contenido de todos o de algunos de estos elementos. En estos casos, la API devuelve el elemento como hijo de la tabla (t) en lugar de aparecer repetido en cada fila (f).

El contenido de u proporciona un literal expresivo de las unidades de medida que complementa la denominación de la tabla o la fila. Cuando esta unidad resulta obvia en la misma denominación (p. e. "Nacimientos"), el elemento u no aparece.

Ej. 10: Fila (f) con unidades (u)
<f id="f3">
    <c>PIB pm por habitante</c>
    <calt>PIB por habitante</calt>
    <v>18.1,30.7,27.3</v>
    <u>Miles de euros</u>
</f>

Todos los datos de este servicio tienen una referencia temporal anual que aparece expresada en cuatro dígitos como contenido del elemento r. Este elemento siempre aparece, ya sea como hijo de f o como hijo de t.

Todos los datos de este servicio tienen una fecha de actualización que aparece como contenido del elemento updated. Este elemento siempre aparece, ya sea como hijo de f o como hijo de t. El formato de fecha utilizado se puede ver en el ejemplo siguiente (ver el RFC3339 para su interpretación).

Ej. 11: Elementos r y upated comunes en todas las filas f de una tabla t
<g id="g158">
    <c>Movimiento de la población</c>
    <tt>
        <t id="t164">
            <c>Nacimientos. Por sexo</c>
            <calt>Nacimientos</calt>
            <ff>
                <f id="f185">
                    ...
                </f>
                <f id="f186">
                    ...
                </f>
                <f id="f187">
                    ...
                </f>
            </ff>
            <r>2008</r>
            <updated>2010-06-11T10:00:00+00:00</updated>
            ...
        </t>
        ...
    </tt>
    ...
</g>
2.2.2.4. Fuente (s) y enlace (l)

Todas las tablas tienen asociado un texto descriptivo de la fuente de la información (s) así como un posible enlace con la tabla de donde se ha extraído (l), si existe.

Ej. 12: Elementos r y upated comunes en todas las filas f de una tabla t
<t id="t176">
    <c>Indicadores geográficos</c>
    <ff>
        <f id="f258">
            <c>Altitud</c>
            <calt>Altitud</calt>
            <v>105,_,_</v>
            <u>m</u>
            <updated>2010-06-11T10:00:00+00:00</updated>
        </f>
        <f id="f259">
            <c>Coordenadas UTM x</c>
            <calt>Coordenadas UTM x</calt>
            <v>408471,_,_</v>
            <u>m</u>
            <updated>2010-06-11T10:00:00+00:00</updated>
        </f>
        <f id="f260">
            <c>Coordenadas UTM y</c>
            <calt>Coordenadas UTM y</calt>
            <v>4596983,_,_</v>
            <u>m</u>
            <updated>2010-06-11T10:00:00+00:00</updated>
        </f>
    </ff>
    <r>2009</r>
    <s>Idescat, a partir de los datos del Institut Cartogràfic de Catalunya.</s>
    <l>
           https://www.idescat.cat/pub/?id=inddt&amp;n=396&amp;geo=muni080018&amp;lang=es
    </l>
</t>

2.2.3. Respuesta con una selección de indicadores

La API permite seleccionar los indicadores que deben incluirse en la respuesta con el parámetro i. En este caso, en lugar del elemento gg, aparece el elemento indicadors.

Este elemento incluye la información de los indicadores seleccionados siguiendo una estructura basada en la API de Indicadores al día donde el elemento dc:date ha sido sustituido por updated y v es un vector en lugar de un valor único. Como denominación del indicador (c) aparece lo que, en las peticiones donde no se ha especificado i, es el contenido de calt de la fila (f). Finalmente, t incluye el identificador y la denominación de la tabla a la que pertenece el indicador.

Ej. 13: Salida de la operación dades de una petición de dos indicadores, uno incorrecto ("156") y el otro correcto ("f2"), para Abrera
<?xml version="1.0" encoding="utf-8"?>
<fitxes version="1.00" lang="es" o="dades" n="1" p="id=080018;i=156,f2">
    <cols>
        <col id="080018" scheme="mun">Abrera</col>
        <col id="11" scheme="com">Baix Llobregat</col>
        <col id="09" scheme="ca">Cataluña</col>
    </cols>
    <indicadors>
        <i id="156" error="404">
            <c>Indicador no encontrado</c>
        </i>
        <i id="f2">
            <c>PIB pm</c>
            <v>608.5,21576.4,195857.8</v>
            <u>Millones de euros</u>
            <r>2006</r>
            <s>Idescat.</s>
            <t id="t1">Producto interior bruto a precios de mercado (base 2000)</t>
            <l>
                 https://www.idescat.cat/pub/?id=pibc&amp;n=8276&amp;geo=muni080018&amp;lang=es
            </l>
            <updated>2010-06-11T10:00:00+00:00</updated>
        </i>
    </indicadors>
</fitxes>
Ej. 14: Salida de la operación dades de un indicador ("f187"), por comarcas
<?xml version="1.0" encoding="utf-8"?>
<fitxes version="1.00" lang="es" o="dades" n="1" p="i=f187;tipus=com">
    <cols>
        <col id="01" scheme="com">Alt Camp</col>
        <col id="02" scheme="com">Alt Empordà</col>
        <col id="03" scheme="com">Alt Penedès</col>
        <col id="04" scheme="com">Alt Urgell</col>
        <col id="05" scheme="com">Alta Ribagorça</col>
        <col id="06" scheme="com">Anoia</col>
        <col id="07" scheme="com">Bages</col>
        <col id="08" scheme="com">Baix Camp</col>
        <col id="09" scheme="com">Baix Ebre</col>
        <col id="10" scheme="com">Baix Empordà</col>
        <col id="11" scheme="com">Baix Llobregat</col>
        <col id="12" scheme="com">Baix Penedès</col>
        <col id="13" scheme="com">Barcelonès</col>
        <col id="14" scheme="com">Berguedà</col>
        <col id="15" scheme="com">Cerdanya</col>
        <col id="16" scheme="com">Conca de Barberà</col>
        <col id="17" scheme="com">Garraf</col>
        <col id="18" scheme="com">Garrigues</col>
        <col id="19" scheme="com">Garrotxa</col>
        <col id="20" scheme="com">Gironès</col>
        <col id="21" scheme="com">Maresme</col>
        <col id="22" scheme="com">Montsià</col>
        <col id="23" scheme="com">Noguera</col>
        <col id="24" scheme="com">Osona</col>
        <col id="25" scheme="com">Pallars Jussà</col>
        <col id="26" scheme="com">Pallars Sobirà</col>
        <col id="27" scheme="com">Pla d'Urgell</col>
        <col id="28" scheme="com">Pla de l'Estany</col>
        <col id="29" scheme="com">Priorat</col>
        <col id="30" scheme="com">Ribera d'Ebre</col>
        <col id="31" scheme="com">Ripollès</col>
        <col id="32" scheme="com">Segarra</col>
        <col id="33" scheme="com">Segrià</col>
        <col id="34" scheme="com">Selva</col>
        <col id="35" scheme="com">Solsonès</col>
        <col id="36" scheme="com">Tarragonès</col>
        <col id="37" scheme="com">Terra Alta</col>
        <col id="38" scheme="com">Urgell</col>
        <col id="39" scheme="com">Val d'Aran</col>
        <col id="40" scheme="com">Vallès Occidental</col>
        <col id="41" scheme="com">Vallès Oriental</col>
    </cols>
    <indicadors>
        <i id="f187">
            <c>Nacimientos</c>
            <v>
                   518, 1592, 1391, 175, 38, 1496, 2165, 2314, 853, 1520, 9480, 1198, 22075, 340,
                   176, 197, 1515, 181, 576, 2575, 4945, 708, 419, 1922, 111, 66, 454, 437, 79, 194,
                   227, 266, 2418, 1810, 158, 3145, 87, 412, 102, 10859, 4821
            </v>
            <r>2010</r>
            <s>Idescat. Movimiento natural de la población.</s>
            <t id="t164">Nacimientos. Por sexo</t>
            <updated>2011-10-13T10:00:00+00:00</updated>
        </i>
    </indicadors>
</fitxes>

2.3. Operación nodes

Los municipios se agrupan en comarcas y estas se agrupan bajo el ámbito territorial de Cataluña. Esta jerarquía se expresa en un conjunto de elementos v imbricados. Cada uno de estos elementos dispone de un atributo id con el código del ámbito territorial y de un atributo scheme con especificación del nivel territorial: municipio ("mun"), comarca ("com") o Cataluña ("ca").

<?xml version="1.0" encoding="utf-8"?>
<fitxes version="1.00" lang="es" o="nodes" p="tipus=cat,com,mun">
    <v id="09" scheme="ca">Catalunya
        <v id="01" scheme="com">Alt Camp
            <v id="430017" scheme="mun">Aiguamúrcia</v>
            <v id="430056" scheme="mun">Alcover</v>
            <v id="430108" scheme="mun">Alió</v>
            <v id="430347" scheme="mun">Bràfim</v>
            <v id="430363" scheme="mun">Cabra del Camp</v>
            <v id="430593" scheme="mun">Figuerola del Camp</v>
            <v id="430666" scheme="mun">Garidells, els</v>
            <v id="430803" scheme="mun">Masó, la</v>
            <v id="430831" scheme="mun">Milà, el</v>
            <v id="430897" scheme="mun">Montferri</v>
            <v id="430918" scheme="mun">Mont-ral</v>
            <v id="430982" scheme="mun">Nulles</v>
            <v id="431080" scheme="mun">Pla de Santa Maria, el</v>
            <v id="431135" scheme="mun">Pont d'Armentera, el</v>
            <v id="431191" scheme="mun">Puigpelat</v>
            <v id="431205" scheme="mun">Querol</v>
            <v id="431248" scheme="mun">Riba, la</v>
            <v id="431325" scheme="mun">Rodonyà</v>
            <v id="431346" scheme="mun">Rourell, el</v>
            <v id="431606" scheme="mun">Vallmoll</v>
            <v id="431613" scheme="mun">Valls</v>
            <v id="431652" scheme="mun">Vilabella</v>
            <v id="431704" scheme="mun">Vila-rodona</v>
        </v>
        <v id="02" scheme="com">Alt Empordà
            <v id="170010" scheme="mun">Agullana</v>
            <v id="170031" scheme="mun">Albanyà</v>
            <v id="170059" scheme="mun">Far d'Empordà, el</v>
            ...
        </v>
        ...
    </v>
</fitxes>

2.4. Errores

Las API del Idescat utilizan códigos de respuesta normalizados para indicar que la petición ha tenido éxito o ha fracasado.