API para desarrolladores

Datos Abiertos

Introducción

Esta sección del portal Open Data está destinada a aportar información útil para los desarrolladores de aplicaciones y el público objetivo con un perfil técnico.

APIs

Las APIs (Application Programming Interface) hacen referencia a los procesos, funciones y métodos que ofrece una biblioteca de programación, como capa de abstracción, para que sea usada por otro programa informático.

En el portal Open Data podemos distinguir tres tipos:

API de gestión del catálogo: Esta API sirve para consultar y gestionar la información del catálogo, como datasets, recursos, etiquetas, etc…
APIs de consulta sobre recursos CSV: Permite consultar y filtrar la información contenida dentro de un CSV concreto.
APIs propias del Ayuntamiento: Son APIs desarrolladas por las propias fuentes de información.

Tanto la API de gestión del catálogo, como la de consulta sobre los recursos CSV se ofrecen como servicios web REST en formato JSON (de entrada y de salida).

Muchos de los métodos también se pueden llamar directamente por URL añadiendo los parámetros necesarios. Incluyendo el parámetro callback la respuesta se devuelva en formato JSON para su uso con Javascript.

APIs de gestión del catálogo

Se puede acceder mediante la API a los datasets y recursos publicados en el portal Open Data.

Se trata de la API que ofrece la tecnología CKAN para gestionar el catálogo de datasets. La documentación completa se puede encontrar en este enlace.

La URL base para la API es https://montilla-opendata.e-admin.es/api y se puede acceder a través de la URL https://montilla-opendata.e-admin.es/api/3/action, a la que se tendrá que añadir el nombre del método al que queremos acceder.

Este método es público y no requiere de ningún tipo de identificación ni token estando ahora mismo disponible el siguiente:

current_package_list_with_resources: devuelve el listado de datasets actuales y sus recursos

Puede encontrar ejemplos de consultas y el listado completo de métodos en la guía API de CKAN.

Así mismo, para facilitar la interoperabilidad entre catálogos de datos publicados en la web usamos la extensión DCAT.

APIs propias de la Diputación

Las APIs propias son las proporcionadas por los equipos que gestionan las fuentes de información. Estas APIs se enlazan desde el Portal de Open Data pero no se mantienen o validan desde el mismo que equipo que gestiona el portal. En el portal se tratan como un recurso más, como si fuera un enlace a un archivo CSV o RDF.

Actualmente, en el catálogo Open Data se ofrecen los siguientes recursos de tipo API:

Geoservicios WMS y WMTS de la Infraestructura de Datos Espaciales de la Diputación de Córdoba

Programación

Cómo transformar un archivo de extensión .csv inicialmente en formato WIDE a un archivo en formato LONG.

Describimos con un ejemplo cómo se puede transformar un archivo publicado en formato WIDE a uno publicado en formato LONG en lenguaje de programación Python.

#!/usr/bin/env python
# -*- coding: utf-8 -*-

#Para utilizar el script, llamar indicando el número de id_vars(columnas fijas) Ejemplo de 2 id_vars: python wide_to_long.py 2
import pandas as pd
import sys

df = pd.read_csv("in_WIDE.csv")
numero_ids = int(sys.argv[1])

id_vars = []

for i in range(numero_ids):
	id_vars.append(df.columns[i])

df = pd.melt(df, id_vars=id_vars, var_name='Concepte', value_name='Valor')
id_vars.append('Concepte')
id_vars.append('Valor')
df = df.reindex_axis(id_vars, axis=1)

dt = df.dtypes
print (dt)
print(df)

df.to_csv("out_LONG.csv", index = False)

Enlaces de interés

El portal de datos abiertos de la Unión Europea tiene una sección de Desarrolladores donde ofrece enlaces a clientes para la API de CKAN:

Otros

Disponemos de una sección de FAQ con preguntas frecuentes sobre el Open Data y el uso de los datos
Podéis enviar cualquier duda o consulta a través de Contacto del portal municipal