La finalidad de este portal es ofrecer públicamente un conjunto de datos sobre el AMB para permitir su explotación mediante la utilización de la propia API.

En esta página se explica cómo utilizar la API Opendata para buscar y recuperar datos de las diferentes fuentes disponibles dentro del portal del AMB.

El portal Opendata ofrece la información agrupada por colecciones(collections). Para cada colección se podrán realizar búsquedas por sus campos o utilizar la búsqueda de texto libre. El resultado de las consultas se podrá obtener en diferentes formatos para facilitar su utilización. Para acceder a los datos de una colección deberá hacerse por medio de la URL:

donde {{collection}} será el nombre de la colección. Una vez hayamos accedido, se mostrarán todos los datos disponibles para la colección.
Actualmente se dispone de datos sobre las siguientes colecciones

• Actividades:

  http://opendata.amb.cat/activitats/search

• Noticias:

  http://opendata.amb.cat/noticies/search

• Municipios:

  http://opendata.amb.cat/municipis/search

• Publicaciones:

  http://opendata.amb.cat/publicacions/search

• Estudios:

  http://opendata.amb.cat/estudis/search

• Estudios de movilidad:

  http://opendata.amb.cat/estudis/search/?tipus_estudi=Mobilitat

• Estudios metropolitanos:

  http://opendata.amb.cat/estudis/search?rows=15&tipus_estudi=metropolitans

• Estudios de sostenibilidad:

  http://opendata.amb.cat/estudis/search?rows=15&tipus_estudi=sostenibilitat

• Proyectos y obras:

  http://opendata.amb.cat/projectes_obres/search

• Infraestructuras:

  http://opendata.amb.cat/infraestructures/search

• Tr´mites:

  http://opendata.amb.cat/tramits/search

• Proyectos de cooperación:

  http://opendata.amb.cat/cooperacio/search

• Equipamientos:

  http://opendata.amb.cat/equipaments/search

• Playas:

  http://opendata.amb.cat/equipaments_platja/search

• Parques:

  http://opendata.amb.cat/equipaments/search?subambit=Parcs

• Planes urbanísticos:

  http://opendata.amb.cat/pla_urbanistic/search

• Datasets:

  http://opendata.amb.cat/datasets/search

• Perfil del contratante - procedimientos abiertos:

  http://opendata.amb.cat/perfil_contractant_procediment_obert/search

• Perfil del contratante - procedimientos negociados:

  http://opendata.amb.cat/perfil_contractant_procediment_negociat/search

• Actividades del taxi:

  http://opendata.amb.cat/activitats_taxi/search

• Noticias del taxi:

  http://opendata.amb.cat/noticies_taxi/search

• Notes de prensa:

  http://opendata.amb.cat/notes_premsa/search

• Datos meteorológicos de las playas:

  http://opendata.amb.cat/dades_meteorologiques/search

• Datos del estado de las playas:

  http://opendata.amb.cat/dades_estat_platja/search

• Instalaciones de la playa del Prat de Llobregat

  http://opendata.amb.cat/serveis_platges/search?platja_key=platja_prat

• Instalaciones de la playa de Montgat

  http://opendata.amb.cat/serveis_platges/search?platja_key=platja_montgat

• Instalaciones de la playa de Gavà

  http://opendata.amb.cat/serveis_platges/search?platja_key=platja_gava

• Instalaciones de la playa de Castelldefels

  http://opendata.amb.cat/serveis_platges/search?platja_key=platja_castelldefels

• Instalaciones de la playa de Barcelona

  http://opendata.amb.cat/serveis_platges/search?platja_key=platja_barcelona

• Instalaciones de la playa de Badalona

  http://opendata.amb.cat/serveis_platges/search?platja_key=platja_badalona

• Instalaciones de la playa de Viladecans

  http://opendata.amb.cat/serveis_platges/search?platja_key=platja_viladecans

• Instalaciones de la playa de Sant Adrià de Besòs

  http://opendata.amb.cat/serveis_platges/search?platja_key=platja_sadria

• Servicios para empresas:

  http://opendata.amb.cat/serveis_empreses/search

• Prestador de servicios:

  http://opendata.amb.cat/prestador_serveis/search

• Workshops del PDU:

  http://opendata.amb.cat/workshops_pdu/search

• Vehículos del taxi:

  http://opendata.amb.cat/vehicles_taxi/search

• Directorio del taxi:

  http://opendata.amb.cat/directori_taxi/search

• Paradas de taxi:

  http://opendata.amb.cat/parades_taxi/search

• Puntos d'interés:

  http://opendata.amb.cat/punts_interes/search

• Servicios de los parques:

  http://opendata.amb.cat/serveis_parcs/search

• Ocupación pública:

  http://opendata.amb.cat/ocupacio_publica/search

• Proyectos abiertos:

  http://opendata.amb.cat/projectes_oberts/search

• Publicaciones taxi:

  http://opendata.amb.cat/publicacions_taxi/search

• Puntos servicios:

  http://opendata.amb.cat/punts_serveis/search

• Servicios playas:

  http://opendata.amb.cat/serveis_platges/search

• Workshops abiertos:

  http://opendata.amb.cat/workshops_oberts/search

• Workshops pasajes:

  http://opendata.amb.cat/workshops_passatges/search

• Contactos:

  http://opendata.amb.cat/contactes/search

• Menú site:

  http://opendata.amb.cat/menu_site/search

Cada colección está asociada a un esquema (schema) donde se definen los tipos de campos y la estructura que tendrán sus contenidos. La consulta del esquema de una colección se hará mediante la URL:

Si, por ejemplo, consultamos el esquema de noticias obtendremos la siguiente información:

Búsquedas específicas por campos

La API permite realizar búsquedas por los diferentes campos de una colección. Las consultas se harán de la siguiente forma:

donde los campos campo1, campo2, campo3 serán los nombres de los campos de la colección. Si, por ejemplo, queremos filtrar los resultados por el campo titol de noticies, haremos la siguiente consulta

Si el campo que necesitamos filtrar es un campo anidado (está dentro de otro nodo), el nombre del campo será la concatenación de todos sus padres con un "." y el nombre del propio campo. Si, por ejemplo, necesitamos buscar por el campo enllacos_relacionats_nom haremos la siguiente consulta:

Búsquedas por texto libre

También es posible realizar búsquedas por texto libre para los campos tipo texto de cada colección. Esta búsqueda se realiza utilizando el campo q en la URL. Por ejemplo, la siguiente consulta buscará la palabra mobilitat dentro de los campos de la colección:

Este tipo de búsqueda se podrá combinar con la búsqueda específica por campos. Un ejemplo sería el siguiente

Búsquedas por campos de tipo Date

Las búsquedas por campos de tipo Date se realizan siguiendo la nomenclatura dd/mm/yyyy. Un ejemplo sería la siguiente consulta:

También se pueden realizar búsquedas por rango de datos utilizando los símbolos <, >, = dentro del valor del campo. Si, por ejemplo, necesitamos recuperar las noticias en las que la fecha debe ser mayor que 25/09/2014, realizaremos la siguiente consulta:

Paginación

Por defecto, en todas las búsquedas que realizamos, la aplicación nos retorna los resultados agrupados en 500 elementos. Si nos fijamos en la cabecera de los resultados de una búsqueda podemos identificar los distintos elementos: num: número de elementos que se muestran en la búsqueda.
count: número total de elementos que hay en la búsqueda.
start: primer elemento de la relación que se muestra

Para poder aplicar la paginación en la API deberemos indicar el número de elementos que queremos recuperar (rows) y a partir de qué elemento queremos recuperar los resultados (start):

Ordenación

La API permite ordenar los resultados por un campo en concreto de forma ascendente o descendente. En la consulta deberemos especificar por qué campo queremos ordenar y el sentido sort={{camp}},{{asc/desc}}.

Retorno de campos específicos en la respuesta

La API permite filtrar los campos retornados en los ítems de la respuesta. De esta manera podemos reducir considerablemente la información de la búsqueda. Si, por ejemplo, necesitamos sólo los campos entradeta y autor, lo haremos por medio del parámetro getFields:

Esta funcionalidad solo es válida para los campos de primer nivel, es decir, aquellos que provienen directamente de la raíz del ítem.

Búsqueda por diferentes valores de un mismo campo

Podemos realizar búsquedas por un campo cuyo valor coincida con alguno de los especificados dentro del campo de la búsqueda. Para poder hacerlo tenemos que separar cada valor por el símbolo |:

En el ejemplo buscará todos los contenidos donde el campo subambit coincida con algunos de los valores de la query.
Tenemos que tener en cuenta que los valores del parámetro tienen que ser exactos a los valores que buscamos (tienen que coincidir mayúsculas, acentos, signos de puntuación, ...).

Por defecto la API sirve los resultados en formato JSON. También es posible obtener la información de las búsquedas en formato XML, KML, KMZ i CSV. Las consultas se harán como sigue:

donde el campo {{format}} será el tipo de formato que necesitemos. Una búsqueda para formato XML sería de la siguiente manera:

Obtener los campos relacionados

Algunas colecciones tienen contenidos que están relacionados con contenidos de otras colecciones. Por ejemplo, la colección de actividades tiene contenidos relacionados con equipamientos o publicaciones. Para poder ver esta relación tenemos que añadir a la query el parámetro getRelatedArticles=true:

Con la búsqueda anterior obtendremos los contenidos relacionados de cada ítem. Si nos fijamos en el siguiente código veremos como nos aparece el campo related_articles donde nos indicará que un contenido tiene una relación con dos contenidos de publicacions y 8 contenidos de equipaments_platja.

Si quisiéramos ver un contenido relacionado tendríamos que buscar por el campo articleId dentro de la colección correspondiente.