Embasamento Lite

Experimental: o Grounding Lite está na fase experimental (pré-GA). Os produtos e recursos pré-GA têm suporte limitado, e as mudanças nesses produtos podem não ser compatíveis com outras versões anteriores. As Soluções pré-GA são cobertas pelos Termos de Serviço da Plataforma Google Maps. Para mais informações, consulte as descrições da fase de lançamento. Não há cobrança para usar o Grounding Lite enquanto ele estiver na fase experimental.

O Grounding Lite da Plataforma Google Maps é um serviço com suporte ao Protocolo de Contexto de Modelo (MCP) que facilita o embasamento de aplicativos de IA com dados geoespaciais confiáveis do Google Maps. O servidor MCP oferece ferramentas que permitem que os LLMs acessem recursos de lugares, clima e rotas. Você pode testar o Grounding Lite ativando-o em qualquer ferramenta que ofereça suporte a servidores MCP.

Ferramentas

O Grounding Lite oferece ferramentas que permitem que os LLMs acessem os seguintes recursos do Google Maps:

• Pesquisar lugares: solicite informações sobre lugares e receba resumos de dados de lugares gerados por IA, além de IDs de lugar, coordenadas de latitude e longitude e links do Google Maps para cada um dos lugares incluídos no resumo. Você pode usar os IDs de lugar e as coordenadas de latitude e longitude retornados com outras APIs da Plataforma Google Maps para mostrar lugares em um mapa.
• Consultar clima: solicite informações sobre o clima e retorne as condições atuais, previsões horárias e previsões diárias.

• Calcular rotas: solicite informações sobre rotas de carro ou a pé entre dois locais e retorne informações sobre distância e duração do trajeto.

  **Observação** :o Grounding Lite não fornece rotas passo a passo, instruções, trânsito em tempo real ou informações de navegação.

A ativação do servidor MCP do Maps Grounding Lite permite que os LLMs chamem as novas ferramentas expostas pelo servidor para retornar mais informações de embasamento para os tipos de dados listados acima. Embora o LLM possa usar essas informações adicionais para contexto, a resposta gerada pelo LLM pode não incluir as informações exatas retornadas pelo servidor MCP. Verifique a precisão da resposta gerada.

Testar o app de exemplo do Grounding Lite (abrir em uma nova guia)

Faturamento e cotas

Preços potenciais

Não há cobrança para usar o Grounding Lite enquanto ele estiver na fase experimental.

As tabelas a seguir descrevem uma possível escala de preços para o Maps Grounding Lite se ele passar para a disponibilidade geral (GA). Para mais informações, consulte as descrições da fase de lançamento.

O Grounding Lite também pode ser oferecido nos pacotes "Essentials" e "Pro Subscribe to save ".

Custos listados por 1.000 eventos. Todos os preços em dólares americanos. Os intervalos são para o número de eventos mensais.

Categoria	Nome da SKU	Limite de uso sem custo financeiro	Limite: 100.000	100.001 a 500.000	500.001 a 1.000.000	1.000.001 a 5.000.000	Mais de 5.000.000
Essentials	Grounding Lite	10.000	US$ 7,00	US$ 5,95	US$ 4,90	US$ 3,85	US$ 2,80

Categoria	Nome da SKU	Limite de uso sem custo financeiro	Limite: 5.000.000	Mais de 5.000.000
Essentials	Grounding Lite (Índia)	70.000	US$ 3,85	US$ 2,80

Cotas

As cotas a seguir se aplicam às ferramentas fornecidas pelo Grounding Lite:

• Pesquisar lugares: 100 consultas por minuto por projeto. 1.000 consultas por dia por projeto.
• Consultar clima: 300 consultas por minuto por projeto.
• Calcular rotas: 300 consultas por minuto por projeto.

Políticas e Termos de Serviço

O Grounding Lite está sujeito aos Termos de Serviço da Plataforma Google Maps, incluindo os termos específicos do serviço. Esta seção descreve requisitos de uso de serviço adicional para o Grounding Lite, incluindo LLMs compatíveis e requisitos de atribuição de origem.

Requisitos para LLMs compatíveis

Você só pode usar o Grounding Lite com um LLM que esteja em conformidade com os Termos de Serviço da Plataforma Google Maps.

Por exemplo, você é responsável por garantir que o conteúdo do Google Maps não seja armazenado em cache, armazenado ou usado para melhorar o LLM escolhido. Antes de usar o Grounding Lite, revise os Termos de Serviço de qualquer modelo que você pretende usar com o Grounding Lite. Não use o Grounding Lite com modelos que usam os dados de entrada no modelo para treinamento de modelo ou melhoria. Você é responsável por garantir que o uso do modelo esteja totalmente em conformidade com as restrições de conteúdo do Google Maps nos Termos de Serviço da Plataforma Google Maps, incluindo os termos específicos do serviço.

Requisitos de atribuição para fontes do Google Maps

Cada resposta de ferramenta do Grounding Lite inclui fontes. Ao apresentar resultados que usam ferramentas fornecidas pelo Grounding Lite, inclua as fontes associadas do Google Maps de uma maneira que atenda aos seguintes requisitos:

• As fontes do Google Maps precisam seguir imediatamente o conteúdo gerado que elas oferecem suporte. Esse conteúdo gerado também é chamado de saída embasada.
• As fontes do Google Maps precisam estar visíveis em uma interação do usuário.

Fontes da ferramenta "Pesquisar lugares"

O campo places da ferramenta search_places fornece fontes que oferecem suporte ao summary. Para places, os seguintes metadados são retornados:

• place (nome do recurso)
• id
• location
• googleMapsLinks

Para cada lugar, gere uma visualização de link que atenda a estes requisitos:

• Atribua cada fonte ao Google Maps, seguindo as diretrizes de atribuição de texto do Grounding Lite.
• Vincule à fonte usando o places.googleMapsLinks.placeUrl da resposta.

Configurar LLMs para usar o servidor MCP

Para usar o Grounding Lite, primeiro você precisa de um projeto na nuvem do Google Cloud com o serviço de API Maps Grounding Lite ativado, bem como uma chave de API ou um ID do cliente OAuth. Em seguida, você pode configurar LLMs para acessar o servidor MCP. O servidor MCP do Grounding Lite usa o transporte HTTP transmissível.

Ativar o serviço Maps Grounding Lite no seu projeto na nuvem do Google Cloud

Para ativar a API no seu projeto:

1. No console do Google Cloud, escolha o projeto que você quer usar para o Grounding Lite.
2. Ative o faturamento para o projeto no Google Cloud Console.
3. Ative o Grounding Lite na biblioteca de APIs do console do Google Cloud.

Autenticar usando uma chave de API

Você pode usar uma chave de API atual com o Maps Grounding Lite ou criar uma nova, desde que ative o Maps Grounding Lite serviço de API no projeto do Google Cloud e na chave.

Para autenticar usando uma chave de API:

1. Crie ou configure uma chave de API seguindo as etapas em Introdução à Plataforma Google Maps.
2. Transmita a chave para o servidor MCP usando o cabeçalho X-Goog-Api-Key. É necessário especificar isso como um cabeçalho HTTP personalizado na configuração da ferramenta MCP do LLM.

Observação: ao criar ou configurar uma chave de API, limite o uso da chave aplicando as restrições adequadas. Para mais informações, consulte Restringir suas chaves de API.

Autenticar usando o OAuth

Você pode autenticar usando o OAuth criando credenciais do OAuth e transmitindo-as para o host MCP ou o aplicativo do servidor MCP.

Para autenticar usando o OAuth:

1. No console do Google Cloud, escolha o projeto que você quer usar para o Grounding Lite.
2. No menu APIs e serviços, selecione Credenciais.
3. No menu superior, selecione Criar credenciais > ID do cliente OAuth.
4. Se o projeto não tiver uma tela de permissão configurada, clique em Configurar tela de permissão e siga as instruções na tela.
5. Na seção Métricas, clique em Criar um cliente OAuth.
6. Na tela Criar ID do cliente OAuth, selecione um tipo de aplicativo e insira um nome para o ID do cliente.
7. Especifique os detalhes adicionais relevantes para o tipo de aplicativo. Por exemplo, se você estiver criando um aplicativo da Web, adicione URIs autorizados para solicitações de navegador e servidor.
8. Depois que o cliente for criado, salve o ID e a chave secreta do cliente.
9. Ao configurar o host MCP ou o aplicativo do servidor MCP para acessar o Grounding Lite, transmita o ID e a chave secreta do cliente OAuth. Você também precisa solicitar o seguinte escopo: https://www.googleapis.com/auth/maps-platform.mapstools.

Para mais informações, consulte Como usar o OAuth 2.0 para acessar as APIs do Google.

Configurar LLMs para acessar o servidor MCP do Grounding Lite

Depois de ter um projeto na nuvem do Google Cloud com o serviço API Maps Grounding Lite ativado e credenciais válidas, como uma chave de API ou um ID e uma chave secreta do cliente OAuth, você pode configurar LLMs para acessar o servidor MCP seguindo a documentação de configuração do MCP correspondente e usando o URL do servidor MCP do Grounding Lite: https://mapstools.googleapis.com/mcp

Para mais informações, consulte Configurar o MCP em um aplicativo de IA application.

Configurar o Grounding Lite com a CLI do Gemini

Esta seção fornece um exemplo de como configurar o servidor MCP do Grounding Lite usando a CLI do Gemini. Para mais detalhes, consulte os Servidores MCP com a CLI do Gemini.

1. Depois de instalar a CLI do Gemini, você pode usar o comando "add" para configurar o servidor MCP do 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
   

   Se a configuração for bem-sucedida, você vai receber uma confirmação de que o servidor foi adicionado às configurações do usuário.

2. Para validar se o servidor está funcionando corretamente, execute o comando /mcp list:

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

3. Comece a fazer perguntas relacionadas ao Maps com a CLI. Por exemplo, tente "Recomende alguns restaurantes em Mountain View", que vai chamar a ferramenta search_places em seu nome.

Observação: para informações sobre como configurar uma extensão da CLI do Gemini para acessar o Grounding Lite usando o OAuth, consulte a seção da CLI do Gemini na documentação do MCP no Google Cloud.

Enviar comentários

Para compartilhar feedback sobre o Grounding Lite, use os seguintes formulários:

• Informar um bug
• Enviar uma solicitação de recurso
• Enviar feedback