Registre des compétences
Communication et connaissanceCompétences publiques

Maps & Geolocation

Intelligence de localisation pour agents IA — géocodage, itinéraires avec instructions détaillées, découverte de POI, élévation, matrices de distances, et recherche de fuseau horaire. Zéro configuration, gratuit, couverture mondiale via OpenStreetMap.

Ce que cette compétence enseigne

Un guide réutilisable pour un type de travail spécifique.

Un serveur MCP indique à un agent quelles actions sont disponibles. Une compétence ajoute le jugement autour de ces actions : comment reconnaître la tâche, quelle séquence suivre, quoi éviter, et comment décider que le résultat est complet.

Orchestrez les opérations de géolocalisation — géocodez des adresses, calculez des itinéraires avec indications détaillées, trouvez des points d'intérêt, obtenez des données d'altitude, calculez des matrices de distances et déterminez les fuseaux horaires. Utilisez lors de la conversion d'adresses en coordonnées, l'obtention d'itinéraires, la recherche de lieux à proximité, le calcul de distances…

Architecture

Comment Maps & Geolocation guide un agent ADK-Rust.

La compétence reste lisible et portable car elle contient des instructions plutôt que des identifiants de service ou des données métier. ADK-Rust la fournit à l'agent, l'agent choisit dans sa limite d'outil examinée, et le serveur MCP connecté exécute l'opération authentifiée.

01

Requête utilisateur

L'agent reçoit un objectif exprimé en langage courant.

02

Compétence Maps & Geolocation

Correspond à l'intention, fournit le guide de décision, et restreint la limite d'outil.

03

Agent ADK-Rust

Planifie le flux de travail et diffuse chaque étape significative via le runtime.

04

mcp-maps

Exécute des opérations authentifiées contre le système propriétaire de la capacité.

05

Résultat vérifié

Les règles de complétion de la compétence façonnent les preuves retournées à l'utilisateur.

Instructions portables : SKILL.md · Limite de capacité : mcp-maps · Outils autorisés : 7

Guide de décision

Comment l'agent transforme une requête en action appropriée.

Ces routes proviennent directement des instructions de la compétence. Elles aident le modèle à reconnaître l'intention et à sélectionner un outil ou un flux de travail ciblé au lieu d'improviser sur toute la surface de capacité.

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

Flux de travail éprouvés

Séquences répétables pour des résultats utiles.

Un flux de travail regroupe plusieurs appels d'outils en une tâche que l'utilisateur reconnaît réellement. La compétence explique la séquence et le résultat attendu tandis qu'ADK-Rust diffuse la progression de l'agent via le runtime partagé.

011-2 appels

Obtenir un itinéraire

Instructions détaillées avec distance + durée

021-2 appels

Trouver à proximité

Recherche de POI par catégorie + rayon

031 appels

Matrice de distances

Distances entre tous les points

041 appels

Fuseau horaire

Pays + décalage UTC pour toute localisation

051 appels

Altitude

Altitude à toute coordonnée

Limite d'outil

La compétence peut utiliser 7 outils documentés.

Cette liste blanche est déclarée par la compétence. Elle maintient l'agent concentré sur les actions nécessaires pour ce travail tandis que mcp-maps conserve la responsabilité de l'authentification, de la validation et du système connecté.

geocode
reverse_geocode
get_route
get_elevation
search_poi
distance_matrix
get_timezone

Règles de travail

Ce que l'agent doit faire.

  • Inclure toujours la distance ET la durée dans les résultats d'itinéraire
  • Spécifier le mode de transport (voiture/marche/vélo) — ne pas supposer
  • Inclure les unités (km/miles, minutes/heures)
  • Pour la recherche de POI, spécifier un rayon (ne pas retourner des résultats à 50 km)

Limites opérationnelles

Ce que l'agent doit éviter.

  • Ne pas supposer le mode de transport — demander si incertain
  • Ne pas retourner des coordonnées sans contexte (toujours inclure le nom du lieu)
  • Ne pas ignorer les limites de requêtes (1 req/sec pour géocodage)

Installer et connecter

Ajoutez la compétence à côté de la capacité qu'elle attend.

Installez le dépôt où votre chargeur de compétences ADK-Rust peut le découvrir, connectez mcp-maps, et confirmez que les outils déclarés sont disponibles avant de demander à l'agent d'utiliser le flux de travail.

Installer la compétence
git clone https://github.com/zavora-ai/skill-maps-geolocation.git \
  ~/.skills/skills/maps-geolocation
Forme de chargement 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 déclaration de compatibilité du dépôt : Nécessite un serveur mcp-maps connecté (OpenStreetMap, OSRM, OpenTopoData — gratuit, sans clés API, zéro configuration).

Documentation officielle

Lisez le package complet de la compétence.

Le dépôt reste la référence pour ses instructions exactes, exemples, scripts d'aide, ressources, exigences MCP, licence et mises à jour ultérieures.

Enregistrement source

Métadonnées du dépôt pour cette entrée de compétence.

Voir le dépôt public ↗
Licence
Apache-2.0
Outils autorisés
7
Références
3
Révision
e709ece01593
Mis à jour
31 mai 2026