Cette page a été traduite par l'API Cloud Translation.

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, ainsi que 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 : demandez des informations sur la météo et obtenez les conditions actuelles, les prévisions horaires et les prévisions quotidiennes.
Compute Routes : demandez des informations sur les itinéraires en voiture ou à pied entre deux lieux, et renvoyez des informations sur la distance et la durée de l'itinéraire.

Remarque : Grounding Lite ne fournit pas d'itinéraires détaillés, d'instructions, d'informations sur le trafic en temps réel ni d'informations de navigation.

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.

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 prennent en charge. 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 :

Attribuez chaque source à Google Maps, en suivant les consignes d'attribution de texte Grounding Lite.
Affichez le titre de la page source à partir des métadonnées Open Graph og:title du googleMapsLinks fourni dans la réponse.
Associez la source à l'aide de places.googleMapsLinks.placeUrl dans la réponse.

Configurer les LLM pour qu'ils utilisent le serveur MCP

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

Créer ou configurer une clé API

Vous pouvez utiliser une clé API existante avec Maps Grounding Lite ou en créer une, à condition d'activer le service d'API Maps Grounding Lite sur la clé. L'API Maps Grounding Lite n'est pas facturée pendant la phase expérimentale, mais la facturation doit être activée dans le projet.

Pour activer l'API, utilisez la commande suivante :

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

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

Suivez les étapes de la section Premiers pas avec Google Maps Platform pour créer ou configurer une clé API.

La clé API doit être transmise au serveur MCP à l'aide de l'en-tête X-Goog-Api-Key. Vous devez spécifier cet élément en tant qu'en-tête HTTP personnalisé dans la configuration de l'outil MCP du LLM.

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

Une fois que vous disposez d'une clé API avec le service Maps Grounding Lite API activé, 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.

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.

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.

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

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 :