emap — Euskadi hyperlocal mobility

emap/labs

地理智能基础设施 · 巴斯克地区 → 欧洲

emap 背后的数据与 AI 实验室：版本化城市数据集、语义搜索、地理空间 RAG，以及西班牙语和巴斯克语检索基准。emap 是产品，也是这里所有成果的首个使用者。

EN：面向巴斯克地区的开放地理检索基准（西班牙语／巴斯克语）和版本化城市交通数据集。只需三条命令即可复现。

基准测试 · MCP · 复现 · 数据集 · 伦理 · 引用

西班牙语／巴斯克语检索基准

当前黄金语料包含 162 个案例，涵盖 22 个图层（水源、厕所、停车场、交通、AED、药房、图书馆、山峰……）的超本地化地理搜索，使用西班牙语和巴斯克语：85 个开发集案例、29 个密封的留出集案例和 48 个挑战集案例。其中包含 24 个弃答案例（answerable: false——会编造答案的检索器就是失败的检索器）。巴斯克语文本经巴斯克政府的神经机器翻译工具 Itzuli 校对，并非未经审校的机器翻译生硬文本。

最新的历史版本结果表（k=5，2026-08-05；未在 2026-08-27 的冲刺中重新运行）：

检索器	开发集 ES	留出集 ES	开发集 EU	留出集 EU
基线关键词+地理位置	74%	60%	71%	62%
混合 · MiniLM-L12 多语言版	76%	58%	71%	63%
混合 · multilingual-e5-large	76%	73%	71%	71%

e5-large 是生产环境中部署的模型。校准参数为 τ=0.80/tie=0.01（属于模型与语料的组合，不可继承）。

核心发现：巴斯克语的差距不在语言，而在模型。使用 MiniLM 时，语义阶段对巴斯克语几乎没有帮助；使用 e5-large 后，西班牙语留出集的得分从 58% 升至 73%（+15），巴斯克语则从 63% 升至 71%（+8）。

校准后的挑战套件：包含 48 个案例，涵盖新增图层和边界情况；仅供参考，不能替代留出集。完整报告——包括方法、成本／延迟和局限性——见 BENCHMARK.md；测试框架的经验总结见 evals/README.md。

通过你的 Agent 使用 emap（MCP）

首个超本地出行 MCP 服务：虽然已有通用的 GTFS 和 OSM MCP 服务，但没有一个能向 Agent 提供本地出行智能——双语 ES/EU 语义搜索、地点上下文、基于自有基础设施的多模式路线，以及乘坐公共交通上山。 五种工具（mcp/）：

工具	回答的问题
search_places	“哪里可以喝水” · “haurra aldatzeko lekua”（诚实地拒绝回答）
nearby_pois	最近的 DEA / 洗手间 / 自行车停车处 / 山顶
explain_place	这里属于哪个街区，周边有哪些服务
plan_route	实际的公交/步行/骑行/驾车路线（自有 OSRM/OTP）
plan_hike	今天乘坐公共交通去爬哪座山顶（2.825 座山顶 × 9 个网络）

{ "mcpServers": { "emap": {
    "command": "/ruta/a/emap-labs/.venv/bin/python",
    "args": ["/ruta/a/emap-labs/mcp/server.py"] } } }

远程使用（无需安装），注册项为 io.github.r3tr0eth/emap：

{ "mcpServers": { "emap": { "url": "https://vps.emapapp.com/mcp" } } }

正在将 URL 迁移到产品域名（emapapp.com）——详情见 mcp/README.md。冒烟测试：.venv/bin/python mcp/smoke.py --base https://vps.emapapp.com --live。

每条响应都包含 attribution（ODbL + GTFS + CC-BY-4.0）。已满足验收标准，并通过协议验证：“San Mamés 附近哪里可以停自行车？” → 47 m 处的自行车停车处，并附带归属信息。

三条命令复现

git clone https://github.com/r3tr0eth/emap-labs && cd emap-labs
pip install -r evals/requirements.txt
python evals/run.py --retriever hybrid --profile minilm --lang eu

自包含：数据快照位于 evals/data/（与 CI 使用的数据相同，每次推送都会运行 development 回归门禁）。Held-out 仅在最终决策时手动运行；不会在每次迭代中出现。每个 JSON 都会记录地域、配置文件、模型、τ 和 tie-window 的版本。规范配置文件位于 evals/retriever-config.json。

数据集

预发布版本 v0.3.0-rc.1（2026-08-29）：在 Euskadi 和首个 Madrid 官方数据包上，验证相同的地域注册表和检索流水线。可下载资源包含 8 个数据集 / 17.241 条记录；Madrid 提供 2.306 条可验证的市政来源。Euskadi 的完整语料保留了 22 个出行与基础设施图层——饮水点、洗手间、停车场、自行车停车处、电动汽车充电点、除颤器、海滩、药房、图书馆、体育设施、餐厅、住宿、露营地、自然区域、山顶、长椅、垃圾桶、回收设施、避难所、邮箱、电话亭和多网络站点（地铁、Euskotren、Cercanías、Bilbobus、Bizkaibus）。覆盖范围扩展至整个 Bizkaia。详情和元数据：releases/RELEASE-NOTES.md。每个数据集都会声明来源、许可证、日期和覆盖范围估算；仅在能够诚实估算时才提供覆盖范围。可复现流水线位于 datasets/。

结构

evals/      corpus dorado ES/EU, harness, resultados versionados
datasets/   pipelines de datasets propios (places, barrios, scores)
service/    servicio semántico (FastAPI + fastembed, corre en VPS propio)
regions/    packs y registro territorial de runtime
mcp/        adapter para agentes sobre API + Labs
releases/   releases versionadas de datasets
docs/       Intelligence/Core, roadmap, ética e informes de cobertura

原则

• DATOS ANTES QUE MODELOS — 在此阶段不会训练或微调任何内容。
• NO SE FINGE — 无法衡量的内容就不纳入；评估会奖励坦承“我不知道”。
• DOGFOODING — emap 在生产环境中实际使用之前，任何内容都不算完成。
• ES/EU EN PARIDAD — 巴斯克语用于书写，而不是翻译。

决策规则：每项开发都必须改进 emap、可复用、可作为开源项目发布或可销售。不符合任何一项，就不做。

伦理与局限

docs/ETICA-DATOS.md 是硬性规则，而非愿景： 描述基础设施，绝不描述人员。已声明的局限：OSM 制图偏差（Bilbao 的覆盖优于外围地区——在每个数据集的 coverage.notes 中声明）、由一个人编写的合成语料（未来将由匿名化的真实查询取代），以及仅基于 dev 校准的阈值——因此以 held-out 为准。

如何引用

如果使用此基准、语料或数据集，请引用此仓库 （GitHub：通过 CITATION.cff 选择 Cite this repository）：

@software{emaplabs2026,
  author  = {Jiménez, Gaizka},
  title   = {EMAP Labs: verifiable geographic retrieval benchmark and
             territorial mobility datasets for Euskadi and Madrid},
  year    = {2026},
  doi     = {10.5281/zenodo.21282784},
  url     = {https://github.com/r3tr0eth/emap-labs},
  version = {0.3.0-rc.1}
}

致谢

数据来自 OpenStreetMap 和 Open Data Euskadi。语料中的巴斯克语经 Itzuli（巴斯克政府）核对。 嵌入由 fastembed 提供。

许可证

• 代码：Apache-2.0。
• 自有评估语料（evals/*.yaml、文档）：CC-BY-4.0——署名“EMAP Labs”。
• 衍生数据：衍生自 OpenStreetMap 的数据继续适用 ODbL；衍生自 Open Data Euskadi 的数据继续适用 CC-BY-4.0，并须注明门户网站。每个数据集都会在其元数据中声明来源和许可证。