emap — Euskadi hyperlocal mobility

emap/labs

地理インテリジェンス基盤 · EUSKADI → EUROPA

emapを支えるデータとAIのラボです。バージョン管理された都市データセット、セマンティック検索、地理空間RAG、スペイン語とバスク語の検索ベンチマークを提供します。emapは製品であり、ここで生み出されるすべての成果を最初に活用するプロジェクトです。

EN: オープンな地理検索ベンチマーク（スペイン語／バスク語）と、バスク地方のバージョン管理された都市モビリティデータセットです。3つのコマンドで再現できます。

ベンチマーク · MCP · 再現 · データセット · 倫理 · 引用

スペイン語／バスク語の検索ベンチマーク

現在のゴールドコーパスは、スペイン語とバスク語でのハイパーローカルな地理検索162件を、22のレイヤー（給水所、トイレ、駐車場、交通、AED、薬局、図書館、山頂など）にわたって収録しています。内訳は、開発用85件、封印済みのホールドアウト29件、チャレンジ48件です。回答不能なケース（answerable: false — 作り話をする検索器は失格）も24件含まれます。バスク語の照合には、バスク政府のニューラル翻訳ツールItzuliを使用しています。人手で確認していない機械翻訳による人工的なバスク語ではありません。

バージョン管理された過去の最新テーブル（k=5、2026-08-05。2026-08-27のスプリントでは再実行していません）：

検索器	開発 ES	ホールドアウト ES	開発 EU	ホールドアウト EU
キーワード＋地理情報のベースライン	74%	60%	71%	62%
ハイブリッド · MiniLM-L12 mult.	76%	58%	71%	63%
ハイブリッド · multilingual-e5-large	76%	73%	71%	71%

e5-largeは本番環境にデプロイされているモデルです。キャリブレーションはτ=0.80/tie=0.01です（モデルとコーパスの組み合わせに固有で、別の組み合わせには引き継げません）。

主な発見：バスク語の性能差は言語ではなく、モデルによるものでした。MiniLMでは、EUにおけるセマンティック段階の貢献はほとんどありませんでした。e5-largeでは、ホールドアウトのESが58%から73%（+15）、EUが63%から71%（+8）に向上しました。

キャリブレーション後のチャレンジスイートには、新しいレイヤーとエッジケースを含む48件が含まれます。参考情報として有用ですが、ホールドアウトの代わりにはなりません。手法、コスト／レイテンシ、制限事項を含む完全なレポート： BENCHMARK.md；ハーネスから得られた教訓： evals/README.md。

エージェントからの emap（MCP）

ハイパーローカルモビリティの初の MCP サーバー：GTFS や OSM の汎用的な MCP は存在しますが、地域のモビリティ情報をエージェントに提供するものはありません。バイリンガルの ES/EU セマンティック検索、場所のコンテキスト、独自のインフラを使ったマルチモーダルルート、そして公共交通機関で行ける山を提供します。5 つのツール（mcp/）：

ツール	回答する質問
search_places	「水を飲める場所はどこ？」・「haurra aldatzeko lekua」（正直に回答を控える機能付き）
nearby_pois	最寄りの AED／トイレ／駐輪場／山頂
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" } } }

製品ドメイン（emapapp.com）への URL 移行を進行中です。詳細は 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 先の駐輪場を出典情報付きで回答します。

3 つのコマンドで再現

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 が使用するものと同じで、push ごとに development のリグレッションゲートを実行します）。Held-out は最終判断のために手動でのみ実行し、各イテレーションでは実行しません。各 JSON には、テリトリー、プロファイル、モデル、τ、タイウィンドウのバージョンが記録されています。標準プロファイルは 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 に明記）、1 人が作成した合成コーパス（匿名化した実際のクエリに置き換える予定）、閾値を dev のみで調整していること（そのため held-out の結果を最優先します）。

引用方法

ベンチマーク、コーパス、データセットを利用する場合は、リポジトリを引用してください（GitHub の Cite this repository。 CITATION.cff を参照）：

@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 が適用されます。各データセットのメタデータには、出典とライセンスが記載されています。