Fundamentación Lite

Experimental: Grounding Lite se encuentra en la etapa experimental (previa a la DG). Los productos y las funciones que se encuentran en la fase previa a la DG pueden tener asistencia limitada, y los cambios en estos productos y funciones podrían no ser compatibles con otras versiones de la fase previa a la DG. Las ofertas que se encuentran en la fase previa a la DG se rigen por las Condiciones Específicas de los Servicios de Google Maps Platform. Para obtener más información, consulta las descripciones de la etapa de lanzamiento. No se aplican cargos por usar Grounding Lite mientras está en la versión experimental.

Google Maps Platform Grounding Lite es un servicio compatible con el Protocolo de contexto del modelo (MCP) que facilita la fundamentación de tus aplicaciones de IA con datos geoespaciales confiables de Google Maps. El servidor de MCP proporciona herramientas que permiten a los LLM acceder a capacidades relacionadas con lugares, clima y rutas. Puedes probar Grounding Lite habilitándolo en cualquier herramienta que admita servidores de MCP.

Herramientas

La fundamentación Lite proporciona herramientas que permiten que los LLM accedan a las siguientes funciones de Google Maps:

• Buscar lugares: Solicita información sobre lugares y obtén resúmenes de datos de lugares generados por IA, así como IDs de lugar, coordenadas de latitud y longitud, y vínculos de Google Maps para cada uno de los lugares incluidos en el resumen. Puedes usar los IDs de lugar y las coordenadas de latitud y longitud que se devuelven con otras APIs de Google Maps Platform para mostrar lugares en un mapa.
• Buscar el clima: Solicita información sobre el clima y muestra las condiciones actuales, los pronósticos por hora y los pronósticos diarios.

• Compute routes: Solicita información sobre rutas en auto o a pie entre dos ubicaciones y devuelve información sobre la distancia y la duración de la ruta.

  Nota: Grounding Lite no proporciona instrucciones paso a paso, información sobre cómo llegar, tráfico en tiempo real ni información de navegación.

Habilitar el servidor de MCP de Maps Grounding Lite permite que los LLM llamen a las nuevas herramientas expuestas por el servidor para devolver información de fundamentación adicional para los tipos de datos mencionados anteriormente. Si bien el LLM puede usar esta información adicional para el contexto, es posible que la respuesta que genere finalmente no incluya la información exacta que devolvió el servidor de MCP. Debes verificar la exactitud de la respuesta generada.

Facturación y cuotas

No se aplican cargos por usar Grounding Lite mientras está en fase experimental. Sin embargo, se aplican las siguientes cuotas a las herramientas que proporciona Grounding Lite:

• Buscar lugares: 100 consultas por minuto y por proyecto 1,000 consultas por día y por proyecto
• Buscar clima: 300 consultas por minuto y por proyecto
• Compute routes: 300 consultas por minuto y por proyecto

Políticas y Condiciones del Servicio

Grounding Lite está sujeto a las Condiciones del Servicio de Google Maps Platform, incluidas las condiciones específicas del servicio para este servicio. En esta sección, se describen los requisitos adicionales de uso del servicio para Grounding Lite, incluidos los LLM compatibles y los requisitos de atribución de la fuente.

Requisitos para los LLM compatibles

Solo puedes usar Grounding Lite con un LLM que cumpla con las Condiciones del Servicio de Google Maps Platform.

Por ejemplo, eres responsable de garantizar que el contenido de Google Maps no se almacene en caché, no se almacene ni se use para mejorar el LLM que elijas usar. Antes de usar Grounding Lite, deberás revisar las Condiciones del Servicio de cualquier modelo que pretendas usar con Grounding Lite. No debes usar Grounding Lite con ningún modelo que utilice los datos ingresados en el modelo para entrenar o mejorar el modelo. Eres responsable de garantizar que tu uso del modelo cumpla plenamente con las restricciones sobre el Contenido de Google Maps en las Condiciones del Servicio de Google Maps Platform, incluidas las condiciones específicas del servicio.

Requisitos de atribución para las fuentes de Google Maps

Cada respuesta de la herramienta de Grounding Lite incluye fuentes. Cuando presentes resultados que usen herramientas proporcionadas por Grounding Lite, debes incluir las fuentes asociadas de Google Maps de una manera que cumpla con los siguientes requisitos:

• Las fuentes de Google Maps deben aparecer inmediatamente después del contenido generado que admiten. Este contenido generado también se conoce como Salida fundamentada.
• Las fuentes de Google Maps deben poder verse en una sola interacción del usuario.

Fuentes de la herramienta Buscar lugares

El campo places de la herramienta search_places proporciona fuentes que respaldan la summary. Para places, se devuelven los siguientes metadatos:

• place (nombre del recurso)
• id
• location
• googleMapsLinks

Para cada lugar, debes generar una vista previa del vínculo que cumpla con estos requisitos:

• Atribuye cada fuente a Google Maps, según los lineamientos de atribución de texto de Grounding Lite.
• Muestra el título de la página fuente de los metadatos de Open Graph og:title del googleMapsLinks proporcionado en la respuesta.
• Vincula la fuente con el places.googleMapsLinks.placeUrl de la respuesta.

Configura los LLM para que usen el servidor de MCP

Para usar Grounding Lite, primero necesitas una clave de API con el servicio de la API de Maps Grounding Lite habilitado. Luego, puedes configurar los LLM para que accedan al servidor de MCP. El servidor de MCP de Grounding Lite usa el transporte HTTP de transmisión.

Crea o configura una clave de API

Puedes usar una clave de API existente con Maps Grounding Lite o crear una nueva, siempre y cuando habilites el servicio de la API de Maps Grounding Lite en la clave. La API de Maps Grounding Lite no genera cargos durante la etapa experimental, pero la facturación debe estar habilitada en el proyecto.

Para habilitar la API, sigue estos pasos:

1. En la consola de Google Cloud, elige el proyecto que deseas usar para Grounding Lite.
2. Habilita la facturación para el proyecto en la consola de Google Cloud.
3. En la navegación superior, abre la terminal de Cloud Shell.

4. Ejecuta los siguientes comandos para habilitar el servicio y el extremo de MCP:

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

5. Sigue los pasos que se indican en Cómo comenzar a usar Google Maps Platform para crear o configurar una clave de API.

Nota: Cuando crees o configures una clave de API, asegúrate de limitar su uso aplicando las restricciones adecuadas. Para obtener más información, consulta Cómo restringir tus claves de API.

La clave de API se debe pasar al servidor de MCP con el encabezado X-Goog-Api-Key. Debes especificarlo como un encabezado HTTP personalizado en la configuración de la herramienta de MCP del LLM.

Configura los LLM para que accedan al servidor de MCP de Grounding Lite

Una vez que tengas una clave de API con el servicio Maps Grounding Lite API habilitado, puedes configurar los LLM para que accedan al servidor de MCP siguiendo la documentación de configuración de MCP correspondiente y usando la URL del servidor de MCP de Grounding Lite: https://mapstools.googleapis.com/mcp

Configura Grounding Lite con Gemini CLI

En esta sección, se proporciona un ejemplo de cómo configurar el servidor de MCP de Grounding Lite con la CLI de Gemini. Para obtener más detalles, consulta Servidores de MCP con la CLI de Gemini.

1. Una vez que instales la CLI de Gemini, podrás usar el comando add para configurar el servidor de MCP de 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 configuración se realizó correctamente, deberías ver una confirmación de que el servidor se agregó a la configuración del usuario.

2. Para validar que el servidor funcione correctamente, ejecuta el comando /mcp list:

   > /mcp list
   
   Configured MCP servers:
   
   maps-grounding-lite-mcp - Ready (3 tools)
   Tools:
   -   compute_routes
   -   lookup_weather
   -   search_places
   

3. Comienza a hacer preguntas relacionadas con Maps con la CLI. Por ejemplo, prueba con "Recomiéndame algunos restaurantes en Mountain View", que debería llamar a la herramienta search_places en tu nombre.

Comparte tus comentarios

Para compartir comentarios sobre Grounding Lite, usa los siguientes formularios:

• Informa un error
• Envía una solicitud de función
• Enviar comentarios