Kit de ferramentas do Code Assist para a Plataforma Google Maps (experimental)

O kit de ferramentas do Code Assist da Plataforma Google Maps é um servidor de Protocolo de Contexto de Modelo (MCP) que melhora as respostas de modelos de linguagem grandes (LLMs) usados para desenvolver aplicativos com a Plataforma Google Maps. Ele funciona embasando as respostas na documentação oficial e atualizada e em exemplos de código.

Como o servidor MCP acessa o conteúdo quando o modelo é solicitado, o contexto do LLM em relação à Plataforma Google Maps não precisa se limitar aos dados disponíveis na data de treinamento do modelo.

Os recursos da Plataforma Google Maps que o servidor MCP pode acessar incluem:

  • Documentação da Plataforma Google Maps
  • Termos de Serviço da Plataforma Google Maps
  • Central de confiabilidade da Plataforma Google Maps
  • Repositórios de código nas organizações oficiais da Plataforma Google Maps no GitHub

Ferramentas

O Maps Code Assist oferece ferramentas que permitem que os LLMs acessem os seguintes recursos:

  • retrieve-instructions: uma ferramenta auxiliar usada pelo cliente para receber instruções cruciais do sistema sobre como entender melhor a intenção do usuário e formular chamadas eficazes para a ferramenta retrieve-google-maps-platform-docs.
  • retrieve-google-maps-platform-docs: a ferramenta principal. Ele recebe uma consulta em linguagem natural e a envia para um mecanismo de geração aumentada de recuperação (RAG) hospedado. O mecanismo de RAG pesquisa versões recentes da documentação oficial, dos tutoriais e dos exemplos de código da Plataforma Google Maps, retornando um contexto relevante para o LLM gerar uma resposta precisa.

Faturamento

Não há cobrança pelo uso do Maps Code Assist enquanto ele estiver no estágio experimental.

Políticas e Termos de Serviço

O Maps Code Assist está sujeito aos Termos de Serviço da Plataforma Google Maps, incluindo os termos específicos para esse serviço. Nesta seção, descrevemos outros requisitos de uso do serviço para o Maps Code Assist, incluindo LLMs compatíveis e requisitos de atribuição de origem.

Requisitos para LLMs compatíveis

Você só pode usar o Maps Code Assist 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. Antes de usar o Maps Code Assist, leia os Termos de Serviço de qualquer modelo que você pretenda usar com ele. Não use o Maps Code Assist com modelos que utilizam os dados inseridos para treinamento ou melhoria de modelos. 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

Ao apresentar resultados que usam ferramentas fornecidas pelo Maps Code Assist, é necessário incluir as fontes associadas do Google Maps.

Configurar LLMs para acessar o servidor MCP do Maps Code Assist

Para configurar LLMs para acessar o servidor MCP, siga a documentação de configuração do MCP correspondente e use o endpoint do servidor MCP do Code Assist: https://mapscodeassist.googleapis.com/mcp.

O servidor MCP do Maps Code Assist usa o transporte HTTP transmissível. Para mais informações, consulte Configurar o MCP em um aplicativo de IA.

Exemplos de casos de uso

Depois de configurado, você pode fazer perguntas ao LLM sobre a Plataforma Google Maps. Veja alguns comandos de exemplo:

  • "Como faço para adicionar um mapa ao meu app Android?"
  • "Qual é a melhor maneira de acessar a localização atual do usuário em um mapa no iOS?"
  • "Forneça um exemplo de uso do serviço de rotas na API Maps JavaScript."

Ferramentas disponíveis

Para conferir detalhes das ferramentas MCP disponíveis e as descrições delas para o servidor MCP do Maps Code Assist, consulte a referência do MCP do Maps Code Assist.

Listar ferramentas com uma solicitação HTTP

Para verificar se o servidor está funcionando e conferir uma lista de ferramentas disponíveis, envie uma solicitação HTTP tools/list diretamente para o servidor MCP remoto do Maps Code Assist. O método tools/list não requer autenticação.

curl -X POST https://mapscodeassist.googleapis.com/TOOLSET_ENDPOINT \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'MCP-Protocol-Version: MCP_PROTOCOL_VERSION' \
    -H 'Mcp-Method: tools/list' \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/list",
      "params": {
        "_meta": {
          "io.modelcontextprotocol/protocolVersion": "MCP_PROTOCOL_VERSION",
          "io.modelcontextprotocol/clientCapabilities": {
            "extensions": {
              "io.modelcontextprotocol/ui": {
                "mimeTypes": ["text/html;profile=mcp-app"]
              }
            }
          }
        }
      }
    }'

Substitua:

  • TOOLSET_ENDPOINT: o restante do endpoint do MCP após o nome do serviço. Para o Maps Code Assist, é mcp.
  • MCP_PROTOCOL_VERSION: a versão do protocolo MCP. Por exemplo, 2026-07-28.

Compartilhar feedback

Para enviar feedback sobre o Maps Code Assist, use os seguintes formulários: