Ancrage Lite

Google Maps Platform Grounding Lite est un service compatible avec le protocole de contexte de modèle (MCP, Model Context Protocol) qui permet d'ancrer facilement vos applications d'IA avec des données géospatiales fiables provenant de Google Maps. Le serveur MCP fournit des outils qui permettent aux LLM d'accéder aux fonctionnalités liées aux lieux, à la météo et aux itinéraires. Vous pouvez essayer Grounding Lite en l'activant dans n'importe quel outil compatible avec les serveurs MCP.

Outils

Grounding Lite fournit des outils qui permettent aux LLM d'accéder aux fonctionnalités Google Maps suivantes :

  • Rechercher des lieux : demandez des informations sur des lieux et obtenez des résumés de données générés par IA, ainsi que des ID de lieux, des coordonnées de latitude et de longitude, et des liens Google Maps pour chacun des lieux inclus dans le résumé. Vous pouvez utiliser les ID de lieu et les coordonnées de latitude et de longitude renvoyés avec d'autres API Google Maps Platform pour afficher des lieux sur une carte.
  • Rechercher la météo : demander des informations sur la météo et obtenir les conditions actuelles, les prévisions horaires et les prévisions quotidiennes.

  • Calculer des itinéraires : demandez des informations sur les itinéraires en voiture ou à pied entre deux lieux, et obtenez des informations sur la distance et la durée de l'itinéraire.

L'activation du serveur MCP Maps Grounding Lite permet aux LLM d'appeler les nouveaux outils exposés par le serveur pour renvoyer des informations d'ancrage supplémentaires pour les types de données listés ci-dessus. Bien que le LLM puisse utiliser ces informations supplémentaires pour le contexte, la réponse qu'il génère finalement peut ne pas inclure les informations exactes renvoyées par le serveur MCP. Vous devez vérifier l'exactitude de la réponse générée.

Essayer l'application exemple Grounding Lite (ouvrir dans un nouvel onglet)

Facturation et quotas

L'utilisation de Grounding Lite est sans frais pendant la phase expérimentale. Toutefois, les quotas suivants s'appliquent aux outils fournis par Grounding Lite :

  • Rechercher des lieux : 100 requêtes par minute et par projet. 1 000 requêtes par jour et par projet.
  • Rechercher la météo : 300 requêtes par minute et par projet.
  • Calculer des itinéraires : 300 requêtes par minute et par projet.

Règles et conditions d'utilisation

Grounding Lite est soumis aux Conditions d'utilisation de Google Maps Platform, y compris les Conditions spécifiques du service pour ce service. Cette section décrit les exigences supplémentaires concernant l'utilisation du service Grounding Lite, y compris les LLM compatibles et les exigences relatives à l'attribution des sources.

Exigences concernant les LLM compatibles

Vous ne pouvez utiliser Grounding Lite qu'avec un LLM conforme aux conditions d'utilisation de Google Maps Platform.

Par exemple, vous êtes responsable de vous assurer que le contenu Google Maps n'est pas mis en cache, stocké ou utilisé pour améliorer le LLM que vous choisissez d'utiliser. Avant d'utiliser Grounding Lite, vous devez consulter les conditions d'utilisation de tous les modèles que vous prévoyez d'utiliser avec Grounding Lite. Vous ne devez pas utiliser Grounding Lite avec des modèles qui utilisent les données saisies dans le modèle pour l'entraînement ou l'amélioration du modèle. Vous êtes responsable de l'utilisation du modèle et devez vous assurer qu'elle respecte pleinement les restrictions concernant le contenu Google Maps dans les conditions d'utilisation de Google Maps Platform, y compris les conditions spécifiques au service.

Exigences d'attribution pour les sources Google Maps

Chaque réponse d'outil de Grounding Lite inclut des sources. Lorsque vous présentez des résultats qui utilisent des outils fournis par Grounding Lite, vous devez inclure les sources Google Maps associées de manière à respecter les exigences suivantes :

  • Les sources Google Maps doivent suivre immédiatement le contenu généré qu'elles soutiennent. Ce contenu généré est également appelé sortie ancrée.
  • Les sources Google Maps doivent être visibles en une seule interaction utilisateur.

Sources de l'outil Rechercher des lieux

Le champ places de l'outil search_places fournit des sources qui étayent summary. Pour places, les métadonnées suivantes sont renvoyées :

  • place (nom de la ressource)
  • id
  • location
  • googleMapsLinks

Pour chaque lieu, vous devez générer un aperçu du lien qui répond aux exigences suivantes :

Configurer les LLM pour qu'ils utilisent le serveur MCP

Pour utiliser Grounding Lite, vous devez d'abord disposer d'un projet Google Cloud avec le service d'API Maps Grounding Lite activé, ainsi que d'une clé API ou d'un ID client OAuth. Vous pouvez ensuite configurer les LLM pour qu'ils accèdent au serveur MCP. Le serveur MCP Grounding Lite utilise le transport HTTP Streamable.

Activez le service Maps Grounding Lite dans votre projet Google Cloud.

Pour activer l'API dans votre projet :

  1. Dans la console Google Cloud, sélectionnez le projet que vous souhaitez utiliser pour Grounding Lite.
  2. Activez la facturation pour le projet dans la console Google Cloud.
  3. Dans la barre de navigation supérieure, ouvrez le terminal Cloud Shell.

  4. Exécutez les commandes suivantes pour activer le service et le point de terminaison MCP :

    gcloud beta services enable mapstools.googleapis.com --project=PROJECT_ID
gcloud beta services mcp enable mapstools.googleapis.com --project=PROJECT_ID

S'authentifier à l'aide d'une clé API

Vous pouvez utiliser une clé API existante avec Maps Grounding Lite ou en créer une, à condition d'activer le service de l'API Maps Grounding Lite à la fois sur le projet Google Cloud et sur la clé.

Pour vous authentifier à l'aide d'une clé API :

  1. Créez ou configurez une clé API en suivant les étapes de Premiers pas avec Google Maps Platform.
  2. Transmettez la clé au serveur MCP à l'aide de l'en-tête X-Goog-Api-Key. Vous devez le spécifier en tant qu'en-tête HTTP personnalisé dans la configuration de l'outil MCP du LLM.

S'authentifier à l'aide d'OAuth

Vous pouvez vous authentifier à l'aide d'OAuth en créant des identifiants OAuth et en les transmettant à l'hôte MCP ou à l'application serveur MCP.

Pour vous authentifier à l'aide d'OAuth :

  1. Dans la console Google Cloud, sélectionnez le projet que vous souhaitez utiliser pour Grounding Lite.
  2. Dans le menu API et services, sélectionnez Identifiants.
  3. Dans le menu du haut, sélectionnez Créer des identifiants > ID client OAuth.
  4. Si l'écran de consentement n'est pas configuré pour le projet, cliquez sur Configurer l'écran de consentement et suivez les instructions à l'écran.
  5. Dans la section Métriques, cliquez sur Créer un client OAuth.
  6. Sur l'écran Créer un ID client OAuth, sélectionnez un type d'application et saisissez un nom pour l'ID client.
  7. Spécifiez les informations supplémentaires qui concernent votre type d'application. Par exemple, si vous créez une application Web, ajoutez des URI autorisés pour les requêtes de navigateur et de serveur.
  8. Une fois votre client créé, enregistrez l'ID client et le code secret.
  9. Lorsque vous configurez votre hôte MCP ou votre application serveur MCP pour accéder à Grounding Lite, transmettez votre ID client et votre code secret OAuth.

Pour en savoir plus, consultez Utiliser OAuth 2.0 pour accéder aux API Google.

Configurer les LLM pour accéder au serveur MCP Grounding Lite

Une fois que vous disposez d'un projet Google Cloud avec le service Maps Grounding Lite API activé et des identifiants valides, tels qu'une clé API ou un ID et un secret de client OAuth, vous pouvez configurer les LLM pour accéder au serveur MCP en suivant la documentation de configuration MCP correspondante et en utilisant l'URL du serveur MCP Grounding Lite : https://mapstools.googleapis.com/mcp.

Pour en savoir plus, consultez Configurer MCP dans une application d'IA.

Configurer Grounding Lite avec la CLI Gemini

Cette section fournit un exemple de configuration du serveur MCP Grounding Lite à l'aide de la CLI Gemini. Pour en savoir plus, consultez Serveurs MCP avec l'interface de ligne de commande Gemini.

  1. Une fois la CLI Gemini installée, vous pouvez utiliser la commande "add" pour configurer le serveur MCP Maps Grounding Lite :

    gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp

    Si la configuration a réussi, une confirmation indiquant que le serveur a été ajouté à vos paramètres utilisateur devrait s'afficher.

  2. Pour vérifier que le serveur fonctionne correctement, exécutez la commande /mcp list :

    > /mcp list

Configured MCP servers:

maps-grounding-lite-mcp - Ready (3 tools)
Tools:
-   compute_routes
-   lookup_weather
-   search_places

  3. Commencez à poser des questions sur Maps avec la CLI. Par exemple, essayez "Recommande-moi des restaurants à Mountain View", qui devrait appeler l'outil search_places en votre nom.

Envoyer des commentaires

Pour partager vos commentaires sur Grounding Lite, utilisez les formulaires suivants :