Erdung mit Google Maps

Durch die Fundierung mit Google Maps werden die generativen Funktionen von Gemini mit den umfangreichen, faktenbasierten und aktuellen Daten von Google Maps verbunden. Mit dieser Funktion können Entwickler ganz einfach standortbezogene Funktionen in ihre Anwendungen einbinden. Wenn eine Nutzeranfrage einen Kontext hat, der sich auf Google Maps-Daten bezieht, nutzt das Gemini-Modell Google Maps, um sachlich korrekte und aktuelle Antworten zu liefern, die für den vom Nutzer angegebenen Ort oder den ungefähren Ort 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 werden basierend auf den von Nutzern angegebenen Standorten angepasst.
  • Kontextbezogene Informationen und Widgets:Kontext-Tokens zum Rendern interaktiver Google Maps-Widgets neben generierten Inhalten.

Jetzt starten

In diesem Beispiel wird gezeigt, wie Sie Fundierung mit Google Maps in Ihre Anwendung einbinden, um genaue, standortbezogene Antworten auf Nutzeranfragen zu geben. Im Prompt wird nach lokalen Empfehlungen gefragt, wobei der Standort des Nutzers optional angegeben werden kann. So kann das Gemini-Modell Google Maps-Daten verwenden.

Python

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview",
    input="What are the best Italian restaurants within a 15-minute walk from here?",
    tools=[{
        "type": "google_maps",
        "latitude": 34.050481,
        "longitude": -118.248526
    }]
)

# Print the model's text response and annotations
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)
                if content_block.annotations:
                    print("\nSources:")
                    for annotation in content_block.annotations:
                        if annotation.type == "place_citation":
                            print(f"  - {annotation.name}: {annotation.url}")

JavaScript

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

const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "What are the best Italian restaurants within a 15-minute walk from here?",
    tools: [{
      type: "google_maps",
      latitude: 34.050481,
      longitude: -118.248526
    }]
  });

  // Print the model's text response and annotations
  for (const step of interaction.steps) {
    if (step.type === 'model_output') {
      for (const contentBlock of step.content) {
        if (contentBlock.type === 'text') {
          console.log(contentBlock.text);
          if (contentBlock.annotations) {
            console.log("\nSources:");
            for (const annotation of contentBlock.annotations) {
              if (annotation.type === 'place_citation') {
                console.log(`  - ${annotation.name}: ${annotation.url}`);
              }
            }
          }
        }
      }
    }
  }
}

main();

REST

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "What are the best Italian restaurants within a 15-minute walk from here?",
    "tools": [{
      "type": "google_maps",
      "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 Ort relevant sind.

Dazu sind in der Regel folgende Schritte erforderlich:

  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. Tool-Aufruf:Das Gemini-Modell erkennt die geografische Intention und ruft das Tool „Fundierung mit Google Maps“ auf. Optional können dem Tool die latitude und longitude des Nutzers zur Verfügung gestellt werden. Das Tool ist ein textbasiertes Suchtool und funktioniert ähnlich wie die Suche in 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. nach Orten, Rezensionen, Fotos, Adressen und Öffnungszeiten.
  4. Fundierte Generierung:Die abgerufenen Maps-Daten werden verwendet, um die Antwort des Gemini-Modells zu fundieren und so für faktische Richtigkeit und Relevanz zu sorgen.
  5. Antwort und Anmerkungen:Das Modell gibt eine Textantwort mit Inline-Anmerkungen zurück, die auf Google Maps-Quellen verweisen. So können Entwickler Zitationen anzeigen und optional ein kontextbezogenes Google Maps-Widget rendern.

Fundierung mit Google Maps – warum und wann

Die Fundierung mit Google Maps ist ideal für Anwendungen, die genaue, aktuelle und standortspezifische Informationen erfordern. Die Nutzerfreundlichkeit wird durch relevante und personalisierte Inhalte verbessert, 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 benötigt:

  • Geben Sie vollständige und korrekte Antworten auf standortbezogene Fragen.
  • Dialogorientierte Reiseplaner und lokale Reiseführer erstellen
  • Empfehlungen für POIs basierend auf Standort und Nutzerpräferenzen wie Restaurants oder Geschäfte
  • Standortbezogene Funktionen für soziale Netzwerke, Einzelhandel oder Essenslieferdienste entwickeln

Die Fundierung mit Google Maps eignet sich besonders für Anwendungsfälle, in denen Nähe und aktuelle Fakten entscheidend sind, z. B. wenn Sie nach dem „besten Café in meiner Nähe“ suchen oder eine Wegbeschreibung benötigen.

Anwendungsfälle

Die Fundierung mit Google Maps unterstützt eine Vielzahl von standortbezogenen Anwendungsfällen.

Ortsbezogene Fragen beantworten

Sie können detaillierte Fragen zu einem bestimmten Ort stellen und erhalten Antworten, die auf Google-Nutzerrezensionen und anderen Maps-Daten basieren.

Python

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview",
    input="Is there a cafe near the corner of 1st and Main that has outdoor seating?",
    tools=[{
        "type": "google_maps",
        "latitude": 34.050481,
        "longitude": -118.248526
    }]
)

for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)
                if content_block.annotations:
                    print("\nSources:")
                    for annotation in content_block.annotations:
                        if annotation.type == "place_citation":
                            print(f"  - {annotation.name}: {annotation.url}")

JavaScript

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

const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Is there a cafe near the corner of 1st and Main that has outdoor seating?",
    tools: [{
      type: "google_maps",
      latitude: 34.050481,
      longitude: -118.248526
    }]
  });

  for (const step of interaction.steps) {
    if (step.type === 'model_output') {
      for (const contentBlock of step.content) {
        if (contentBlock.type === 'text') {
          console.log(contentBlock.text);
          if (contentBlock.annotations) {
            console.log("\nSources:");
            for (const annotation of contentBlock.annotations) {
              if (annotation.type === 'place_citation') {
                console.log(`  - ${annotation.name}: ${annotation.url}`);
              }
            }
          }
        }
      }
    }
  }
}

main();

Standortbezogene Personalisierung

Empfehlungen erhalten, die auf die Vorlieben eines Nutzers und eine bestimmte geografische Region zugeschnitten sind.

Python

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview",
    input="Which family-friendly restaurants near here have the best playground reviews?",
    tools=[{
        "type": "google_maps",
        "latitude": 30.2672,
        "longitude": -97.7431
    }]
)

for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)
                if content_block.annotations:
                    print("\nSources:")
                    for annotation in content_block.annotations:
                        if annotation.type == "place_citation":
                            print(f"  - {annotation.name}: {annotation.url}")

JavaScript

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

const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Which family-friendly restaurants near here have the best playground reviews?",
    tools: [{
      type: "google_maps",
      latitude: 30.2672,
      longitude: -97.7431
    }]
  });

  for (const step of interaction.steps) {
    if (step.type === 'model_output') {
      for (const contentBlock of step.content) {
        if (contentBlock.type === 'text') {
          console.log(contentBlock.text);
          if (contentBlock.annotations) {
            console.log("\nSources:");
            for (const annotation of contentBlock.annotations) {
              if (annotation.type === 'place_citation') {
                console.log(`  - ${annotation.name}: ${annotation.url}`);
              }
            }
          }
        }
      }
    }
  }
}

main();

Unterstützung bei der Reiseplanung

Sie können mehrtägige Pläne mit Wegbeschreibungen und Informationen zu verschiedenen Orten erstellen, die sich ideal für Reise-Apps eignen.

Python

from google import genai

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."

interaction = client.interactions.create(
    model="gemini-3-flash-preview",
    input=prompt,
    tools=[{
        "type": "google_maps",
        "latitude": 37.78193,
        "longitude": -122.40476,
        "enable_widget": True
    }]
)
# ... code to process response and widget token

JavaScript

const interaction = await client.interactions.create({
    model: 'gemini-3-flash-preview',
    input: '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: [{
      type: "google_maps",
      latitude: 37.78193,
      longitude: -122.40476,
      enableWidget: true
    }],
});

REST

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "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": [{
      "type": "google_maps",
      "latitude": 37.78193,
      "longitude": -122.40476,
      "enable_widget": true
    }]
  }'

Anforderungen an die Dienstnutzung

In diesem Abschnitt werden die Anforderungen für die Nutzung von Grounding mit Google Maps beschrieben.

Nutzer über die Verwendung von Google Maps-Quellen informieren

Für jedes auf Fakten basierende Google Maps-Ergebnis erhalten Sie Quellennachweise in den Inhaltsblöcken des Schritts model_output, die jede Antwort untermauern. Die folgenden Metadaten werden zurückgegeben:

  • Quell-URL
  • name

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 die generierten Inhalte folgen, die durch die Quellen belegt werden. Diese generierten Inhalte werden auch als „Google Maps Grounded Result“ bezeichnet.
  • Die Google Maps-Quellen müssen innerhalb einer Nutzerinteraktion sichtbar sein.

Google Maps-Quellen mit Google Maps-Links anzeigen

Für jede Quellannotation muss eine Linkvorschau generiert werden, die den folgenden Anforderungen entspricht:

  • Geben Sie für jede Quelle Google Maps als Quelle an. Halten Sie sich dabei an die Richtlinien für die Quellenangabe von Text.
  • Zeigen Sie den in der Antwort angegebenen Quellennamen an.
  • Verlinken Sie die Quelle mit url aus der Annotation.

Richtlinien für die Quellenangabe als Text in Google Maps

Wenn Sie Quellen in Text Google Maps zuordnen, müssen Sie die folgenden Richtlinien beachten:

  • Ändern Sie den Text „Google Maps“ nicht:
    • Ändern Sie die Groß- und Kleinschreibung von Google Maps nicht.
    • Fügen Sie keinen Zeilenumbruch in Google Maps ein.
    • Google Maps darf nicht in eine andere Sprache lokalisiert werden.
    • Verhindern, dass Browser Google Maps übersetzen, indem Sie das HTML-Attribut translate="no" verwenden.

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

Best Practices

  • Nutzerstandort angeben:Für die relevantesten und personalisierten Antworten sollten Sie immer latitude und longitude in Ihre google_maps-Toolkonfiguration aufnehmen, wenn der Standort des Nutzers bekannt ist.
  • Kontextbezogenes Google Maps-Widget rendern:Das kontextbezogene Widget wird mit dem Kontext-Token google_maps_widget_context_token gerendert, das in der Gemini API-Antwort zurückgegeben wird und zum Rendern visueller Inhalte aus Google Maps verwendet werden kann.
  • 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.
  • Bei Bedarf aktivieren:Die Fundierung mit Google Maps ist standardmäßig deaktiviert. Aktivieren Sie die Funktion ("tools": [{"type": "google_maps"}]) nur, wenn eine Abfrage einen eindeutigen geografischen Kontext hat, um Leistung und Kosten zu optimieren.

Beschränkungen

  • Die Fundierung mit Google Maps unterstützt derzeit nur Prompts und Antworten in englischer Sprache.
  • Das Tool ist möglicherweise nicht in allen Regionen verfügbar.
  • Die Ergebnisse können je nach Standortgenauigkeit und verfügbaren Maps-Daten variieren.
  • Geografischer Umfang:Die Fundierung mit Google Maps ist weltweit verfügbar.
  • Standardstatus:Das Tool „Fundierung mit Google Maps“ ist standardmäßig deaktiviert. Sie müssen sie in Ihren API-Anfragen explizit aktivieren.

Preise und Ratenbegrenzungen

Die Fundierung mit Google Maps wird anhand von Anfragen abgerechnet. Der aktuelle Preis beträgt 25 $ pro 1.000 fundierte Prompts. In der kostenlosen Stufe sind bis zu 500 Anfragen pro Tag verfügbar. Eine Anfrage wird nur dann auf das Kontingent angerechnet, wenn für einen Prompt mindestens ein Google Maps-basiertes Ergebnis zurückgegeben wird, d.h. Ergebnisse, die mindestens eine Google Maps-Quelle enthalten. Wenn mehrere Anfragen in einer einzigen Anfrage an Google Maps gesendet werden, zählt dies als eine Anfrage für das Ratenlimit.

Detaillierte Preisinformationen finden Sie auf der Seite „Gemini API-Preise“.

Unterstützte Modelle

Die folgenden Modelle unterstützen Fundierung mit Google Maps:

Modell Fundierung mit Google Maps
Gemini 3.1 Pro (Vorabversion) ✔️
Gemini 3.1 Flash Lite ✔️
Gemini 3.1 Flash Lite (Vorschau) ✔️
Gemini 3 Flash (Vorabversion) ✔️
Gemini 2.5 Pro ✔️
Gemini 2.5 Flash ✔️
Gemini 2.5 Flash Lite ✔️
Gemini 2.0 Flash ✔️

Unterstützte Tool-Kombinationen

Gemini 3-Modelle unterstützen die Kombination von integrierten Tools (z. B. Grounding mit Google Maps) mit benutzerdefinierten Tools (Funktionsaufruf). Weitere Informationen zu Tool-Kombinationen

Nächste Schritte