Apunta tu cliente aquí
El endpoint recibe la consulta como data, igual que Overpass: en la URL, como campo de formulario o como cuerpo POST sin procesar. Envía la clave en la cabecera Authorization, o como ?key= para los clientes que no pueden definir cabeceras.
La respuesta lleva los habituales version, generator, osm3s y elements. Un cliente que te deja cambiar la dirección del servidor funciona con https://geo.runningcat.dev/v1/overpass/interpreter?key=YOUR_KEY, siempre que sus consultas se mantengan dentro de lo que se lista abajo. Hay más consultas en la página de ejemplos de Overpass QL.
Lo que responde
- Consultas:
node,way,rel,nwr,nw,nr,wryarea, con conjuntos con nombre (->.a,.a) y uniones. - Filtros de etiquetas:
[k],[!k],[k=v],[k!=v],[k~re],[k!~re],[~kre~vre]y el,i, que ignora mayúsculas y minúsculas. - Dónde: un bbox,
aroundun punto o una línea,poly, ids,areaeis_in.area[...]encuentra límites administrativos y áreas protegidas. - Salida:
outconbody,skel,ids,tags,geom,center,bb,count, un límite yqt. - Ajustes:
[out:json]y[bbox]. Se aceptan[timeout]y[maxsize], y cada consulta dispone de hasta 30 segundos.
En qué se diferencia de Overpass
- Toda consulta necesita un bbox,
around,poly, area o id. Una consulta de etiquetas sobre todo el mundo se rechaza. - No se admiten la recursión (
>,<,>>,<<), la diferencia,foreach,if,make,convert,map_to_areaniaroundsobre un conjunto. Tampoco el historial ni los diffs (date,diff,adiff) ni los filtrosuser,newerychanged. - Las vías vienen sin sus listas de nodos y las relaciones sin sus miembros reales. Con
out geomuna vía lleva su geometría, y una relación lleva en su lugar miembros con geometría. - La respuesta es solo JSON, con como máximo 10 000 elementos en el plan Free, 25 000 en Developer y 50 000 en Pro. No se incluyen los metadatos de edición (versiones, usuarios, conjuntos de cambios).
- Los datos de mapas se actualizan cada mes, no cada minuto.
Una consulta que usa algo no admitido devuelve un error con un remark que lo nombra, así sabes enseguida qué cambiar.
Límites con los que puedes planificar
El servidor público principal de Overpass pide mantenerse por debajo de unas 10 000 consultas y 1 GB de descargas al día, una centésima parte de eso para uso regular, y envía a los usuarios comerciales a servidores de pago o alojados por uno mismo (wiki de OpenStreetMap). Su límite da a cada dirección IP unas pocas plazas, así que cuando tu backend envía las consultas, todos tus usuarios comparten esas plazas. La guía de errores 429 y 504 explica cómo funciona.
Aquí los límites pertenecen a tu clave, y cada consulta Overpass cuenta como una petición, devuelva lo que devuelva. Cuánto puede contener una respuesta depende del plan.
| Plan | Peticiones al día | Por minuto | Simultáneas | Elementos en una respuesta | Precio |
|---|---|---|---|---|---|
| Free | 500 | 30 | 1 | 10,000 | $0 |
| Developer | 5,000 | 300 | 4 | 25,000 | 14,99 $ al mes |
| Pro | 20,000 | 1,200 | 8 | 50,000 | 39,99 $ al mes |
Al superar un límite, la petición se rechaza con el estado 429 y una cabecera Retry-After; no se factura nada extra. En nuestras pruebas, las cafeterías alrededor de un punto llegaron en unos 0,2 segundos, el agua potable en un recuadro del tamaño de una ciudad en cerca de 1 segundo y las panaderías dentro del límite de Cracovia en unos 3 segundos. Una consulta por area sobre un país entero puede superar el timeout.
Más que datos de mapas, con la misma clave
La clave también da previsiones de tiempo y calidad del aire, calidad del aire medida, niveles de ríos, altitudes, zonas horarias, rutas y paradas a lo largo de una ruta. Consulta POI a lo largo de una ruta, la API de tiempo y todo lo que hace la API.