Toolkit Code Assist per Google Maps Platform (sperimentale)

Il toolkit Code Assist per Google Maps Platform è un server Model Context Protocol (MCP) che migliora le risposte dei modelli linguistici di grandi dimensioni (LLM) utilizzati per lo sviluppo di applicazioni con Google Maps Platform. Funziona basando le risposte sulla documentazione ufficiale e aggiornata e sugli esempi di codice.

Poiché il server MCP accede ai contenuti quando viene richiesto il modello, il contesto dell'LLM relativo a Google Maps Platform non deve essere limitato ai dati disponibili alla data di addestramento del modello.

Le risorse di Google Maps Platform a cui il server MCP può accedere includono:

  • Documentazione di Google Maps Platform
  • Termini di servizio di Google Maps Platform
  • Centro affidabilità di Google Maps Platform
  • Repository di codice nelle organizzazioni GitHub ufficiali di Google Maps Platform

Strumenti

Maps Code Assist fornisce strumenti che consentono agli LLM di accedere alle seguenti funzionalità:

  • retrieve-instructions: uno strumento di supporto utilizzato dal client per ottenere istruzioni di sistema cruciali su come ragionare al meglio sull'user intent e formulare chiamate efficaci allo strumento retrieve-google-maps-platform-docs.
  • retrieve-google-maps-platform-docs: lo strumento principale. Accetta una query in linguaggio naturale e la invia a un motore di Retrieval-Augmented Generation (RAG) in hosting. Il motore RAG cerca versioni aggiornate della documentazione, dei tutorial e degli esempi di codice ufficiali di Google Maps Platform, restituendo il contesto pertinente all'LLM in modo che generi una risposta accurata.

Fatturazione

Non sono previsti costi per l'utilizzo di Maps Code Assist durante la fase sperimentale.

Norme e Termini di servizio

Maps Code Assist è soggetto ai Termini di servizio di Google Maps Platform, inclusi i Termini specifici dei servizi per questo servizio. Questa sezione descrive i requisiti aggiuntivi per l'utilizzo del servizio per l'assistenza al codice di Maps, inclusi i requisiti per gli LLM compatibili e i requisiti di attribuzione della fonte.

Requisiti per gli LLM compatibili

Puoi utilizzare Maps Code Assist solo con un LLM conforme ai Termini di servizio di Google Maps Platform.

Ad esempio, sei responsabile di garantire che i Contenuti di Google Maps non vengano memorizzati nella cache, archiviati o utilizzati per migliorare l'LLM che scegli di utilizzare. Prima di utilizzare Maps Code Assist, devi esaminare i Termini di servizio di qualsiasi modello che intendi utilizzare con Maps Code Assist. Non devi utilizzare l'assistenza al coding di Maps con modelli che utilizzano i dati inseriti nel modello per l'addestramento o il miglioramento del modello. È tua responsabilità assicurarti che l'utilizzo del modello sia pienamente conforme alle limitazioni relative ai contenuti di Google Maps nei Termini di servizio di Google Maps Platform, inclusi i termini specifici del servizio.

Requisiti di attribuzione per le origini di Google Maps

Quando presenti risultati che utilizzano gli strumenti forniti da Assistente al codice di Maps, devi includere le fonti di Google Maps associate.

Configura gli LLM per accedere al server MCP di Maps Code Assist

Puoi configurare gli LLM per accedere al server MCP seguendo la documentazione di configurazione MCP corrispondente e utilizzando l'endpoint del server MCP di Code Assist: https://mapscodeassist.googleapis.com/mcp.

Il server MCP di Maps Code Assist utilizza il trasporto HTTP trasmissibile in streaming. Per saperne di più, consulta Configura MCP in un'applicazione di AI.

Esempi di casi d'uso

Una volta configurato, puoi porre all'LLM domande su Google Maps Platform. Ecco alcuni prompt di esempio:

  • "Come faccio ad aggiungere una mappa alla mia app per Android?"
  • "Qual è il modo migliore per ottenere la posizione attuale dell'utente su una mappa in iOS?"
  • "Fornisci un esempio di utilizzo del servizio di indicazioni stradali nell'API Maps JavaScript."

Strumenti disponibili

Per visualizzare i dettagli degli strumenti MCP disponibili e le relative descrizioni per il server MCP Maps Code Assist, consulta il riferimento MCP Maps Code Assist.

Elenca gli strumenti con una richiesta HTTP

Per verificare che il server funzioni e visualizzare un elenco di strumenti disponibili, puoi inviare una richiesta HTTP tools/list direttamente al server MCP remoto di Maps Code Assist. Il metodo tools/list non richiede l'autenticazione.

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"]
              }
            }
          }
        }
      }
    }'

Sostituisci quanto segue:

  • TOOLSET_ENDPOINT: il resto dell'endpoint MCP dopo il nome del servizio. Per Maps Code Assist, si tratta di mcp.
  • MCP_PROTOCOL_VERSION: la versione del protocollo MCP. Ad esempio, 2026-07-28.

Condividi feedback

Per condividere il tuo feedback su Maps Code Assist, utilizza i seguenti moduli: