Esta página foi traduzida pela API Cloud Translation.

Embasamento Lite

O Grounding Lite da Plataforma Google Maps é um serviço com suporte ao protocolo de contexto de modelo (MCP, na sigla em inglês) que facilita o embasamento dos seus aplicativos de IA com dados geoespaciais confiáveis do Google Maps. O servidor MCP oferece ferramentas que permitem que os LLMs acessem recursos para 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 LLMs acessem os seguintes recursos do Google Maps:

Pesquisar lugares: solicite informações sobre lugares e receba resumos de dados gerados por IA, além de IDs de lugares, 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.
Pesquisar clima: solicite informações sobre o clima e retorne as condições atuais, previsões por hora 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 oferece rotas, direções, trânsito em tempo real ou informações de navegação detalhadas
.

Ao ativar o servidor MCP do Maps Grounding Lite, os LLMs podem chamar 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 por ele pode não incluir as informações exatas retornadas pelo servidor MCP. Verifique a precisão da resposta gerada.

Faturamento e cotas

Não há cobrança pelo uso do Grounding Lite enquanto ele estiver em fase experimental. No entanto, as seguintes cotas se aplicam às ferramentas fornecidas pelo Grounding Lite:

Pesquisar lugares: 100 consultas por minuto, por projeto. 1.000 consultas por dia, por projeto.
Pesquisar clima: 300 consultas por minuto, por projeto.
Rotas de computação: 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. Nesta seção, descrevemos outros requisitos de uso do serviço para o Grounding Lite, incluindo LLMs compatíveis e requisitos de atribuição de fonte.

Requisitos para LLMs compatíveis

Só é possível 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 ele. Não use o Grounding Lite com modelos que usam os dados inseridos para treinamento ou melhoria. Você é responsável por garantir que o uso do modelo esteja em total 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 da ferramenta do Grounding Lite inclui fontes. Ao apresentar resultados que usam ferramentas fornecidas pelo Grounding Lite, você precisa incluir as fontes associadas do Google Maps de uma forma que atenda aos seguintes requisitos:

As fontes do Google Maps precisam aparecer imediatamente após o conteúdo gerado que elas embasam. 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 apoiam o summary. Para places, os seguintes metadados são retornados:

place (nome do recurso)
id
location
googleMapsLinks

Para cada lugar, gere uma prévia de link que atenda a estes requisitos:

Atribua cada fonte ao Google Maps, seguindo as diretrizes de atribuição de texto do Grounding Lite.
Mostre o título da página de origem dos metadados og:title do Open Graph do googleMapsLinks fornecido na resposta.
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 uma chave de API com o serviço da API Maps Grounding Lite ativado. Em seguida, é possível configurar LLMs para acessar o servidor MCP. O servidor MCP do Grounding Lite usa transporte HTTP transmitível.

Criar ou configurar 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 serviço da API Maps Grounding Lite na chave. A API Maps Grounding Lite não cobra durante o período experimental, mas o faturamento precisa estar ativado no projeto.

Para ativar a API:

No console do Google Cloud, escolha o projeto que você quer usar para o Grounding Lite.
Ative o faturamento para o projeto no Console do Google Cloud.
Na navegação superior, abra o terminal do Cloud Shell.

Execute os comandos a seguir para ativar o serviço e o endpoint do MCP:

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

Siga as etapas em Como começar a usar a Plataforma Google Maps para criar ou configurar uma chave de API.

A chave de API precisa ser transmitida ao servidor MCP usando o cabeçalho X-Goog-Api-Key. Você precisa especificar isso como um cabeçalho HTTP personalizado na configuração da ferramenta MCP do LLM.

Configurar LLMs para acessar o servidor MCP do Grounding Lite

Depois de ter uma chave de API com o serviço API Maps Grounding Lite ativado, você pode configurar LLMs para acessar o servidor MCP seguindo a documentação de configuração correspondente e usando o URL do servidor MCP do Grounding Lite: https://mapstools.googleapis.com/mcp

Configurar o Grounding Lite com a CLI do Gemini

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

Depois de instalar a CLI do Gemini, use 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.

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

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

Enviar comentários

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