Messa a terra con Google Maps

Il grounding con Google Maps collega le funzionalità generative di Gemini con i dati ricchi, fattuali e aggiornati di Google Maps. Questa funzionalità consente agli sviluppatori di incorporare facilmente funzionalità basate sulla località nelle loro applicazioni. Quando una query utente ha un contesto correlato ai dati di Maps, il modello Gemini utilizza Google Maps per fornire risposte fattualmente accurate e aggiornate pertinenti alla località o all'area generale specificata dall'utente.

• Risposte accurate e basate sulla località: sfrutta i dati estesi e attuali di Google Maps per le query geograficamente specifiche.
• Personalizzazione avanzata: personalizza i consigli e le informazioni in base alle località fornite dagli utenti.
• Informazioni e widget contestuali: token di contesto per visualizzare i widget interattivi di Google Maps insieme ai contenuti generati.

Inizia

Questo esempio mostra come integrare il grounding con Google Maps nella tua applicazione per fornire risposte accurate e basate sulla località alle query degli utenti. Il prompt richiede consigli locali con una località utente facoltativa, consentendo al modello Gemini di utilizzare i dati di Google Maps.

from google import genai
from google.genai import types

client = genai.Client()

prompt = "What are the best Italian restaurants within a 15-minute walk from here?"

response = client.models.generate_content(
    model='gemini-3-flash-preview',
    contents=prompt,
    config=types.GenerateContentConfig(
        # Turn on grounding with Google Maps
        tools=[types.Tool(google_maps=types.GoogleMaps())],
        # Optionally provide the relevant location context (this is in Los Angeles)
        tool_config=types.ToolConfig(retrieval_config=types.RetrievalConfig(
            lat_lng=types.LatLng(
                latitude=34.050481, longitude=-118.248526))),
    ),
)

print("Generated Response:")
print(response.text)

if grounding := response.candidates[0].grounding_metadata:
  if grounding.grounding_chunks:
    print('-' * 40)
    print("Sources:")
    for chunk in grounding.grounding_chunks:
      print(f'- [{chunk.maps.title}]({chunk.maps.uri})')

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

async function generateContentWithMapsGrounding() {
  const response = await ai.models.generateContent({
    model: "gemini-3-flash-preview",
    contents: "What are the best Italian restaurants within a 15-minute walk from here?",
    config: {
      // Turn on grounding with Google Maps
      tools: [{ googleMaps: {} }],
      toolConfig: {
        retrievalConfig: {
          // Optionally provide the relevant location context (this is in Los Angeles)
          latLng: {
            latitude: 34.050481,
            longitude: -118.248526,
          },
        },
      },
    },
  });

  console.log("Generated Response:");
  console.log(response.text);

  const grounding = response.candidates[0]?.groundingMetadata;
  if (grounding?.groundingChunks) {
    console.log("-".repeat(40));
    console.log("Sources:");
    for (const chunk of grounding.groundingChunks) {
      if (chunk.maps) {
        console.log(`- [${chunk.maps.title}](${chunk.maps.uri})`);
      }
    }
  }
}

generateContentWithMapsGrounding();

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:generateContent' \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: ${GEMINI_API_KEY}" \
  -d '{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "What are the best Italian restaurants within a 15-minute walk from here?"
    }]
  }],
  "tools": [{"googleMaps": {}}],
  "toolConfig": {
    "retrievalConfig": {
      "latLng": {"latitude": 34.050481, "longitude": -118.248526}
    }
  }
}'

Come funziona il grounding con Google Maps

Il grounding con Google Maps integra l'API Gemini con l'ecosistema Google Geo utilizzando l'API di Google Maps come origine di grounding. Quando la query di un utente contiene un contesto geografico, il modello Gemini può richiamare lo strumento di grounding con Google Maps. Il modello può quindi generare risposte basate sui dati di Google Maps pertinenti alla località fornita.

In genere, la procedura prevede:

1. Query utente: un utente invia una query alla tua applicazione, che potrebbe includere un contesto geografico (ad es. "bar nelle vicinanze", "musei a San Francisco").
2. Richiamo dello strumento: il modello Gemini, riconoscendo l'intento geografico, richiama lo strumento di grounding con Google Maps. Questo strumento può essere fornito facoltativamente con la latitude e la longitude dell'utente. Lo strumento è uno strumento di ricerca testuale e si comporta in modo simile alla ricerca su Maps, in quanto le query locali ("nelle vicinanze") utilizzeranno le coordinate, mentre è improbabile che le query specifiche o non locali siano influenzate dalla località esplicita.
3. Recupero dei dati: il servizio di grounding con Google Maps esegue una query su Google Maps per recuperare informazioni pertinenti (ad es. luoghi, recensioni, foto, indirizzi, orari di apertura).
4. Generazione basata su dati di fatto: i dati di Maps recuperati vengono utilizzati per informare la risposta del modello Gemini, garantendo accuratezza e pertinenza fattuali.
5. Risposta e token del widget: il modello restituisce una risposta di testo, che include citazioni delle fonti di Google Maps. Facoltativamente, la risposta dell'API può contenere anche un google_maps_widget_context_token, che consente agli sviluppatori di visualizzare un widget contestuale di Google Maps nella propria applicazione per l'interazione visiva.

Perché e quando utilizzare il grounding con Google Maps

Il grounding con Google Maps è ideale per le applicazioni che richiedono informazioni accurate, aggiornate e specifiche per la località. Migliora l'esperienza utente fornendo contenuti pertinenti e personalizzati supportati dall'ampio database di Google Maps di oltre 250 milioni di luoghi in tutto il mondo.

Devi utilizzare il grounding con Google Maps quando la tua applicazione deve:

• Fornire risposte complete e accurate a domande geograficamente specifiche.
• Creare pianificatori di viaggi conversazionali e guide locali.
• Consigliare punti di interesse in base alla località e alle preferenze dell'utente, come ristoranti o negozi.
• Creare esperienze basate sulla località per servizi social, di vendita al dettaglio o di consegna di cibo.

Il grounding con Google Maps è eccellente nei casi d'uso in cui la prossimità e i dati fattuali attuali sono fondamentali, ad esempio per trovare il "miglior bar nelle vicinanze" o ottenere indicazioni stradali.

Metodi e parametri dell'API

Il grounding con Google Maps viene esposto tramite l'API Gemini come strumento all'interno del generateContent metodo. Per abilitare e configurare il grounding con Google Maps, includi un googleMaps oggetto nel tools parametro della tua richiesta.

{
  "contents": [{
    "parts": [
      {"text": "Restaurants near Times Square."}
    ]
  }],
  "tools":  { "googleMaps": {} }
}

Lo googleMaps strumento può accettare anche un parametro booleano enableWidget, utilizzato per controllare se il googleMapsWidgetContextToken campo viene restituito nella risposta. Può essere utilizzato per visualizzare un widget contestuale di Places.

{
"contents": [{
    "parts": [
      {"text": "Restaurants near Times Square."}
    ]
  }],
  "tools":  { "googleMaps": { "enableWidget": true } }
}

Inoltre, lo strumento supporta il passaggio della località contestuale come toolConfig.

{
  "contents": [{
    "parts": [
      {"text": "Restaurants near here."}
    ]
  }],
  "tools":  { "googleMaps": {} },
  "toolConfig":  {
    "retrievalConfig": {
      "latLng": {
        "latitude": 40.758896,
        "longitude": -73.985130
      }
    }
  }
}

Comprendere la risposta di grounding

Quando una risposta viene basata correttamente sui dati di Google Maps, la risposta include un groundingMetadata campo. Questi dati strutturati sono essenziali per verificare le rivendicazioni e creare un'esperienza di citazione avanzata nella tua applicazione, nonché per soddisfare i requisiti di utilizzo del servizio.

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "CanteenM is an American restaurant with..."
          }
        ],
        "role": "model"
      },
      "groundingMetadata": {
        "groundingChunks": [
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=13100894621228039586",
              "title": "Heaven on 7th Marketplace",
              "placeId": "places/ChIJ0-zA1vBZwokRon0fGj-6z7U"
            },
            // repeated ...
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "startIndex": 0,
              "endIndex": 79,
              "text": "CanteenM is an American restaurant with a 4.6-star rating and is open 24 hours."
            },
            "groundingChunkIndices": [0]
          },
          // repeated ...
        ],
        "webSearchQueries": [
          "restaurants near me"
        ],
        "googleMapsWidgetContextToken": "widgetcontent/..."
      }
    }
  ]
}

L'API Gemini restituisce le seguenti informazioni con le groundingMetadata:

• groundingChunks: array di oggetti contenenti le fonti maps (uri, placeId e title).
• groundingSupports: array di blocchi per collegare il testo della risposta del modello alle fonti in groundingChunks. Ogni blocco collega un intervallo di testo (definito da startIndex e endIndex) a uno o più groundingChunkIndices. Questa è la chiave per creare citazioni in linea.
• googleMapsWidgetContextToken: un token di testo che può essere utilizzato per visualizzare un widget contestuale di Places.

Per uno snippet di codice che mostra come visualizzare le citazioni in linea nel testo, consulta l' esempio nella documentazione relativa al grounding con la Ricerca Google.

Visualizzare il widget contestuale di Google Maps

Per utilizzare il googleMapsWidgetContextToken restituito, devi caricare l' API Google Maps JavaScript.

Casi d'uso

Il grounding con Google Maps supporta una serie di casi d'uso basati sulla località. Gli esempi seguenti mostrano come diversi prompt e parametri possono sfruttare il grounding con Google Maps. Le informazioni nei risultati basati su dati di fatto di Google Maps potrebbero differire dalle condizioni effettive.

Gestire le domande specifiche per luogo

Poni domande dettagliate su un luogo specifico per ottenere risposte basate sulle recensioni degli utenti di Google e su altri dati di Maps.

from google import genai
from google.genai import types

client = genai.Client()

prompt = "Is there a cafe near the corner of 1st and Main that has outdoor seating?"

response = client.models.generate_content(
    model='gemini-3-flash-preview',
    contents=prompt,
    config=types.GenerateContentConfig(
        # Turn on the Maps tool
        tools=[types.Tool(google_maps=types.GoogleMaps())],

        # Provide the relevant location context (this is in Los Angeles)
        tool_config=types.ToolConfig(retrieval_config=types.RetrievalConfig(
            lat_lng=types.LatLng(
                latitude=34.050481, longitude=-118.248526))),
    ),
)

print("Generated Response:")
print(response.text)

if grounding := response.candidates[0].grounding_metadata:
  if chunks := grounding.grounding_chunks:
    print('-' * 40)
    print("Sources:")
    for chunk in chunks:
      print(f'- [{chunk.maps.title}]({chunk.maps.uri})')
  ```

import { GoogleGenAI } from '@google/genai';

const ai = new GoogleGenAI({});

async function run() {
  const prompt = "Is there a cafe near the corner of 1st and Main that has outdoor seating?";

  const response = await ai.models.generateContent({
    model: 'gemini-3-flash-preview',
    contents: prompt,
    config: {
      // Turn on the Maps tool
      tools: [{googleMaps: {}}],
      // Provide the relevant location context (this is in Los Angeles)
      toolConfig: {
        retrievalConfig: {
          latLng: {
            latitude: 34.050481,
            longitude: -118.248526
          }
        }
      }
    },
  });

  console.log("Generated Response:");
  console.log(response.text);

  const chunks = response.candidates[0].groundingMetadata?.groundingChunks;
  if (chunks) {
    console.log('-'.repeat(40));
    console.log("Sources:");
    for (const chunk of chunks) {
      if (chunk.maps) {
        console.log(`- [${chunk.maps.title}](${chunk.maps.uri})`);
      }
    }
  }
}

run();

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:generateContent' \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: ${GEMINI_API_KEY}" \
  -d '{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "Is there a cafe near the corner of 1st and Main that has outdoor seating?"
    }]
  }],
  "tools": [{"googleMaps": {}}],
  "toolConfig": {
    "retrievalConfig": {
      "latLng": {"latitude": 34.050481, "longitude": -118.248526}
    }
  }
}'

Fornire personalizzazione basata sulla località

Ricevi consigli personalizzati in base alle preferenze di un utente e a un'area geografica specifica.

from google import genai
from google.genai import types

client = genai.Client()

prompt = "Which family-friendly restaurants near here have the best playground reviews?"

response = client.models.generate_content(
    model='gemini-3-flash-preview',
    contents=prompt,
    config=types.GenerateContentConfig(
      tools=[types.Tool(google_maps=types.GoogleMaps())],
      tool_config=types.ToolConfig(retrieval_config=types.RetrievalConfig(
          # Provide the location as context; this is Austin, TX.
          lat_lng=types.LatLng(
              latitude=30.2672, longitude=-97.7431))),
    ),
)

print("Generated Response:")
print(response.text)

if grounding := response.candidates[0].grounding_metadata:
  if chunks := grounding.grounding_chunks:
    print('-' * 40)
    print("Sources:")
    for chunk in chunks:
      print(f'- [{chunk.maps.title}]({chunk.maps.uri})')

import { GoogleGenAI } from '@google/genai';

const ai = new GoogleGenAI({});

async function run() {
  const prompt = "Which family-friendly restaurants near here have the best playground reviews?";

  const response = await ai.models.generateContent({
    model: 'gemini-3-flash-preview',
    contents: prompt,
    config: {
      tools: [{googleMaps: {}}],
      toolConfig: {
        retrievalConfig: {
          // Provide the location as context; this is Austin, TX.
          latLng: {
            latitude: 30.2672,
            longitude: -97.7431
          }
        }
      }
    },
  });

  console.log("Generated Response:");
  console.log(response.text);

  const chunks = response.candidates[0].groundingMetadata?.groundingChunks;
  if (chunks) {
    console.log('-'.repeat(40));
    console.log("Sources:");
    for (const chunk of chunks) {
      if (chunk.maps) {
        console.log(`- [${chunk.maps.title}](${chunk.maps.uri})`);
      }
    }
  }
}

run();

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:generateContent' \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: ${GEMINI_API_KEY}" \
  -d '{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "Which family-friendly restaurants near here have the best playground reviews?"
    }],
  }],
  "tools": [{"googleMaps": {}}],
  "toolConfig": {
    "retrievalConfig": {
      "latLng": {"latitude": 30.2672, "longitude": -97.7431}
    }
  }
}'

Aiutare con la pianificazione dell'itinerario

Genera piani di più giorni con indicazioni stradali e informazioni su varie località, perfetti per le applicazioni di viaggio.

In questo esempio, il googleMapsWidgetContextToken è stato richiesto abilitando il widget nello strumento di Google Maps. Se abilitato, il token restituito può essere utilizzato per eseguire il rendering di un widget contestuale di Places utilizzando l' <gmp-places-contextual> component API Maps JavaScript.

from google import genai
from google.genai import types

client = genai.Client()

prompt = "Plan a day in San Francisco for me. I want to see the Golden Gate Bridge, visit a museum, and have a nice dinner."

response = client.models.generate_content(
    model='gemini-3-flash-preview',
    contents=prompt,
    config=types.GenerateContentConfig(
      tools=[types.Tool(google_maps=types.GoogleMaps(enable_widget=True))],
      tool_config=types.ToolConfig(retrieval_config=types.RetrievalConfig(
          # Provide the location as context, this is in San Francisco.
          lat_lng=types.LatLng(
              latitude=37.78193, longitude=-122.40476))),
    ),
)

print("Generated Response:")
print(response.text)

if grounding := response.candidates[0].grounding_metadata:
  if grounding.grounding_chunks:
    print('-' * 40)
    print("Sources:")
    for chunk in grounding.grounding_chunks:
      print(f'- [{chunk.maps.title}]({chunk.maps.uri})')

  if widget_token := grounding.google_maps_widget_context_token:
    print('-' * 40)
    print(f'<gmp-place-contextual context-token="{widget_token}"></gmp-place-contextual>')

import { GoogleGenAI } from '@google/genai';

const ai = new GoogleGenAI({});

async function run() {
  const prompt = "Plan a day in San Francisco for me. I want to see the Golden Gate Bridge, visit a museum, and have a nice dinner.";

  const response = await ai.models.generateContent({
    model: 'gemini-3-flash-preview',
    contents: prompt,
    config: {
      tools: [{googleMaps: {enableWidget: true}}],
      toolConfig: {
        retrievalConfig: {
          // Provide the location as context, this is in San Francisco.
          latLng: {
            latitude: 37.78193,
            longitude: -122.40476
          }
        }
      }
    },
  });

  console.log("Generated Response:");
  console.log(response.text);

  const groundingMetadata = response.candidates[0]?.groundingMetadata;
  if (groundingMetadata) {
    if (groundingMetadata.groundingChunks) {
      console.log('-'.repeat(40));
      console.log("Sources:");
      for (const chunk of groundingMetadata.groundingChunks) {
        if (chunk.maps) {
          console.log(`- [${chunk.maps.title}](${chunk.maps.uri})`);
        }
      }
    }

    if (groundingMetadata.googleMapsWidgetContextToken) {
      console.log('-'.repeat(40));
      document.body.insertAdjacentHTML('beforeend', `<gmp-place-contextual context-token="${groundingMetadata.googleMapsWidgetContextToken}`"></gmp-place-contextual>`);
    }
  }
}

run();

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:generateContent' \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: ${GEMINI_API_KEY}" \
  -d '{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "Plan a day in San Francisco for me. I want to see the Golden Gate Bridge, visit a museum, and have a nice dinner."
    }]
  }],
  "tools": [{"googleMaps": {"enableWidget":"true"}}],
  "toolConfig": {
    "retrievalConfig": {
    "latLng": {"latitude": 37.78193, "longitude": -122.40476}
  }
  }
}'

Quando viene visualizzato, il widget sarà simile al seguente:

Requisiti di utilizzo del servizio

Questa sezione descrive i requisiti di utilizzo del servizio per il grounding con Google Maps.

Informare l'utente sull'utilizzo delle fonti di Google Maps

Con ogni risultato basato su dati di fatto di Google Maps, riceverai le fonti in groundingChunks che supportano ogni risposta. Vengono restituiti anche i seguenti metadati:

• URI di origine
• Titolo
• ID

Quando presenti i risultati del grounding con Google Maps, devi specificare le fonti di Google Maps associate e informare gli utenti di quanto segue:

• Le fonti di Google Maps devono seguire immediatamente i contenuti generati che supportano. Questi contenuti generati sono anche chiamati risultati basati su dati di fatto di Google Maps.
• Le fonti di Google Maps devono essere visualizzabili all'interno di un'interazione utente.

Visualizzare le fonti di Google Maps con i link di Google Maps

Per ogni fonte in groundingChunks e in grounding_chunks.maps.placeAnswerSources.reviewSnippets, deve essere generata un'anteprima del link che soddisfi i seguenti requisiti:

• Attribuisci ogni fonte a Google Maps seguendo le linee guida per l'attribuzione del testo di Google Maps.
• Visualizza il titolo della fonte fornito nella risposta.
• Crea un link alla fonte utilizzando uri o googleMapsUri dalla risposta.

Queste immagini mostrano i requisiti minimi per la visualizzazione delle fonti e dei link di Google Maps.

Puoi comprimere la visualizzazione delle fonti.

Facoltativo: migliora l'anteprima del link con contenuti aggiuntivi, ad esempio:

• Un'icona di Google Maps viene inserita prima dell'attribuzione del testo di Google Maps.
• Una foto dall'URL di origine (og:image).

Per ulteriori informazioni su alcuni dei nostri fornitori di dati di Google Maps e sui relativi termini di licenza, consulta le note legali di Google Maps e Google Earth.

Linee guida per l'attribuzione del testo di Google Maps

Quando attribuisci le fonti a Google Maps nel testo, segui queste linee guida:

• Non modificare in alcun modo il testo Google Maps:
  • Non modificare le maiuscole/minuscole di Google Maps.
  • Non mandare a capo Google Maps su più righe.
  • Non localizzare Google Maps in un'altra lingua.
  • Impedisci ai browser di tradurre Google Maps utilizzando l'attributo HTML translate="no".
• Applica lo stile al testo di Google Maps come descritto nella tabella seguente:

CSS di esempio

Il seguente CSS visualizza Google Maps con lo stile tipografico e il colore appropriati su uno sfondo bianco o chiaro.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {

font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

Token di contesto, ID luogo e ID recensione

I dati di Google Maps includono il token di contesto, l'ID luogo e l'ID recensione. Puoi memorizzare nella cache, archiviare ed esportare i seguenti dati di risposta:

• googleMapsWidgetContextToken
• placeId
• reviewId

Le limitazioni alla memorizzazione nella cache nei Termini di grounding con Google Maps non si applicano.

Attività e territorio vietati

Il grounding con Google Maps prevede ulteriori limitazioni per determinati contenuti e attività al fine di mantenere una piattaforma sicura e affidabile. Oltre alle limitazioni all'utilizzo nei Termini:

• Non utilizzerai il grounding con Google Maps per attività ad alto rischio, inclusi i servizi di risposta alle emergenze.
• Non distribuirai né commercializzerai la tua applicazione che offre il grounding con Google Maps in un Territorio vietato. Per ulteriori informazioni, consulta la pagina Territori vietati di Google Maps Platform. L'elenco dei Territori vietati potrebbe essere aggiornato di tanto in tanto.

Best practice

• Fornisci la località dell'utente: per le risposte più pertinenti e personalizzate, includi sempre user_location (latitudine e longitudine) nella configurazione googleMapsGrounding quando la località dell'utente è nota.
• Visualizza il widget contestuale di Google Maps: il widget contestuale viene visualizzato utilizzando il token di contesto, googleMapsWidgetContextToken, che viene restituito nella risposta dell'API Gemini e può essere utilizzato per visualizzare contenuti visivi da Google Maps. Per ulteriori informazioni sul widget contestuale, consulta la sezione Widget di grounding con Google Maps nella Guida per gli sviluppatori Google.
• Informa gli utenti finali: informa chiaramente gli utenti finali che i dati di Google Maps vengono utilizzati per rispondere alle loro query, soprattutto quando lo strumento è abilitato.
• Monitora la latenza: per le applicazioni conversazionali, assicurati che la latenza P95 per le risposte basate su dati di fatto rimanga entro le soglie accettabili per mantenere un'esperienza utente fluida.
• Disattiva quando non è necessario: il grounding con Google Maps è disattivato per impostazione predefinita. Abilitalo solo ("tools": [{"googleMaps": {}}]) quando una query ha un contesto geografico chiaro, per ottimizzare il rendimento e i costi.

Limitazioni

• Ambito geografico: il grounding con Google Maps è disponibile a livello globale.
• Supporto del modello: consulta la sezione Modelli supportati.
• Input/output multimodali: al momento, il grounding con Google Maps non supporta input o output multimodali oltre al testo e ai widget di mappe contestuali.
• Stato predefinito: lo strumento di grounding con Google Maps è disattivato per impostazione predefinita. Devi abilitarlo esplicitamente nelle richieste API.

Prezzi e limiti di frequenza

I prezzi del grounding con Google Maps si basano sulle query. La tariffa attuale è di 25$per 1000 prompt basati su dati di fatto. Il Livello senza costi prevede anche fino a 500 richieste al giorno. Una richiesta viene conteggiata ai fini della quota solo quando un prompt restituisce correttamente almeno un risultato basato su dati di fatto di Google Maps (ovvero risultati contenenti almeno una fonte di Google Maps). Se vengono inviate più query a Google Maps da una singola richiesta, vengono conteggiate come una richiesta ai fini del limite di frequenza.

Per informazioni più dettagliate sui prezzi, consulta la pagina dei prezzi dell'API Gemini.

Modelli supportati

I seguenti modelli supportano il grounding con Google Maps:

Combinazioni di strumenti supportate

I modelli Gemini 3 supportano la combinazione di strumenti integrati (come il grounding con Google Maps) con strumenti personalizzati (chiamata di funzioni). Scopri di più nella pagina delle combinazioni di strumenti.

Passaggi successivi

• Prova il grounding con la Ricerca Google nell'API Gemini Cookbook.
• Scopri di più sugli altri strumenti disponibili.
• Per scoprire di più sulle best practice per l'AI responsabile e sui filtri di sicurezza dell'API Gemini, consulta la guida alle impostazioni di sicurezza.