Erdung mit Google Maps

Durch die Fundierung mit Google Maps werden die generativen Funktionen von Gemini mit den umfangreichen, faktischen und aktuellen Daten von Google Maps verknüpft. Mit dieser Funktion können Entwickler standortbezogene Funktionen ganz einfach in ihre Anwendungen einbinden. Wenn eine Nutzeranfrage einen Kontext mit Bezug auf Google Maps-Daten hat, nutzt das Gemini-Modell Google Maps, um faktisch korrekte und aktuelle Antworten zu geben, die für den angegebenen Standort oder den ungefähren Ort des Nutzers relevant sind.

• Genaue, standortbezogene Antworten:Nutzen Sie die umfangreichen und aktuellen Daten von Google Maps für geografisch spezifische Anfragen.
• Verbesserte Personalisierung:Empfehlungen und Informationen basierend auf den vom Nutzer angegebenen Standorten anpassen.
• Kontextbezogene Informationen und Widgets:Kontext-Tokens zum Rendern interaktiver Google Maps-Widgets neben generierten Inhalten.

Jetzt starten

In diesem Beispiel wird gezeigt, wie Sie die Fundierung mit Google Maps in Ihre Anwendung einbinden, um genaue, standortbezogene Antworten auf Nutzeranfragen zu geben. Der Prompt fragt nach lokalen Empfehlungen mit einem optionalen Nutzerstandort, sodass das Gemini-Modell Google Maps-Daten verwenden kann.

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

So funktioniert die Fundierung mit Google Maps

Bei der Fundierung mit Google Maps wird die Gemini API in das Google Geo-Ökosystem eingebunden, indem die Maps API als Fundierungsquelle verwendet wird. Wenn die Anfrage eines Nutzers geografischen Kontext enthält, kann das Gemini-Modell das Tool „Fundierung mit Google Maps“ aufrufen. Das Modell kann dann Antworten generieren, die auf Google Maps-Daten basieren, die für den angegebenen Standort relevant sind.

Der Prozess umfasst in der Regel folgende Schritte:

1. Nutzeranfrage:Ein Nutzer sendet eine Anfrage an Ihre Anwendung, die möglicherweise geografischen Kontext enthält (z.B. „Cafés in meiner Nähe“, „Museen in San Francisco“).
2. Toolaufruf:Das Gemini-Modell erkennt die geografische Absicht und ruft das Tool „Fundierung mit Google Maps“ auf. Optional können diesem Tool die latitude und longitude des Nutzers zur Verfügung gestellt werden. Das Tool ist ein textbasiertes Suchtool und verhält sich ähnlich wie die Suche in Google Maps. Bei lokalen Anfragen („in meiner Nähe“) werden die Koordinaten verwendet, während spezifische oder nicht lokale Anfragen wahrscheinlich nicht vom expliziten Standort beeinflusst werden.
3. Datenabruf:Der Dienst „Fundierung mit Google Maps“ fragt Google Maps nach relevanten Informationen ab (z.B. Orte, Rezensionen, Fotos, Adressen, Öffnungszeiten).
4. Fundierte Generierung:Die abgerufenen Maps-Daten werden verwendet, um die Antwort des Gemini-Modells zu informieren und so die faktische Richtigkeit und Relevanz zu gewährleisten.
5. Antwort- und Widget-Token:Das Modell gibt eine Textantwort zurück, die Quellenangaben zu Google Maps-Quellen enthält. Optional kann die API-Antwort auch ein google_maps_widget_context_token enthalten, mit dem Entwickler ein kontextbezogenes Google Maps-Widget in ihrer Anwendung für die visuelle Interaktion rendern können.

Gründe und Anwendungsfälle für die Fundierung mit Google Maps

Die Fundierung mit Google Maps ist ideal für Anwendungen, die genaue, aktuelle und standortspezifische Informationen erfordern. Sie verbessert die Nutzererfahrung, indem sie relevante und personalisierte Inhalte bereitstellt, die auf der umfangreichen Google Maps-Datenbank mit über 250 Millionen Orten weltweit basieren.

Sie sollten die Fundierung mit Google Maps verwenden, wenn Ihre Anwendung Folgendes tun muss:

• Vollständige und genaue Antworten auf geografisch spezifische Fragen geben
• Konversationelle Reiseplaner und lokale Reiseführer erstellen
• Sehenswürdigkeiten basierend auf dem Standort und den Nutzerpräferenzen wie Restaurants oder Geschäfte empfehlen
• Standortbezogene Erlebnisse für soziale Dienste, Einzelhandel oder Essenslieferdienste erstellen

Die Fundierung mit Google Maps eignet sich besonders für Anwendungsfälle, in denen Nähe und aktuelle faktenbasierte Daten entscheidend sind, z. B. bei der Suche nach dem „besten Café in meiner Nähe“ oder bei der Routenplanung.

API-Methoden und -Parameter

Die Fundierung mit Google Maps wird über die Gemini API als Tool in der generateContent Methode verfügbar gemacht. Sie aktivieren und konfigurieren die Fundierung mit Google Maps, indem Sie ein googleMaps-Objekt in den tools-Parameter Ihrer Anfrage einfügen.

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

Das googleMaps Tool kann zusätzlich einen booleschen enableWidget Parameter akzeptieren, mit dem gesteuert wird, ob das googleMapsWidgetContextToken Feld in der Antwort zurückgegeben wird. Damit kann ein kontextbezogenes Places-Widget angezeigt werden.

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

Außerdem unterstützt das Tool die Übergabe des Kontextstandorts als toolConfig.

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

Antwort zur Fundierung verstehen

Wenn eine Antwort erfolgreich mit Google Maps-Daten fundiert wurde, enthält sie ein groundingMetadata Feld. Diese strukturierten Daten sind wichtig, um Behauptungen zu überprüfen und eine umfassende Zitation in Ihrer Anwendung zu erstellen sowie die Anforderungen an die Dienstnutzung zu erfüllen.

{
  "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/..."
      }
    }
  ]
}

Die Gemini API gibt die folgenden Informationen mit der groundingMetadata zurück:

• groundingChunks: Array von Objekten, die die maps-Quellen (uri, placeId und title) enthalten.
• groundingSupports: Array von Chunks, um den Antworttext des Modells mit den Quellen in groundingChunks zu verknüpfen. Jeder Chunk verknüpft einen Textbereich (definiert durch startIndex und endIndex) mit einem oder mehreren groundingChunkIndices. Dies ist der Schlüssel zum Erstellen von Inline-Quellenangaben.
• googleMapsWidgetContextToken: Ein Text-Token, mit dem ein kontextbezogenes Places-Widget gerendert werden kann.

Ein Code-Snippet zum Rendern von Inline-Quellenangaben im Text finden Sie im the Beispiel in der Dokumentation zur Fundierung mit der Google Suche.

Kontextbezogenes Google Maps-Widget anzeigen

Um das zurückgegebene googleMapsWidgetContextToken zu verwenden, müssen Sie die Google Maps JavaScript API laden.

Anwendungsfälle

Die Fundierung mit Google Maps unterstützt eine Vielzahl von standortbezogenen Anwendungsfällen. In den folgenden Beispielen wird gezeigt, wie verschiedene Prompts und Parameter die Fundierung mit Google Maps nutzen können. Informationen in den fundierten Google Maps-Ergebnissen können von den tatsächlichen Bedingungen abweichen.

Ortsbezogene Fragen bearbeiten

Stellen Sie detaillierte Fragen zu einem bestimmten Ort, um Antworten zu erhalten, die auf Google-Nutzerrezensionen und anderen Google Maps-Daten basieren.

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

Standortbezogene Personalisierung bereitstellen

Erhalten Sie Empfehlungen, die auf die Präferenzen eines Nutzers und eine bestimmte geografische Region zugeschnitten sind.

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

Bei der Reiseplanung helfen

Erstellen Sie mehrtägige Pläne mit Wegbeschreibungen und Informationen zu verschiedenen Orten, die sich perfekt für Reiseanwendungen eignen.

In diesem Beispiel wurde das googleMapsWidgetContextToken angefordert, indem das Widget im Google Maps-Tool aktiviert wurde. Wenn es aktiviert ist, kann das zurückgegebene Token verwendet werden, um mit dem <gmp-places-contextual> component aus der Google Maps JavaScript API ein kontextbezogenes Places-Widget zu rendern.

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

Wenn das Widget gerendert wird, sieht es etwa so aus:

Anforderungen an die Dienstnutzung

In diesem Abschnitt werden die Anforderungen an die Dienstnutzung für die Fundierung mit Google Maps beschrieben.

Nutzer über die Verwendung von Google Maps-Quellen informieren

Mit jedem fundierten Google Maps-Ergebnis erhalten Sie Quellen in groundingChunks, die jede Antwort unterstützen. Außerdem werden die folgenden Metadaten zurückgegeben:

• Quell-URI
• Titel
• ID

Wenn Sie Ergebnisse aus der Fundierung mit Google Maps präsentieren, müssen Sie die zugehörigen Google Maps-Quellen angeben und Ihre Nutzer über Folgendes informieren:

• Die Google Maps-Quellen müssen direkt auf den generierten Inhalt folgen, den sie unterstützen. Dieser generierte Inhalt wird auch als fundiertes Google Maps-Ergebnis bezeichnet.
• Die Google Maps-Quellen müssen innerhalb einer Nutzerinteraktion sichtbar sein.

Google Maps-Quellen mit Google Maps-Links anzeigen

Für jede Quelle in groundingChunks und in grounding_chunks.maps.placeAnswerSources.reviewSnippets muss eine Linkvorschau gemäß den folgenden Anforderungen generiert werden:

• Geben Sie jede Quelle gemäß den Richtlinien für die Quellenangabe durch Google Maps-Text als Google Maps-Quelle an.
• Zeigen Sie den in der Antwort angegebenen Quelltitel an.
• Verlinken Sie die Quelle mit der uri oder googleMapsUri aus der Antwort.

Diese Bilder zeigen die Mindestanforderungen für die Anzeige der Quellen und Google Maps-Links.

Sie können die Ansicht der Quellen minimieren.

Optional: Sie können die Linkvorschau mit zusätzlichen Inhalten erweitern, z. B.:

• Vor der Quellenangabe durch Google Maps-Text wird ein Google Maps-Favicon eingefügt.
• Ein Foto aus der Quell-URL (og:image).

Weitere Informationen zu einigen unserer Google Maps-Datenanbieter und ihren Lizenzbedingungen finden Sie in den rechtlichen Hinweisen zu Google Maps und Google Earth.

Richtlinien für die Quellenangabe durch Google Maps-Text

Wenn Sie Quellen in Texten Google Maps zuordnen, beachten Sie die folgenden Richtlinien:

• Ändern Sie den Text „Google Maps“ in keiner Weise:
  • Ändern Sie die Groß- und Kleinschreibung von „Google Maps“ nicht.
  • Fügen Sie keinen Zeilenumbruch in „Google Maps“ ein.
  • Lokalisieren Sie „Google Maps“ nicht in eine andere Sprache.
  • Verhindern Sie, dass Browser „Google Maps“ übersetzen, indem Sie das HTML-Attribut „translate="no"“ verwenden.
• Formatieren Sie den Text „Google Maps“ wie in der folgenden Tabelle beschrieben:

Beispiel-CSS

Mit dem folgenden CSS wird „Google Maps“ mit dem entsprechenden typografischen Stil und der entsprechenden Farbe auf einem weißen oder hellen Hintergrund gerendert.

@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;
}

Kontext-Token, Orts-ID und Rezensions-ID

Die Google Maps-Daten enthalten Kontext-Token, Orts-ID und Rezensions-ID. Sie können die folgenden Antwortdaten im Cache speichern, speichern und exportieren:

• googleMapsWidgetContextToken
• placeId
• reviewId

Die Einschränkungen für das Caching in den Nutzungsbedingungen für die Fundierung mit Google Maps gelten nicht.

Unzulässige Aktivitäten und Gebiete

Für die Fundierung mit Google Maps gelten zusätzliche Einschränkungen für bestimmte Inhalte und Aktivitäten, um eine sichere und zuverlässige Plattform zu gewährleisten. Zusätzlich zu den in den Nutzungsbedingungen aufgeführten Einschränkungen gilt Folgendes:

• Sie dürfen die Fundierung mit Google Maps nicht für hochriskante Aktivitäten verwenden, einschließlich Notfalldiensten.

• Sie dürfen Ihre Anwendung, die die Fundierung mit Google Maps anbietet, nicht in einem verbotenen Gebiet vertreiben oder bewerben. Die derzeit verbotenen Gebiete sind:

  • China
  • Krim
  • Kuba
  • Volksrepublik Donezk
  • Iran
  • Volksrepublik Lugansk
  • Nordkorea
  • Syrien
  • Vietnam

  Diese Liste kann gelegentlich aktualisiert werden.

Best Practices

• Nutzerstandort angeben:Um die relevantesten und personalisierten Antworten zu erhalten, geben Sie in Ihrer googleMapsGrounding-Konfiguration immer den user_location (Breitengrad und Längengrad) an, wenn der Standort des Nutzers bekannt ist.
• Kontextbezogenes Google Maps-Widget rendern:Das kontextbezogene Widget wird mit dem Kontext-Token googleMapsWidgetContextToken gerendert, das in der Gemini API-Antwort zurückgegeben wird und mit dem visuelle Inhalte aus Google Maps gerendert werden können. Weitere Informationen zum kontextbezogenen Widget finden Sie im Entwicklerleitfaden für Google Maps unter Widget für die Fundierung mit Google Maps.
• Endnutzer informieren:Informieren Sie Ihre Endnutzer deutlich darüber, dass Google Maps-Daten verwendet werden, um ihre Anfragen zu beantworten, insbesondere wenn das Tool aktiviert ist.
• Latenz überwachen:Bei konversationellen Anwendungen muss die P95-Latenz für fundierte Antworten innerhalb akzeptabler Grenzwerte bleiben, um eine reibungslose Nutzererfahrung zu gewährleisten.
• Deaktivieren, wenn nicht erforderlich:Die Fundierung mit Google Maps ist standardmäßig deaktiviert. Aktivieren Sie sie nur ("tools": [{"googleMaps": {}}]), wenn eine Anfrage einen eindeutigen geografischen Kontext hat, um Leistung und Kosten zu optimieren.

Beschränkungen

• Geografischer Umfang:Die Fundierung mit Google Maps ist weltweit verfügbar.
• Modellunterstützung: Weitere Informationen finden Sie im Abschnitt Unterstützte Modelle.
• Multimodale Eingaben/Ausgaben:Die Fundierung mit Google Maps unterstützt derzeit keine multimodalen Eingaben oder Ausgaben über Text und kontextbezogene Karten-Widgets hinaus.
• Standardstatus:Das Tool „Fundierung mit Google Maps“ ist standardmäßig deaktiviert. Sie müssen es in Ihren API-Anfragen explizit aktivieren.

Preise und Ratenlimits

Die Preise für die Fundierung mit Google Maps basieren auf Anfragen. Der aktuelle Preis beträgt 25 $ pro 1.000 fundierte Prompts. Im kostenlosen Kontingent sind außerdem bis zu 500 Anfragen pro Tag verfügbar. Eine Anfrage wird nur auf das Kontingent angerechnet, wenn ein Prompt mindestens ein fundiertes Google Maps-Ergebnis zurückgibt (d.h. Ergebnisse, die mindestens eine Google Maps-Quelle enthalten). Wenn mehrere Anfragen aus einer einzelnen Anfrage an Google Maps gesendet werden, zählt dies als eine Anfrage für das Ratenlimit.

Ausführliche Informationen zu den Preisen finden Sie auf der Seite Gemini API-Preise.

Unterstützte Modelle

Die folgenden Modelle unterstützen die Fundierung mit Google Maps:

Unterstützte Toolkombinationen

Gemini 3-Modelle unterstützen die Kombination von integrierten Tools (z. B. Fundierung mit Google Maps) mit benutzerdefinierten Tools (Funktionsaufruf). Weitere Informationen finden Sie auf der Seite Toolkombinationen.

Nächste Schritte

• Probieren Sie die Fundierung mit der Google Suche in der Gemini API Cookbook aus.
• Weitere Informationen zu anderen verfügbaren Tools.
• Weitere Informationen zu Best Practices für die verantwortungsbewusste Anwendung von KI und den Sicherheitsfiltern der Gemini API finden Sie unter Sicherheitseinstellungen.