Use mais recursos das ferramentas de agente da Experiência de Experimentos do Maps com a SKU Pro. Entre em contato com a equipe de vendas para ter acesso.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Ferramentas do agente de Experimentos do Maps

As ferramentas de agente do Maps Experience (antigo Maps Grounding Lite) são um serviço da Plataforma Google Maps com suporte ao Protocolo de Contexto de Modelo (MCP, na sigla em inglês) para embasar seus aplicativos de IA com dados geoespaciais confiáveis do Google Maps. O servidor MCP oferece ferramentas que permitem que os LLMs acessem dados de lugares, clima e rotas. Outras ferramentas resolvem nomes de locais e URLs do Google Maps para IDs de lugar. Para testar as ferramentas de agente dos Experimentos do Maps, ative-as em qualquer ferramenta que ofereça suporte a servidores MCP.

As ferramentas de agente da Experiência do Maps são um produto com duas SKUs: Essentials e Pro. Cada solicitação é faturada de acordo com o Essentials, a menos que use uma opção Pro. As opções Pro adicionam detalhes de lugares estendidos, mais lugares por pesquisa, mais paradas intermediárias por rota e rotas com trânsito em tempo real. Durante a GA restrita, as opções Pro estão disponíveis apenas para projetos na lista de permissões do Pro. As duas SKUs usam o mesmo servidor MCP, ferramentas e credenciais. Para mais detalhes, consulte Essentials e Pro.

Ferramentas

As ferramentas de agente dos Experimentos do Maps permitem que os LLMs acessem os seguintes recursos do Google Maps:

Pesquisar lugares: solicite informações sobre lugares e receba resumos gerados com IA. A resposta também inclui IDs de lugar, coordenadas e links do Google Maps para cada lugar no resumo. Você pode usar os IDs de lugar e as coordenadas com outras APIs da Plataforma Google Maps para mostrar lugares em um mapa. Com o Pro, é possível solicitar detalhes estendidos de lugares, como insights de avaliações, e até 10 lugares por solicitação.
Consultar o 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 uma rota entre uma origem e um destino, opcionalmente com paradas intermediárias, e retorne a distância e a duração do trajeto. Com o Pro, as rotas podem considerar as condições de trânsito em tempo real e incluir mais paradas intermediárias.

Observação: as ferramentas do agente dos Experimentos do Maps não fornecem rotas guiadas nem informações de navegação. As rotas calculadas sem as opções Pro não consideram o trânsito em tempo real.
Resolver nomes e Resolver URLs do Maps: resolva nomes de locais, endereços e URLs do Google Maps para IDs de lugar. Para mais informações, consulte API Resolution.

Depois que você ativar o servidor MCP, os LLMs poderão chamar as ferramentas dele para receber informações de embasamento para esses tipos de dados. O LLM pode usar essas informações como contexto. No entanto, a resposta final pode não incluir as informações exatas que o servidor MCP retornou. Verifique se a resposta gerada está correta.

Essentials e Pro

O Essentials e o Pro são duas SKUs do mesmo produto, não produtos ou planos separados. Uma solicitação é faturada no Pro quando usa uma opção do Pro. Todas as outras solicitações são faturadas no Essentials. As opções Pro são campos comuns na solicitação da ferramenta, então um LLM pode usá-las em seu nome. Um agente também pode usar as duas SKUs na mesma conversa. Por exemplo, um agente pode usar o Essentials para encontrar cafeterias perto de um ponto de referência. Em seguida, ele pode usar o Pro para responder a uma pergunta complementar sobre as bebidas exclusivas e os assentos. Não há um servidor, endpoint ou credencial MCP separado para o Pro.

Comparar o Essentials, o Pro e o embasamento com o Google Maps

O embasamento com o Google Maps é um produto separado. Ele está integrado aos modelos do Gemini na API Gemini, no Google AI Studio e na Gemini Enterprise Agent Platform. O modelo decide quando consultar o Google Maps e retorna respostas embasadas com citações. Escolha o embasamento com o Google Maps ao criar no Gemini e quiser que o modelo lide com o embasamento. Escolha as ferramentas de agente dos Experimentos do Maps para outros modelos ou frameworks de agente ou para controle direto de cada chamada de ferramenta.

	Ferramentas do agente de Experimentos do Maps		Embasamento com o Google Maps
	SKU Essentials (antigo Maps Grounding Lite)	SKU do Pro	Embasamento com o Google Maps
Como as solicitações são faturadas	Cada solicitação de ferramenta que não usa uma opção Pro	Cada solicitação de ferramenta que usa uma opção Pro: `include_extended_details`, um `page_size` acima de 5, `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL` ou mais de 10 waypoints intermediários	Cada consulta do Google Maps ou comando fundamentado, dependendo da plataforma e do modelo
Modelos e plataformas	Qualquer modelo ou framework de agente que ofereça suporte ao MCP. Um servidor MCP, um conjunto de ferramentas e as mesmas credenciais para as duas SKUs		Modelos do Gemini na API Gemini, no Google AI Studio e na Gemini Enterprise Agent Platform
O que as ferramentas retornam	Fatos principais: detalhes de até cinco lugares por pesquisa, distância e duração do trajeto sem trânsito em tempo real, além do clima atual e das previsões	Tudo o que está incluído no Essentials, além de detalhes estendidos de lugares (como insights de avaliações), até 10 lugares por pesquisa, rotas com trânsito em tempo real e até 25 waypoints intermediários	Place Details e insights de avaliações e informações de rota com trânsito em tempo real
Exemplos de solicitação	Perguntas factuais e logísticas: encontrar lojas ou empresas, horários de funcionamento, endereços e estimativas de distância ou tempo de viagem	Perguntas subjetivas ou amplas: atmosfera, pratos exclusivos, dicas para visitantes, comparações de 6 a 10 lugares e tempos de viagem no trânsito atual	Pesquisa conversacional, planejamento de itinerários e descoberta local no Gemini
Visualizações do Kit de Interface do Places	Incluído sem custo financeiro adicional com o token de visualização de dados agêntica (pré-lançamento)		Faturados separadamente
Uso sem custo financeiro por mês	10.000 solicitações	5.000 solicitações	Depende da plataforma e do modelo. Por exemplo, na API Gemini, o Gemini 3 e os modelos mais recentes incluem 5.000 consultas de pesquisa sem custo financeiro por mês. Depois disso, as consultas de pesquisa custam US $14 por mil.
Preço de pagamento por uso	US$ 7,00 por 1.000 solicitações, com descontos por volume	US$ 14,00 por 1.000 solicitações. Entre em contato com a equipe de vendas para saber os preços por volume.
Assine para economizar	Incluído nos planos Essentials e Pro	Não incluso	Indisponível
Primeiros passos	Uma configuração para as duas SKUs: consulte Configurar LLMs para usar o servidor MCP. Durante a GA restrita, as opções Pro também exigem um projeto na lista de permissões do Pro.		API Gemini ou Agent Platform

Essas opções funcionam da mesma forma com qualquer SKU: meios de transporte, horários de partida e chegada, rotas alternativas, polilinhas de rota, consultas meteorológicas e a API Resolution. Elas não mudam a SKU em que uma solicitação é faturada.

O que é faturado na SKU Pro

Ferramenta	Capacidade	Essentials	Pro
Pesquisar lugares	Lugares por solicitação	Até 5	6 a 10 (`page_size` de 6 a 10)
Pesquisar lugares	Detalhes estendidos do lugar nos resumos da pesquisa (insights de avaliações, destaques do menu, atmosfera, movimentação do lugar, dicas de visitantes e distância ou tempo de viagem para consultas de proximidade)	Indisponível	Disponível com `include_extended_details`
Calcular rotas	Preferência de roteamento	Não considera o trânsito em tempo real	Considera o trânsito em tempo real ou os dados de transporte público em tempo real para rotas de transporte público, com `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL`
Calcular rotas	Waypoints intermediários por trajeto	Até 10	11 a 25 (mais de 10 `intermediate_waypoints`)
API Lookup Weather e API Resolution	Não há opções do Pro. Todas as solicitações são cobradas de acordo com a SKU Essentials.

Para ver as opções de solicitação que ativam cada recurso, consulte Pesquisar lugares e Calcular rotas.

Opções do Pro durante a GA restrita

Durante a GA restrita, as opções Pro estão disponíveis apenas para projetos na nuvem do Google Cloud na lista de permissões Pro. Entre em contato com a equipe de vendas para solicitar acesso. Depois que um projeto estiver na lista de permissões, todas as chaves de API e clientes OAuth nele poderão usar as opções Pro.

Se o projeto ainda não estiver na lista de permissões, as solicitações que usam as opções Pro serão processadas da seguinte maneira:

Pesquisar lugares: include_extended_details é ignorado, e a resposta contém no máximo 5 lugares, mesmo que você defina page_size como um valor maior. A solicitação é faturada de acordo com a SKU Essentials.
Compute Routes: ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL é tratado como ROUTING_PREFERENCE_TRAFFIC_UNAWARE, e a solicitação é faturada com a SKU Essentials. Uma solicitação com mais de 10 waypoints intermediários retorna um erro INVALID_ARGUMENT.

Para verificar se o projeto está na lista de permissões, envie uma solicitação search_places com page_size definido como 10. Use uma consulta ampla, como restaurants in Chicago. Um projeto na lista de permissões pode retornar mais de 5 lugares, faturados com a SKU Pro. Outros projetos retornam no máximo 5 lugares.

Controlar o uso do Pro

As opções Pro ficam desativadas por padrão. Um LLM os define quando a solicitação do usuário os exige e o esquema da ferramenta ou suas instruções permitem. O esquema da ferramenta descreve valores de page_size até 5 e no máximo 10 waypoints intermediários. Portanto, os modelos só usam os limites mais altos do Pro quando suas instruções pedem isso. Para gerenciar custos:

Informe ao modelo quando as opções Pro são adequadas. Por exemplo: "Defina include_extended_details apenas quando o usuário perguntar sobre avaliações, cardápios ou ambiente". Ou: "Use ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL somente quando o usuário pedir o tempo de viagem atual".
Para manter um agente na SKU Essentials, instrua o modelo a nunca usar uma opção Pro. As opções Pro são include_extended_details, page_size acima de 5, ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL e mais de 10 pontos intermediários. Se o cliente do MCP puder restringir os argumentos da ferramenta, você também poderá bloquear esses valores na configuração da ferramenta.
Monitore o uso nos relatórios de faturamento e defina alertas de orçamento.

API Resolution

As ferramentas de agente da Experiência do Maps oferecem a API Resolution. Ela resolve textos de localização de formato livre e URLs para identificadores de lugar estruturados do Google Maps. A API Resolution está disponível como métodos REST e como ferramentas no servidor MCP:

Resolver nomes (REST, MCP): resolve um lote de nomes ou endereços de locais para entidades de lugares específicos no Google Maps. Isso é útil para embasar consultas de usuários não estruturadas em IDs de lugar estáveis.
Resolver URLs do Maps (REST, MCP): resolve um lote de URLs do Google Maps para entidades de lugar específicas. Os formatos aceitos incluem URLs de lugares padrão e URLs encurtados.

Você pode usar os IDs de lugar retornados com outras APIs da Plataforma Google Maps. Cada resposta também inclui um link que salva os lugares resolvidos como uma lista no Google Maps.

Para mais informações, consulte a API Maps Tools Resolution.

Teste o app de exemplo (abre em uma nova guia)

Faturamento e cotas

Como a cobrança é feita

Com o modelo de pagamento por uso da Plataforma Google Maps, o uso das ferramentas do agente da Experiência do Maps é calculado para cada solicitação. Cada solicitação representa um evento de faturamento. O uso de cada SKU de produto é rastreado. A fatura mostra um item de linha para cada SKU, além das cobranças totais. Consulte a Visão geral dos relatórios para mais informações.

Cada solicitação de pesquisa de lugares, cálculo de rotas ou consulta de clima é faturada em exatamente uma SKU, Essentials ou Pro. Uma solicitação que usa qualquer opção Pro é faturada com a SKU Pro. Ele nunca é faturado com as duas SKUs, e o número de opções do Pro não muda a cobrança. As seguintes opções determinam a SKU:

Ferramenta	Essentials	Pro
`search_places`	Qualquer solicitação sem uma opção Pro: `page_size` de 5 ou menos e `include_extended_details` não definido ou `false`	`include_extended_details` definido como `true` ou `page_size` de 6 a 10
`compute_routes`	Qualquer solicitação sem uma opção Pro: `routing_preference` não definido ou `ROUTING_PREFERENCE_TRAFFIC_UNAWARE`, e 10 ou menos waypoints intermediários, com qualquer meio de transporte	`routing_preference` definido como `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL` ou de 11 a 25 waypoints intermediários
`lookup_weather`	Cada solicitação	—

Para saber os preços do Essentials, consulte os detalhes da SKU do Essentials. As solicitações do Pro são cobradas a US $14,00 por 1.000 solicitações após as primeiras 5.000 solicitações de cada mês. Entre em contato com a equipe de vendas para saber os preços por volume.

Durante a GA restrita, as opções do Pro só entram em vigor em projetos na lista de permissões do Pro. Para mais detalhes, consulte Opções do Pro durante a GA restrita.

Consulte a tabela de preços principal e a tabela de preços da Índia para mais detalhes.

As solicitações da API Resolution (ResolveNames e ResolveMapsUrls) são faturadas sem custo financeiro na SKU Text Search Essentials (somente IDs) da API Places.

O uso da SKU do Essentials também está incluído nos pacotes Assine para economizar do Essentials e do Pro. A SKU Pro não está incluída nos pacotes do programa Subscribe to Save.

Cotas

As cotas a seguir se aplicam às ferramentas e APIs fornecidas pelas ferramentas de agente dos Experimentos do Maps:

Pesquisar lugares: 300 consultas por minuto, por projeto.
Pesquisa de clima: 300 consultas por minuto, por projeto.
Calcular rotas: 300 consultas por minuto, por projeto.
Resolver nomes: 600 consultas por minuto, por projeto.
Resolver URLs do Maps: 600 consultas por minuto, por projeto.

As cotas são contadas por ferramenta e compartilhadas pelas SKUs Essentials e Pro. Uma solicitação do Pro consome a mesma cota que uma solicitação do Essentials para a mesma ferramenta.

Cada solicitação de API Resolution conta como uma consulta, independentemente de quantos itens ela contém.

Políticas e Termos de Serviço

As ferramentas de agente dos Experimentos do Maps estão sujeitas aos Termos de Serviço da Plataforma Google Maps, incluindo os termos específicos do serviço. Esta seção descreve outros requisitos de uso para as ferramentas do agente da Experiência do Maps, incluindo LLMs compatíveis e atribuição de origem. Os requisitos se aplicam a todos os resultados, independentemente da SKU em que uma solicitação é cobrada.

Requisitos para LLMs compatíveis

Só é permitido usar as ferramentas de agente da Experiência do Maps 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 que você escolher usar. Antes de usar as ferramentas de agente dos Experimentos do Maps, leia os Termos de Serviço de qualquer modelo que você pretenda usar com elas. Não use as ferramentas de agente da Experiência do Maps com modelos que usem os dados inseridos no modelo 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 das ferramentas do agente da Experiência do Maps inclui fontes. Ao apresentar resultados das ferramentas de agente da Experiência do Maps, é necessário incluir as fontes associadas do Google Maps e atender aos seguintes requisitos:

As fontes do Google Maps precisam seguir imediatamente o conteúdo gerado que elas apoiam. Esse conteúdo gerado também é chamado de Resposta embasada.
As fontes do Google Maps precisam ser visíveis em uma interação do usuário.

Fontes da ferramenta Pesquisar lugares

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

place (nome do recurso)
id
location
googleMapsLinks

Para cada lugar, é necessário gerar uma prévia de link que atenda a estes requisitos:

Atribua cada fonte ao Google Maps, seguindo as diretrizes de atribuição de texto das ferramentas do agente da Experiência do Maps.
Vincule à origem usando o places.googleMapsLinks.placeUrl da resposta.

Esses requisitos também se aplicam a resumos que incluem detalhes estendidos de lugares do Pro, como insights de avaliações. O summary cita cada lugar com um índice baseado em zero, por exemplo, [0], que é mapeado para uma entrada em places. Cada lugar também inclui googleMapsLinks.reviewsUrl, que direciona para as avaliações do lugar no Google Maps. Os usuários podem seguir o link para ver as avaliações por trás de um insight.

Interfaces que priorizam a voz

Se o app apresentar os resultados das ferramentas do agente da Experiência do Maps por voz, você também precisará atender aos requisitos de interfaces que priorizam a voz. Em resumo:

Fontes: mostre as fontes do Google Maps em uma interface complementar que exibe um registro histórico literal da conversa por voz.
Declaração ativa: no momento da interação, informe aos usuários que o conteúdo gerado com IA pode incluir informações do Google Maps. Informe também que as fontes detalhadas estão disponíveis na interface complementar. Você pode fazer isso na tela ou por voz.
Declaração persistente: mantenha uma explicação persistente, por exemplo, em um menu de configurações de voz, informando que o conteúdo gerado com IA pode incluir conteúdo do Google Maps.
Consultas do usuário: responda com precisão às perguntas dos usuários sobre a fonte do conteúdo e direcione-os para a interface complementar para mais detalhes.

Configurar LLMs para usar o servidor MCP

Para usar as ferramentas de agente da Experiência do Maps, você precisa de um projeto do Google Cloud com o serviço de API ferramentas de agente da Experiência do Maps ativado. Você também precisa de uma chave de API ou um ID do cliente OAuth. Em seguida, configure os LLMs para acessar o servidor MCP. O servidor MCP usa o transporte HTTP transmissível.

Ative as ferramentas de agente da Experiência do Maps no seu projeto do Google Cloud.

Para ativar a API no seu projeto:

No console do Google Cloud, escolha o projeto que você quer usar para as ferramentas de agente da Experiência do Maps.
Ative o faturamento para o projeto no Console do Google Cloud.
Ative as ferramentas de agente da Experiência do Maps na biblioteca de APIs do console do Google Cloud.

Autenticar usando uma chave de API

Você pode usar uma chave de API atual com as ferramentas de agente da Experiência do Maps ou criar uma nova. De qualquer forma, ative o serviço da API Ferramentas do agente de experiência do Maps no projeto do Google Cloud e na chave.

Para autenticar usando uma chave de API:

Crie ou configure uma chave de API seguindo as etapas em Primeiros passos com a Plataforma Google Maps.
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.

Autenticar usando OAuth

É possível autenticar usando o OAuth criando credenciais OAuth e transmitindo-as para o host MCP ou o aplicativo do servidor MCP.

Para autenticar usando o OAuth:

No console do Google Cloud, escolha o projeto que você quer usar para as ferramentas de agente da Experiência do Maps.
No menu APIs e serviços, selecione Credenciais.
No menu superior, selecione Criar credenciais > ID do cliente OAuth.
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.
Na seção Métricas, clique em Criar cliente OAuth.
Na tela Criar ID do cliente OAuth, selecione um tipo de aplicativo e insira um nome para o ID do cliente.
Especifique os detalhes adicionais relevantes para seu tipo de aplicativo. Por exemplo, se você estiver criando um aplicativo da Web, adicione URIs autorizados para solicitações de navegador e servidor.
Depois que o cliente for criado, salve o ID do cliente e a chave secreta.
Ao configurar o host ou o aplicativo do servidor MCP, transmita o ID do cliente OAuth e a chave secreta. 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 de ferramentas do agente da Experiência do Maps

Depois de ativar o serviço de ferramentas do agente do Maps Experience e criar credenciais, configure os LLMs para acessar o servidor MCP. Siga a documentação de configuração do MCP do seu LLM e use o URL do servidor MCP: https://mapstools.googleapis.com/mcp

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

Configurar ferramentas de agente da Experiência do Maps com a CLI do Gemini

Esta seção mostra um exemplo de como configurar o servidor MCP de ferramentas de agente da Experiência do Maps usando a CLI do Gemini. Para mais detalhes, consulte Servidores MCP com a CLI do Gemini.

Depois de instalar a CLI do Gemini, execute gemini mcp add para configurar o servidor MCP:
```
gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-experience-agent-tools-mcp https://mapstools.googleapis.com/mcp
```
Se a configuração tiver sido bem-sucedida, você vai receber uma confirmação de que o servidor foi adicionado às suas configurações de usuário.

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

> /mcp list

Configured MCP servers:

maps-experience-agent-tools-mcp - Ready (5 tools)
Tools:
-   compute_routes
-   lookup_weather
-   resolve_maps_urls
-   resolve_names
-   search_places

Comece a Perguntar ao Maps com a CLI. Por exemplo, tente "Recomende alguns restaurantes em Mountain View", que deve chamar a ferramenta search_places em seu nome.

Configurar ferramentas de agente da Experiência do Maps com o Kit de Desenvolvimento de Agente (ADK)

Nesta seção, mostramos como configurar o servidor MCP com o Kit de Desenvolvimento de Agente (ADK) em Python, Java ou TypeScript.

Python

Uma implementação completa desse exemplo está disponível no GitHub, no repositório adk-samples.

Etapa 1: definir o agente com `McpToolset` para as ferramentas de agente da Experiência do Maps

Modifique o arquivo agent.py. Substitua YOUR_GOOGLE_MAPS_API_KEY pela sua chave de API.

# ./adk_agent_samples/mcp_agent/agent.py
import os
from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

# Retrieve the API key from an environment variable or directly insert it.
GOOGLE_MAPS_API_KEY = os.getenv("GOOGLE_MAPS_API_KEY")
if not GOOGLE_MAPS_API_KEY:
    GOOGLE_MAPS_API_KEY = "YOUR_GOOGLE_MAPS_API_KEY_HERE"

if GOOGLE_MAPS_API_KEY == "YOUR_GOOGLE_MAPS_API_KEY_HERE":
    print("WARNING: GOOGLE_MAPS_API_KEY is not set.")

root_agent = Agent(
    model='gemini-flash-latest',
    name='travel_planner_agent',
    description='A helpful assistant for planning travel routes.',
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mapstools.googleapis.com/mcp",
                headers={
                    "X-Goog-Api-Key": GOOGLE_MAPS_API_KEY,
                    "Content-Type": "application/json",
                    "Accept": "application/json, text/event-stream"
                }
            )
        )
    ]
)

Etapa 2: garantir que `init.py` exista

Verifique se você tem um __init__.py no mesmo diretório que o agent.py:

from . import agent

Etapa 3: executar `adk web` e interagir

Defina a variável de ambiente:
Defina sua chave de API Google Maps como uma variável de ambiente no terminal:
```
export GOOGLE_MAPS_API_KEY="YOUR_ACTUAL_GOOGLE_MAPS_API_KEY"
        
```
Execute adk web:
Execute o seguinte comando para iniciar a interface da Web do ADK:
```
adk web
        
```
Interagir na interface:
- Selecione a travel_planner_agent.
- Teste comandos como:
  - "Vou estar em São Francisco amanhã. Como está o clima?"
  - Encontre cafeterias perto do Parque Golden Gate.
  - "Rotas do GooglePlex para o SFO."

Java

Defina um agente que inicialize o McpToolset em Java. Substitua YOUR_GOOGLE_MAPS_API_KEY_HERE pela chave de API real que você recebeu se não usar uma variável de ambiente.

package agents;

import com.google.adk.agents.LlmAgent;
import com.google.adk.runner.InMemoryRunner;
import com.google.adk.sessions.SessionKey;
import com.google.adk.tools.mcp.McpToolset;
import com.google.adk.tools.mcp.StreamableHttpServerParameters;
import com.google.genai.types.Content;
import com.google.genai.types.Part;
import java.util.HashMap;
import java.util.Map;

public class MapsAgentCreator {
    public static void main(String[] args) {
        String googleMapsApiKey = System.getenv("GOOGLE_MAPS_API_KEY");
        if (googleMapsApiKey == null || googleMapsApiKey.trim().isEmpty()) {
            googleMapsApiKey = "YOUR_GOOGLE_MAPS_API_KEY_HERE";
            if ("YOUR_GOOGLE_MAPS_API_KEY_HERE".equals(googleMapsApiKey)) {
                System.out.println("WARNING: GOOGLE_MAPS_API_KEY is not set.");
            }
        }

        Map<String, String> headers = new HashMap<>();
        headers.put("X-Goog-Api-Key", googleMapsApiKey);
        headers.put("Content-Type", "application/json");
        headers.put("Accept", "application/json, text/event-stream");

        StreamableHttpServerParameters serverParams =
                StreamableHttpServerParameters.builder("https://mapstools.googleapis.com/mcp")
                        .headers(headers)
                        .build();

        try (McpToolset toolset = new McpToolset(serverParams)) {
            LlmAgent agent = LlmAgent.builder()
                    .model("gemini-flash-latest")
                    .name("travel_planner_agent")
                    .description("A helpful assistant for planning travel routes.")
                    .tools(toolset)
                    .build();

            System.out.println("Agent created: " + agent.name());

            InMemoryRunner runner = new InMemoryRunner(agent);
            String userId = "maps-user-" + System.currentTimeMillis();
            String sessionId = "maps-session-" + System.currentTimeMillis();
            String promptText =
                    "Please give me directions to the nearest pharmacy to Madison Square Garden.";

            SessionKey sessionKey = runner.sessionService()
                    .createSession(runner.appName(), userId, null, sessionId)
                    .blockingGet()
                    .sessionKey();
            System.out.println("Session created: " + sessionId + " for user: " + userId);

            Content promptContent = Content.fromParts(Part.fromText(promptText));
            System.out.println("\nSending prompt: \"" + promptText + "\" to agent...\n");

            runner.runAsync(sessionKey, promptContent)
                    .blockingForEach(event -> {
                        System.out.println("Event received: " + event.toJson());
                    });
        } catch (Exception e) {
            System.err.println("An error occurred: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

TypeScript

Defina um agente que inicialize o MCPToolset em TypeScript:

import 'dotenv/config';
import {LlmAgent, MCPToolset} from "@google/adk";

const googleMapsApiKey = process.env.GOOGLE_MAPS_API_KEY;
if (!googleMapsApiKey) {
    console.warn("WARNING: GOOGLE_MAPS_API_KEY is not set.");
    throw new Error(
        'GOOGLE_MAPS_API_KEY is not provided, please run "export GOOGLE_MAPS_API_KEY=YOUR_ACTUAL_KEY" to add that.'
    );
}

export const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "travel_planner_agent",
    description: "A helpful assistant for planning travel.",
    tools: [
        new MCPToolset({
            type: "SseConnectionParams",
            url: "https://mapstools.googleapis.com/mcp",
            headers: {
                "X-Goog-Api-Key": googleMapsApiKey,
                "Content-Type": "application/json",
                "Accept": "application/json, text/event-stream"
            }
        })
    ],
});

Enviar comentários

Para enviar feedback sobre as ferramentas de agente da Experiência do Maps, use os seguintes formulários: