Registro de skills
Comunicación y conocimientoSkills públicas

Maps & Geolocation

Inteligencia de ubicación para agentes de IA — geocodificación, rutas con indicaciones paso a paso, descubrimiento de POI, elevación, matrices de distancia y consulta de zona horaria. Sin configuración, gratis, cobertura global vía OpenStreetMap.

Qué enseña esta habilidad

Un manual reutilizable para un tipo específico de trabajo.

Un servidor MCP indica a un agente qué acciones están disponibles. Una habilidad añade el juicio alrededor de esas acciones: cómo reconocer el trabajo, qué secuencia seguir, qué evitar y cómo decidir que el resultado está completo.

Orquesta operaciones de geolocalización: geocodifica direcciones, calcula rutas con indicaciones paso a paso, encuentra puntos de interés, obtiene datos de elevación, calcula matrices de distancia y determina zonas horarias. Úsalo para convertir direcciones en coordenadas, obtener direcciones para conducir, encontrar lugares cercanos, calcular distancias…

Arquitectura

Cómo Maps & Geolocation guía a un agente ADK-Rust.

La habilidad se mantiene legible y portátil porque contiene instrucciones en lugar de credenciales de servicio o datos de negocio. ADK-Rust la suministra al agente, el agente elige dentro de su límite de herramientas revisado y el servidor MCP conectado realiza la operación autenticada.

01

Solicitud del usuario

El agente recibe un objetivo expresado en lenguaje común.

02

Habilidad Maps & Geolocation

Coincide con la intención, suministra la guía de decisiones y limita el límite de herramientas.

03

Agente ADK-Rust

Planifica el flujo de trabajo y transmite cada paso significativo a través del entorno de ejecución.

04

mcp-maps

Ejecuta operaciones autenticadas contra el sistema que posee la capacidad.

05

Resultado verificado

Las reglas de finalización de la habilidad moldean la evidencia devuelta al usuario.

Instrucciones portátiles: SKILL.md · Límite de capacidad: mcp-maps · Herramientas permitidas: 7

Guía de decisiones

Cómo el agente convierte una solicitud en la acción correcta.

Estas rutas provienen directamente de las instrucciones de la habilidad. Ayudan al modelo a reconocer la intención y seleccionar una herramienta o flujo de trabajo enfocado en lugar de improvisar en toda la superficie de capacidad.

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

Flujos de trabajo probados

Secuencias repetibles para resultados útiles.

Un flujo de trabajo une varias llamadas a herramientas en una tarea que el usuario realmente reconoce. La habilidad explica la secuencia y el resultado esperado mientras ADK-Rust transmite el progreso del agente a través del entorno de ejecución compartido.

011-2 llamadas

Obtener Direcciones

Indicaciones paso a paso con distancia + duración

021-2 llamadas

Encontrar Cercanos

Búsqueda de POI por categoría + radio

031 llamadas

Matriz de Distancia

Distancias entre todos los pares para múltiples puntos

041 llamadas

Zona Horaria

País + diferencia UTC para cualquier ubicación

051 llamadas

Elevación

Altitud en cualquier coordenada

Límite de herramienta

La habilidad puede usar 7 herramientas documentadas.

Esta lista blanca es declarada por la habilidad. Mantiene al agente enfocado en las acciones necesarias para este trabajo mientras mcp-maps retiene la responsabilidad de autenticación, validación y el sistema conectado.

geocode
reverse_geocode
get_route
get_elevation
search_poi
distance_matrix
get_timezone

Reglas de trabajo

Qué debe hacer el agente.

  • Siempre incluir distancia Y duración en resultados de rutas
  • Especificar modo de transporte (conducción/caminata/ciclismo) — no asumir
  • Incluir unidades (km/millas, minutos/horas)
  • Para búsqueda de POI, especificar radio (no devolver resultados a 50 km)

Límites operativos

Qué debe evitar el agente.

  • No asumir modo de transporte — preguntar si no está claro
  • No devolver coordenadas sin contexto (siempre incluir nombre del lugar)
  • No ignorar límites de tasa (1 req/seg para geocodificación)

Instalar y conectar

Agrega la habilidad junto a la capacidad que espera.

Instala el repositorio donde tu cargador de habilidades ADK-Rust pueda descubrirlo, conecta mcp-maps y confirma que las herramientas declaradas están disponibles antes de pedir al agente que use el flujo de trabajo.

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

La declaración de compatibilidad del repositorio: Requiere servidor mcp-maps conectado (OpenStreetMap, OSRM, OpenTopoData — gratis, sin claves API, sin configuración).

Documentación oficial

Lee el paquete completo de la habilidad.

El repositorio sigue siendo la autoridad para sus instrucciones exactas, ejemplos, scripts auxiliares, recursos, requisitos MCP, licencia y actualizaciones posteriores.

Registro de origen

Metadatos del repositorio para esta entrada de habilidad.

Ver repositorio público ↗
Licencia
Apache-2.0
Herramientas permitidas
7
Referencias
3
Revisión
e709ece01593
Actualizado
31 may 2026