Fundamentación Lite

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 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 devuelve las condiciones actuales, los pronósticos por hora y los pronósticos diarios.

  • Calcular rutas: Solicita información sobre rutas a pie o en automóvil entre dos ubicaciones y devuelve información sobre la distancia y la duración de la ruta.

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.

Prueba la app de ejemplo de Grounding Lite (se abre en una pestaña nueva)

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 los siguientes requisitos:

Configura los LLM para que usen el servidor de MCP

Para usar Grounding Lite, primero necesitas un proyecto de Google Cloud con el servicio de la API de Maps Grounding Lite habilitado, así como una clave de API o un ID de cliente de OAuth. 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.

Habilita el servicio Maps Grounding Lite en tu proyecto de Google Cloud.

Para habilitar la API en tu proyecto, 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

Autentica con 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 el proyecto de Google Cloud y en la clave.

Para autenticarte con una clave de API, haz lo siguiente:

  1. Crea o configura una clave de API siguiendo los pasos que se indican en Cómo comenzar a usar Google Maps Platform.
  2. Pasa la clave 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.

Autentica con OAuth

Para autenticarte con OAuth, crea credenciales de OAuth y pásalas a la aplicación del host o servidor de MCP.

Para autenticarte con OAuth, haz lo siguiente:

  1. En la consola de Google Cloud, elige el proyecto que deseas usar para Grounding Lite.
  2. En el menú APIs y servicios, selecciona Credenciales.
  3. En el menú superior, selecciona Crear credenciales > ID de cliente de OAuth.
  4. Si el proyecto no tiene una pantalla de consentimiento configurada, haz clic en Configurar pantalla de consentimiento y sigue las instrucciones en pantalla.
  5. En la sección Métricas, haz clic en Crear cliente de OAuth.
  6. En la pantalla Crear ID de cliente de OAuth, selecciona un tipo de aplicación y, luego, ingresa un nombre para el ID de cliente.
  7. Especifica los detalles adicionales que son relevantes para tu tipo de solicitud. Por ejemplo, si creas una aplicación web, agrega URIs autorizados para las solicitudes del navegador y del servidor.
  8. Una vez que se cree tu cliente, guarda el ID y el secreto del cliente.
  9. Cuando configures tu host de MCP o la aplicación del servidor de MCP para acceder a Grounding Lite, pasa tu ID de cliente y secreto de OAuth.

Para obtener más información, consulta Usa OAuth 2.0 para acceder a las APIs de Google.

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

Una vez que tengas un proyecto de Google Cloud con el servicio de la API de Maps Grounding Lite habilitado y credenciales válidas, como una clave de API o un ID y un secreto de cliente de OAuth, puedes configurar los LLM para que accedan al servidor de MCP. Para ello, sigue la documentación de configuración de MCP correspondiente y usa la URL del servidor de MCP de Grounding Lite: https://mapstools.googleapis.com/mcp.

Para obtener más información, consulta Cómo configurar MCP en una aplicación de IA.

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: