8. Overpass API¶
8.1. Introducción¶
Overpass API permite hacer consultas a la base de datos de OSM según distintos criterios de búsqueda. El criterio de búsqueda puede ser, entre otros, la localización de los elementos, el tipo de los mismos, que contengan determinadas etiquetas o combinaciones de varios criterios. Actua a modo de base de datos en la red: el cliente envía una petición (query) y obtiene como resultado el conjunto de datos que se corresponde con dicha petición. Los resultados de las consultas se pueden obtener en los formatos OSM XML y en OSM JSON.
El wiki de OpenStreetMap ofrece una página quepuede servir de introducción a las principales características de la API de Overpass en la siguiente dirección:
El portal de Overpass-API, por su parte, ofrece la información completa acerca del API, su lenguaje de consultas y otras herramientas que se ponen a disposición. La dirección del portal de Overpass API es:
Overpass API tiene su propio lenguaje. En este curso haremos una introducción a dicho lenguaje y aprenderemos cómo hacer algunas consultas básicas. Se puede encontrar una descripción más detallada de las especificaciones del lenguaje en las siguientes direcciones WEB:
En este curso también daremos una explicación del funcionamiento y posibilidades del portal Overpass Turbo. El portal Overpass Turbo se puede utilizar para hacer consultas utilizando Overpass API y obtener las salidas en diferentes formatos. Ofrece varias utilidades relacionadas con la realización de las consultas, como la posibilidad de crear enlaces a las mismas, exportación de los resultados en varios formatos, la posibilidad de hacer consultas en lenguaje natural y otras. Más adelante, explicaremos algunas de ellas. La dirección del portal de Overpass Turbo es:
Otro portal interesante para probar o fabricar consultas es el siguiente:
Una opción interesante de este último portal es la posibilidad de generar un programa OpenLayers con el mapa de OpenStreetMap y la consulta.
Overpass API tiene ciertas limitaciones. Para consultas que consistan en todos los elementos de un área geográfica extensa, es más operativo utilizar los paquetes de datos proporcionados por Geofrabik u otros distribuidores de datos. Se pueden consultar los distribuidores de datos en:
Otra limitación de las consultas a través de Overpass API es que no podemos hacer consultas acerca de los changesets, esto es, los conjuntos de cambios que han ido afectando a determinados elementos. Sí que podemos haecr la consulta con un criterio de selección temporal que nos indique el estado de un elemento en determinado instante de tiempo.
8.2. Peticion de los node de una zona¶
La petición más sencilla que podemos hacer es, seguramente, la de los elementos del tipo node contenidos en un area delimitado por un boundig box. Un bounding box es una área rectangular del mapa definido por las coordenadas de su esquina inferior izquierda (sur-oeste) y las de su esquina superior derecha (norte-este). El orden en que se escriben las coordenadas es ‘latitud mínima, longitud mínima, latitud máxima, longitud máxima’. (Nota: Hay que tener en cuenta que, cuando las longitudes o latitudes son negativas, los valores menores corresponden a valores abslutos mayores, así la longitud -3.98 es *menor que la longitud -3.8, por ejemplo*).
Veamos un ejemplo de una query que solicite todos los nodos contenidos en un rectángulo de coordenadas ‘40.4447, -3.7344, 40.4484, -3.7301’. La sentencia o query que tenemos que escribir en el lenguaje QL de Overpass API es la siguiente:
(node(40.4447, -3.7344, 40.4484, -3.7301));out;
El mismo ejemplo, con otras coordenadas:
(node(41.9842, 2.8272, 41.9860, 2.8287));out;
Puedes probar la orden tecleándola en el portal Overpass Turbo o directamente accediendo al siguiente enlace que se ha obtenido mediante la opción share de dicho portal:
Esta sentencia en realidad son dos órdenes a la API de Overpass:
- La primera orden es (node(minlat, minlon, maxlat, maxlon)). El bounding box se especifica como: (minLat, minLon, maxLat, maxLon).
- La segunda orden es out
Las dos ordenes se separan por un punto y coma y se ejecutan una a continuación de otra. Podemos enlazar varias ordenes una detrás de otra separándolas por punto y coma. La orden completa funciona a modo ‘tubería’. El resultado de cada orden individual se pasa a la siguiente orden, que operará sobre dicho resultado. En el ejemplo anterior, el resultado de los nodos del bounding box son los que se pasan a la orden out, que nos devuelve el conjunto de datos.
Podemos afinar nuestra búsqueda.Para ello vamos a añadir un filtro que seleccione solo los nodos que tengan la etiqueta highway con el valor bus_stop. Aplicaremos esta orden a un boundig box un poco mayor, que abarque una zona amplia de la Ciudad Universitaria. De esta forma obtendremos todas las paradas de autobús que figuren en el mapa dentro de la zona especificada por el bounding box:
(node(40.4405, -3.7371, 40.4516, -3.7197)[highway=bus_stop]);out;.
El portal Overpass Turbo nos ofrece la posibilidad de obtener los resultados dibujando los nodos sobre un mapa o en formato OSM XML. Para ello hay que pulsar la pestaña correspondiente en la esquina superior derecha.
Más adelante veremos como combinar varias etiquetas o como realizar peticiones más complejas. De momento vamos a repasar un poco algunas de las opciones que nos ofrece el portal de Overpass Turbo.
8.3. Opciones de Overpass Turbo¶
El portal de Overpass Turbo nos ofrece unas cuantas opciones muy interesantes. Se accede a ellas en las pestañas que aparecen en la parte superior de la página. Las opciones principales son las siguientes:
- Run: ejecuta la consulta que esté escrita en el editor y muestra el resultado en la pantalla del mapa. Una vez ejecutada la consulta puede ser necesario pulsar sobre la pequeña lupa que aparece en la parte superior izquierda delmapa para que centre la vista sobre la consulta que se acaba de realizar.
- Share: ofrece un enlace mediante el cual podemos recuperar la consulta mediante un navegador.
- Export: permite guardar en disco el resultado de la consulta en diferentes formatos. También permite guardar el propio mapa, como imagen png, o como mapa interactivo. Por último, desde esta opción, también podemos grabar el texto de la propia consulta.
- Wizard: esta opción nos ayuda a crear consultas mediante lenguaje natural, que luego convertirá al lenguaje de Overpass API.
- Save: guarda en el propio navegador una consulta para poder utilizarla en otro momento posterior de la sesión de trabajo.
- Load: recupera una consulta guardada anteriormente mediante el comando save
- Settings: permite configurar algunas de las opciones del programa
- Help: ayuda en la que se explican todas las opciones y atajos de teclado del programa.
- Map-Data: como se explicó en el aprtado anterior, estas pestañas permiten seleccionar que la salida de resultados de una consulta se muestre sobre el mapa o como texto en formato OSM XML
El mapa también dispone de algunas opciones de navegación en los botones de la parte superior izquierda.
8.4. Ejemplos con Overpass Turbo¶
8.4.1. Un elemento por su ID¶
Si conocemos el Id del elemento que queremos descargar podemos solicitar la información del mismo:
node(4129698657);out;
8.4.2. Todos los nodos con una etiqueta determinada¶
Todas las farmacias del Barrio de Salamanca en Madrid:
node(40.9365, -5.7087, 40.9942, -5.6586)["amenity"="pharmacy"];out;
Todas los nodos paradas de autobús de la Ciudad Universitaria en Madrid:
node(40.4405,-3.7404,40.4551,-3.7279)["highway"="bus_stop"];out;
Todos nodos los hospitales de Madrid:
node(40.3091,-3.7707,40.5420,-3.5702)["amenity"="hospital"];out;
8.4.3. Todos los nodos con dos etiquetas determinadas¶
Podemos poner como condición que el valor de dos o más etiquetas esté determinado, por ejemplo, para encontrar el Restaurante ‘El Albero’ de Moralzarzal:
node(40.6631, -4.0142, 40.6927, -3.9468)["amenity"="restaurant"]["name"="El Albero"];out;
También podríamos encontrarlo sin especificar el bounding box, solo por etiquetas:
node["addr:city"="Moralzarzal"]["amenity"="restaurant"]["name"="El Albero"];out;
8.4.4. Ways de una Relation¶
Todas las ways de Madrid referenciadas en la relación de ref=M-40:
relation(40.3091,-3.7707,40.5420,-3.5702)["ref"="M-40"];way(r);out;
8.4.5. Ways con recursividad a nodos para que se vean las líneas¶
La carretera M-607:
way(40.6573,-3.9610,40.7169,-3.7423)["ref"="M-607"];(._;>;);out;
Todos los ways con la etiqueta building=house de una determinada zona:
way(40.67441, -3.97063, 40.67812, -3.96221)["building"="house"];(._;>;);out;
8.4.6. Unión¶
Podemos hacer la unión de dos queries poniéndolas entre paréntesis y separadas por ‘;’. Por ejemplo, la siguiente sentencia solicita los Nodes con ‘amenity=restaurant’ o ‘amenity=pub’:
(node(41.9837,2.8243,41.9866,2.8307)[amenity=restaurant];
node(41.9837,2.8243,41.9866,2.8307)[amenity=pub]);out;
Otro ejemplo: todos los bares o pubs del Barrio de Salamanca en Madrid:
(node(40.4232,-3.6918,40.4378,-3.6793)["amenity"="bar"];
node(40.4232,-3.6918,40.4378,-3.6793)["amenity"="pub"];);out;
Otro ejemplo podría ser todos los edificios y piscinas de una determinada zona:
(way(40.67441, -3.97063, 40.67812, -3.96221)["building"="house"];
way(40.67441, -3.97063, 40.67812, -3.96221)["leisure"="swimming_pool"]);
(._;>;);out;
8.4.7. Around: Elementos a cierta distancia de un punto¶
Podemos pedir los Nodes que se encuentran a una determinada distancia de un punto de coordenadas conocidas:
node(around:100.0,41.9837,2.8243);out;
Un ejemplo podría ser obtener las farmacias a menos de un kilómetro de la Plaza del Carmen, en Madrid:
node(around:1000.0,40.41876,-3.70331)["amenity"="pharmacy"];out;
Around de un elemento determinado del que conocemos su Id. En el siguiente ejemplo se obtienen los bares a menos de 500 metros de la iglesia de Moralzarzal:
way(132527765);node(around:500)["amenity"="bar"];out;
Hay multitud de combinaciones que permiten hacer todo tipo de consultas selectivas. Se puede consultar la documentación completa del lenguaje en el siguiente enlace:
8.5. Encontrar el ID de un elemento¶
Si queremos conocer el Id que corresponde a un elemento del mapa, podemos activar la edición con Id y, a continuación, pinchar en el enlace que aparece abajo del panel Ver en openstreetmap.org. Nos abrirá una ventana nueva con el mapa y el elemento seleccionado. También nos mostrará información del elemento.
8.6. Acceder a la información de un elemento conocido su tipo y su Id¶
Podemos acceder directamente a la información de un elemento accediendo a la web dirección:
http://www.openstreetmap.org/tipo/id
Un ejemplo sería el siguiente, en el que se accede a la información de la Iglesia de Moralzarzal:
https://www.openstreetmap.org/way/132527765
En la parte inferior del panel de información aparece un enlace desde el que podemos descargar el elemento en formato .osm.
8.7. Conocer el historial de cambios de un elemento¶
Utilizando el procedimiento del apartado anterior, en la parte inferior del panel de información del elemento aparece un enlace que nos mostrará el historial de cambios.
También podemos acceder directamente, si conocemos el tipo de elemento y su id mediante la siguiente url:
http://www.openstreetmap.org/tipo/id/history
Por ejemplo, para acceder al historial de la Plaza de Toros de Moralzarzal, que tiene el id=93278820:
8.8. Utilización con wget desde Linux¶
También podemos utilizar el comando linux wget con la siguiente estrutura:
wget -O file.osm "http://overpass-api.de/api/interpreter?data=sentencia_overpass_api"
8.9. Utilización desde lenguajes de programación¶
Mediante peticiones GET o POST, podemos realizar las consultas desde cualquier lenguaje de programación.