# emap

> Movilidad de Euskadi (País Vasco): transporte público multi-red, rutas
> multimodales con infraestructura propia (OSRM/OTP), POIs urbanos de datos
> abiertos y búsqueda semántica local en español y euskera. API pública de
> solo lectura, sin credenciales. Atribución: © OpenStreetMap (ODbL) +
> GTFS oficiales + Open Data Euskadi (CC-BY-4.0).

Para agentes: existe un servidor MCP oficial con estas capacidades como
herramientas (search_places, nearby_pois, explain_place, plan_route,
plan_hike): https://github.com/r3tr0eth/emap-labs/tree/main/mcp

## API (GET, JSON)

- [/api/semantic-search?q=&lat=&lon=&k=](https://emap-next.vercel.app/api/semantic-search?q=fuente%20de%20agua&lat=43.263&lon=-2.935&k=3): búsqueda semántica local ES/EU; `abstained:true` cuando no entiende la consulta (no inventa)
- [/api/geocode?q=&lat=&lon=&limit=](https://emap-next.vercel.app/api/geocode?q=san%20mames&lat=43.263&lon=-2.935&limit=3): geocodificador bilingüe de Euskadi con bias opcional
- [/api/pois/{layer}?bbox=W,S,E,N](https://emap-next.vercel.app/api/pois/fountains?bbox=-2.95,43.25,-2.92,43.27): POIs por capa — fountains, toilets, parking, bikepark, defib, beaches, ev, cameras, fuel, peaks, metro, euskotren, cercanias, bilbobus, bizkaibus
- [/api/route?mode=&from=lat,lon&to=lat,lon](https://emap-next.vercel.app/api/route?mode=transit&from=43.263,-2.935&to=43.257,-2.924): ruta real; mode transit|walk|bike|car
- [/api/explain-place?lat=&lon=](https://emap-next.vercel.app/api/explain-place?lat=43.263&lon=-2.935): barrio/municipio y servicios cercanos de un punto
- [/api/fuel-best?lat=&lon=&fuel=](https://emap-next.vercel.app/api/fuel-best?lat=43.263&lon=-2.935): gasolinera más barata cerca (g95|goa|glp)

## Datos derivados destacados

- [/data/processed/mendi/peaks-transit.json](https://emap-next.vercel.app/data/processed/mendi/peaks-transit.json): 2.825 cimas de Euskadi × parada más cercana de 9 redes ("el monte en transporte público"; distancias en línea recta, declarado en `method`)

## Proyecto

- [emap-labs (público, Apache-2.0)](https://github.com/r3tr0eth/emap-labs): benchmark de retrieval geográfico ES/EU (DOI 10.5281/zenodo.21282784), datasets versionados con checksums, ética de datos
- Regla dura: se describe la infraestructura, jamás a las personas.