技能注册表
通信与知识公共技能

Maps & Geolocation

面向 AI 代理的位置智能 — 地理编码,带转弯指示的路线规划,兴趣点发现,海拔,高程矩阵和时区查询。零配置,免费,全球覆盖,基于 OpenStreetMap。

此技能教授的内容

针对特定工作类型的可复用操作手册。

MCP 服务器告诉代理可用的操作。技能为这些操作添加判断:如何识别任务,遵循哪个顺序,避免什么,以及如何判断结果已完成。

协调地理定位操作——地理编码地址,计算带转向指示的路线,查找兴趣点,获取海拔数据,计算距离矩阵,确定时区。适用于地址转坐标、获取驾车导航、查找附近地点、计算距离等场景。

架构

Maps & Geolocation 如何指导 ADK-Rust 代理。

技能保持可读和可移植,因为它包含说明而非服务凭证或业务数据。ADK-Rust 将其提供给代理,代理从审核过的工具边界中选择,连接的 MCP 服务器执行经过身份验证的操作。

01

用户请求

代理接收以普通语言表达的目标。

02

Maps & Geolocation 技能

匹配意图,提供决策指南,并缩小工具边界。

03

ADK-Rust 代理

规划工作流,并通过运行时流式传输每个关键步骤。

04

mcp-maps

对拥有该能力的系统执行经过身份验证的操作。

05

已验证结果

技能的完成规则决定返回给用户的证据。

可移植的说明: SKILL.md · 能力边界: mcp-maps · 允许的工具: 7

决策指南

代理如何将请求转化为正确操作。

这些路由直接来自技能说明。它们帮助模型识别意图并选择专注的工具或工作流,而不是在整个能力范围内即兴发挥。

01

“在哪里”、“坐标”、“地理编码”、“地址转坐标”?

geocode

02

“那里有什么”、“地址查询”、“反向地理编码”?

reverse_geocode

03

“路线”、“导航”、“怎么去”、“驾车”?

get_route

04

“附近”、“查找”、“餐厅”、“医院”、“ATM”?

search_poi

05

“距离”、“多远”、“之间”?

distance_matrix

06

“海拔”、“高度”?

get_elevation

07

“时区”、“时间”、“UTC 偏移”?

get_timezone

经过验证的工作流

可重复的序列以实现有用结果。

工作流将多个工具调用组合成用户实际识别的任务。技能解释顺序和预期结果,而 ADK-Rust 通过共享运行时实时传输代理的进度。

011-2 次调用

获取路线

带距离和时长的转弯指示

021-2 次调用

查找附近

按类别和半径搜索兴趣点

031 次调用

距离矩阵

多点间全对距离计算

041 次调用

时区

任意位置的国家和 UTC 偏移

051 次调用

海拔

任意坐标的高度

工具边界

技能可能使用 7 个已记录工具。

此允许列表由技能声明。它使代理专注于完成此任务所需的操作,而 mcp-maps 保留身份验证、验证和连接系统的责任。

geocode
reverse_geocode
get_route
get_elevation
search_poi
distance_matrix
get_timezone

工作规则

代理应做什么。

  • 路线结果中始终包含距离和时长
  • 指定交通方式(驾车/步行/骑行)——不要假设默认
  • 包含单位(公里/英里,分钟/小时)
  • 兴趣点搜索时指定半径(避免返回50公里外结果)

操作边界

代理应避免什么。

  • 不确定时不要假设交通方式——应询问
  • 不要仅返回坐标,必须包含地点名称
  • 遵守速率限制(地理编码每秒1次请求)

安装并连接

将技能添加到其预期能力旁边。

安装仓库,使您的 ADK-Rust 技能加载器能发现它,连接 mcp-maps,并确认声明的工具可用后,再让代理使用工作流。

安装技能
git clone https://github.com/zavora-ai/skill-maps-geolocation.git \
  ~/.skills/skills/maps-geolocation
ADK-Rust 加载形态
let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("maps-geolocation").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

仓库的兼容性声明:需要连接 mcp-maps 服务器(OpenStreetMap、OSRM、OpenTopoData——免费,无需 API 密钥,零配置)。

源记录

此技能条目的仓库元数据。

查看公共仓库 ↗
许可证
Apache-2.0
允许的工具
7
参考文献
3
修订
e709ece01593
已更新
2026年5月31日