Maps Grounding Lite

Google Maps Platform Grounding Lite es un servicio con compatibilidad 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 que los LLM accedan a capacidades para lugares, clima y rutas. Puedes probar Maps Grounding Lite habilitándolo en cualquier herramienta que admita servidores de MCP.

Herramientas

Maps Grounding Lite proporciona herramientas que permiten que los LLM accedan a las siguientes capacidades 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 muestran con otras APIs de Google Maps Platform para mostrar lugares en un mapa.
  • Consultar el clima: Solicita información sobre el clima y muestra las condiciones actuales, los pronósticos por hora y los pronósticos diarios.

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

Si habilitas el servidor de MCP de Maps Grounding Lite, los LLM podrán llamar a las nuevas herramientas que expone el servidor para mostrar 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 en última instancia no incluya la información exacta que muestra el servidor de MCP. Debes verificar la exactitud de la respuesta generada.

Probar la app de ejemplo de Maps Grounding Lite (abrir en una pestaña nueva)

Facturación y cuotas

Cómo se te factura

Con el modelo de precios de pago por uso de Google Maps Platform, el uso de Maps Grounding Lite se calcula para cada solicitud, en la que cada solicitud representa un evento de facturación. Se hace un seguimiento del uso de cada producto SKU. En tu factura, se muestra un elemento de una sola línea para cada SKU, además de los cargos totales. Consulta la descripción general de los informes para obtener más información.

Consulta la tabla de precios principal y la tabla de precios de la India para obtener detalles sobre los precios.

Maps Grounding Lite también se ofrece a través de los paquetes Essentials y Pro Subscribe to save.

Cuotas

Se aplican las siguientes cuotas a las herramientas que proporciona Maps Grounding Lite:

  • Buscar lugares: 300 consultas por minuto, por proyecto
  • Consultar el clima: 300 consultas por minuto, por proyecto
  • Calcular rutas: 300 consultas por minuto, por proyecto

Políticas y Condiciones del Servicio

Maps 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 Maps Grounding Lite, incluidos los LLM compatibles y los requisitos de atribución de fuentes.

Requisitos para LLM compatibles

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

Por ejemplo, eres responsable de asegurarte de que el LLM que elijas usar no almacene en caché, almacene ni use el contenido de Google Maps para mejorarlo. Antes de usar Maps Grounding Lite, deberás revisar las Condiciones del Servicio de cualquier modelo que pretendas usar con Maps Grounding Lite. No debes usar Maps Grounding Lite con ningún modelo que use los datos ingresados en el modelo para el entrenamiento o la mejora de modelos. Eres responsable de asegurarte de que tu uso del modelo cumpla por completo 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 Maps Grounding Lite incluye fuentes. Cuando presentes resultados que usen herramientas proporcionadas por Maps Grounding Lite, debes incluir las fuentes de Google Maps asociadas de una manera que cumpla con los siguientes requisitos:

  • Las fuentes de Google Maps deben seguir inmediatamente al contenido generado que admiten las fuentes. Este contenido generado también se conoce como salida fundamentada.
  • Las fuentes de Google Maps deben poder verse en una interacción del usuario.

Fuentes para la herramienta Buscar lugares

El campo places de la herramienta search_places proporciona fuentes que admiten el summary. Para places, se muestra 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:

Configura LLM para usar el servidor de MCP

Para usar Maps Grounding Lite, primero necesitas un proyecto de Google Cloud con el servicio de API de Maps Grounding Lite habilitado, así como una clave de API o un ID de cliente de OAuth. Luego, puedes configurar LLM para acceder al servidor de MCP. El servidor de MCP de Grounding Lite usa el transporte HTTP transmitible.

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

Para habilitar la API en tu proyecto, haz lo siguiente:

  1. En la consola de Google Cloud, elige el proyecto que quieres usar para Maps Grounding Lite.
  2. Habilita la facturación para el proyecto en la Google Cloud Console.
  3. Habilita Maps Grounding Lite en la consola de Google Cloud biblioteca de API.

Autentica con una clave de API

Puedes usar una clave de API existente con Maps Grounding Lite o crear una nueva siempre que habilites el servicio de API deMaps Grounding Lite en el proyecto de Google Cloud y en la clave.

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

  1. Crea o configura una clave de API siguiendo los pasos que se indican en Comienza 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

Puedes autenticarte con OAuth creando credenciales de OAuth y pasándolas a la aplicación de host de MCP o servidor de MCP.

Para autenticar con OAuth, haz lo siguiente:

  1. En la consola de Google Cloud, elige el proyecto que quieres usar para Maps 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 sean pertinentes para tu tipo de aplicación. Por ejemplo, si creas una aplicación web, agrega URIs autorizadas para solicitudes del navegador y del servidor.
  8. Una vez que se cree tu cliente, guarda el ID de cliente y el secreto.
  9. Cuando configures tu aplicación de host de MCP o servidor de MCP para acceder a Maps Grounding Lite, pasa tu ID de cliente y secreto de OAuth. También debes solicitar el siguiente alcance: https://www.googleapis.com/auth/maps-platform.mapstools.

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

Configura LLM para acceder al servidor de MCP de Maps Grounding Lite

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

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

Configura Maps Grounding Lite con la CLI de Gemini

En esta sección, se proporciona un ejemplo de cómo configurar el servidor de MCP de Maps Grounding Lite con la CLI de Gemini. Para obtener más detalles, consulta los 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 de 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 Maps Grounding Lite, usa los siguientes formularios: