用途:这是「On va où ?」路线规划 API 的 MCP(Model Context Protocol)服务器,面向 AI 助手,提供欧洲范围内的地址地理编码与多模式出行路线规划,让 AI 助手能直接回答地点定位与路线相关请求。
主要能力:包含两个工具。geocode_address 将地址、地名、车站或兴趣点(query,2 至 200 字符)转换为经纬度候选,最优在前,每个候选带有完整标签、类型和置信度评分。type 仅可为 address(门牌号)、street、locality(城镇、街区)、region、country、venue(具名地点:车站、酒店、纪念建筑)或 other。可用 near(围绕某点调整排序,该点须位于欧洲覆盖范围内)、country(ISO 3166-1 alpha-2)、limit(1 至 5)和 language(en、fr、de、it;默认 en,其他值会被拒绝)。数据来自 Photon(OpenStreetMap)覆盖欧洲,以及在法国由 IGN Géoplateforme 提供,后者在不可用、无结果或最佳置信度低于 0.4 时转给 Photon;source 字段说明由哪个来源应答。compute_route 接收起点与终点({ "lon": 2.3522, "lat": 48.8566 })、最多 8 个途经点、mode(bike、ebike、scooter、moto、wheelchair、foot)、variants、avoid(ferries、steps、tolls、highways、unpaved、steep)、指令语言(en、fr、de、es、it、nl、pt),并可选择是否包含逐步步骤、编码折线和海拔剖面。一次请求返回最多三条路线(safe、balanced、fast),并给出每条路线的价值指标:自行车道占比、未铺装路面、主干道与高速公路、爬升和逐步指引。
使用方式:先在 https://console.onvaou.app 创建免费 API 密钥(每月 10,000 次请求,无需信用卡)。然后将服务器加入 MCP 客户端,例如 Claude Desktop 的 claude_desktop_config.json;Claude Code 也可用同一密钥一行配置。两个工具随服务器提供:例如请求「从 Gare de Rennes 到 Thabor 公园的安全自行车路线」,助手会先对两个名称做地理编码,再用返回的坐标进行路线规划。若只有地名,需先调用 geocode_address。两个工具均为只读,先返回简短可读摘要,再以 JSON 返回相同数据,并报告调用消耗:地理编码器显示今日已用搜索次数,路线规划器显示本月已用请求次数。搜索有独立的每日配额,不计入每月路线规划配额,因此路线前的查询不消耗配额。
适用场景:需要为 AI 助手接入欧洲多模式出行路线与地点解析能力时使用,覆盖自行车、电动自行车、滑板车、摩托车、轮椅和步行,适合对路线安全性、路面类型、坡度等有判断需求的场景。
限制:覆盖范围仅限欧洲;地理编码结果的 language 参数仅接受 en、fr、de、it,选择 it 时地理编码器不会用意大利语标注,标签返回各地点当地语言(如 Milano、München);geocode_address 的 near 点必须位于欧洲覆盖范围内;每个回答都带有自身归属字符串,搜索还会说明由哪个来源提供,展示任何路线或结果时需一并显示该归属。许可证为 MIT,© 2026 OVO SAS;API 条款见 https://onvaou.app/cgv-api。文档见 https://onvaou.app/developers/routing-api.html,代码示例见 https://github.com/onvaou-app/routing-api-examples。