Registro de skills
Comunicação e conhecimentoSkills públicas

Maps & Geolocation

Inteligência de localização para agentes de IA — geocodificação, roteamento com direções passo a passo, descoberta de POIs, elevação, matrizes de distância e consulta de fuso horário. Zero configuração, gratuito, cobertura global via OpenStreetMap.

O que esta skill ensina

Um roteiro reutilizável para um tipo específico de trabalho.

Um servidor MCP informa a um agente quais ações estão disponíveis. Uma skill adiciona o julgamento em torno dessas ações: como reconhecer o trabalho, qual sequência seguir, o que evitar e como decidir que o resultado está completo.

Orquestre operações de geolocalização — geocodifique endereços, calcule rotas com direções passo a passo, encontre pontos de interesse, obtenha dados de elevação, compute matrizes de distância e determine fusos horários. Use ao converter endereços em coordenadas, obter direções de condução, encontrar locais próximos, calcular distâncias…

Arquitetura

Como Maps & Geolocation orienta um agente ADK-Rust.

A skill permanece legível e portátil porque contém instruções em vez de credenciais de serviço ou dados de negócio. O ADK-Rust a fornece ao agente, o agente escolhe dentro do limite de ferramentas revisado e o servidor MCP conectado executa a operação autenticada.

01

Solicitação do usuário

O agente recebe um objetivo expresso em linguagem comum.

02

Habilidade Maps & Geolocation

Corresponde à intenção, fornece o guia de decisão e restringe o limite da ferramenta.

03

Agente ADK-Rust

Planeja o fluxo de trabalho e transmite cada passo significativo pelo runtime.

04

mcp-maps

Executa operações autenticadas contra o sistema que possui a capacidade.

05

Resultado verificado

As regras de conclusão da skill moldam as evidências retornadas ao usuário.

Instruções portáteis: SKILL.md · Limite de capacidade: mcp-maps · Ferramentas permitidas: 7

Guia de decisão

Como o agente transforma uma solicitação na ação correta.

Essas rotas vêm diretamente das instruções da skill. Elas ajudam o modelo a reconhecer a intenção e selecionar uma ferramenta ou fluxo de trabalho focado em vez de improvisar por toda a superfície da capacidade.

01

"where is", "coordinates", "geocode", "address to"?

geocode

02

"what's at", "address of", "reverse"?

reverse_geocode

03

"route", "directions", "how to get to", "drive"?

get_route

04

"nearby", "find", "restaurants", "hospitals", "ATM"?

search_poi

05

"distance", "how far", "between"?

distance_matrix

06

"elevation", "altitude", "height"?

get_elevation

07

"timezone", "what time", "UTC offset"?

get_timezone

Fluxos de trabalho comprovados

Sequências repetíveis para resultados úteis.

Um fluxo de trabalho une várias chamadas de ferramentas em uma tarefa que o usuário realmente reconhece. A skill explica a sequência e o resultado pretendido enquanto o ADK-Rust transmite o progresso do agente pelo runtime compartilhado.

011-2 chamadas

Obter Direções

Passo a passo com distância + duração

021-2 chamadas

Encontrar Próximos

Busca de POIs por categoria + raio

031 chamadas

Matriz de Distância

Distâncias entre múltiplos pontos

041 chamadas

Fuso Horário

País + deslocamento UTC para qualquer local

051 chamadas

Elevação

Altitude em qualquer coordenada

Limite da ferramenta

A skill pode usar 7 ferramentas documentadas.

Esta lista de permissões é declarada pela skill. Ela mantém o agente focado nas ações necessárias para este trabalho enquanto mcp-maps mantém a responsabilidade pela autenticação, validação e sistema conectado.

geocode
reverse_geocode
get_route
get_elevation
search_poi
distance_matrix
get_timezone

Regras de trabalho

O que o agente deve fazer.

  • Inclua sempre distância E duração nos resultados de rota
  • Especifique modo de transporte (carro/caminhada/bicicleta) — não presuma
  • Inclua unidades (km/milhas, minutos/horas)
  • Para busca de POI, especifique raio (não retorne resultados a 50km de distância)

Limites operacionais

O que o agente deve evitar.

  • Não presuma modo de transporte — pergunte se não estiver claro
  • Não retorne coordenadas sem contexto (inclua sempre nome do local)
  • Não ignore limites de taxa (1 requisição/seg para geocodificação)

Instalar e conectar

Adicione a skill ao lado da capacidade que ela espera.

Instale o repositório onde seu carregador de skills ADK-Rust possa descobri-lo, conecte mcp-maps e confirme que as ferramentas declaradas estão disponíveis antes de pedir ao agente para usar o fluxo de trabalho.

Instalar a skill
git clone https://github.com/zavora-ai/skill-maps-geolocation.git \
  ~/.skills/skills/maps-geolocation
Formato de carregamento 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()?;

A declaração de compatibilidade do repositório: Requer servidor mcp-maps conectado (OpenStreetMap, OSRM, OpenTopoData — grátis, sem chaves de API, zero configuração).

Documentação oficial

Leia o pacote completo da skill.

O repositório permanece autoritativo para suas instruções exatas, exemplos, scripts auxiliares, recursos, requisitos MCP, licença e atualizações posteriores.

Registro da fonte

Metadados do repositório para esta entrada da skill.

Ver repositório público ↗
Licença
Apache-2.0
Ferramentas permitidas
7
Referências
3
Revisão
e709ece01593
Atualizado
31 de mai. de 2026