עיגון בעזרת מפות Google

העיגון באמצעות מפות Google מחבר את היכולות הגנרטיביות של Gemini לנתונים העשירים, העובדתיים והעדכניים של מפות Google. התכונה הזו מאפשרת למפתחים לשלב בקלות באפליקציות שלהם פונקציונליות שמבוססת על מיקום. כששאילתה של משתמש מכילה הקשר שקשור לנתונים של מפות Google, מודל Gemini משתמש במפות Google כדי לספק תשובות עדכניות ומדויקות מבחינה עובדתית שרלוונטיות למיקום או לאזור הכללי שצוינו על ידי המשתמש.

  • תשובות מדויקות שמודעות למיקום: תוכלו להשתמש בנתונים המקיפים והעדכניים של מפות Google כדי לקבל תשובות לשאלות ספציפיות לגבי מיקומים גיאוגרפיים.
  • התאמה אישית משופרת: התאמת ההמלצות והמידע על סמך מיקומים שהמשתמשים סיפקו.

שנתחיל?

בדוגמה הזו אפשר לראות איך לשלב את התכונה 'עיגון בעזרת מפות Google' באפליקציה כדי לספק תשובות מדויקות לשאילתות של משתמשים, בהתאם למיקום שלהם. ההנחיה מבקשת המלצות מקומיות עם מיקום משתמש אופציונלי, ומאפשרת למודל Gemini להשתמש בנתונים של מפות Google.

Python

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.8-flash',
    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})')

JavaScript

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

const ai = new GoogleGenAI({});

async function generateContentWithMapsGrounding() {
  const response = await ai.models.generateContent({
    model: "gemini-3.8-flash",
    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();

REST

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash: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}
    }
  }
}'

איך פועל העיגון בעזרת מפות Google

עיגון בעזרת מפות Google משלב את Gemini API עם המערכת האקולוגית של Google Geo באמצעות Maps API כמקור לעיגון. כששאילתה של משתמש מכילה הקשר גיאוגרפי, מודל Gemini יכול להפעיל את הכלי 'עיגון באמצעות מפות Google'. לאחר מכן המודל יכול ליצור תשובות שמבוססות על נתונים ממפות Google שרלוונטיים למיקום שצוין.

התהליך בדרך כלל כולל:

  1. שאילתת משתמש: משתמש שולח שאילתה לאפליקציה שלכם, שיכולה לכלול הקשר גיאוגרפי (לדוגמה, "בתי קפה בסביבה שלי", "מוזיאונים בסן פרנסיסקו").
  2. הפעלת כלי: מודל Gemini, שמזהה את הכוונה הגיאוגרפית, מפעיל את הכלי עיגון בעזרת מפות Google. אפשר גם לספק לכלי הזה את latitude וlongitude של המשתמש. הכלי הוא כלי חיפוש טקסטואלי שפועל באופן דומה לחיפוש במפות Google. כלומר, שאילתות מקומיות (למשל, 'בסביבה שלי') ישתמשו בקואורדינטות, בעוד ששאילתות ספציפיות או לא מקומיות לא יושפעו מהמיקום המפורש.
  3. אחזור נתונים: שירות ה-עיגון בעזרת מפות Google שולח שאילתות למפות Google כדי לקבל מידע רלוונטי (לדוגמה, מקומות, ביקורות, תמונות, כתובות, שעות פתיחה).
  4. יצירה מבוססת-קרקע: נתוני המפות שאוחזרו משמשים כדי לספק מידע לתשובה של מודל Gemini, וכך לוודא שהיא מדויקת ועניינית.
  5. תשובה: המודל מחזיר תשובת טקסט, שכוללת ציטוטים ממקורות במפות Google.

למה ומתי כדאי להשתמש בעיגון בעזרת מפות Google

עיגון בעזרת מפות Google מתאים במיוחד לאפליקציות שנדרש בהן מידע מדויק, עדכני וספציפי למיקום. הוא משפר את חוויית המשתמש באמצעות תוכן רלוונטי ומותאם אישית שמבוסס על מסד הנתונים הנרחב של מפות Google, שכולל יותר מ-250 מיליון מקומות ברחבי העולם.

כדאי להשתמש בעיגון בעזרת מפות Google כשהאפליקציה צריכה:

  • חשוב לענות על השאלות בצורה מקיפה ומדויקת.
  • פיתוח כלים לשיחה לתכנון טיולים ומדריכים מקומיים.
  • להמליץ על נקודות עניין על סמך מיקום והעדפות משתמש, כמו מסעדות או חנויות.
  • ליצור חוויות מודעות למיקום עבור שירותים חברתיים, קמעונאיים או משלוחי אוכל.

עיגון בעזרת מפות Google מצטיין בתרחישי שימוש שבהם נתונים עובדתיים עדכניים וקירבה הם קריטיים, כמו חיפוש של "בית הקפה הכי טוב בסביבה שלי" או קבלת הוראות הגעה.

פרמטרים ושיטות API

העיגון בעזרת מפות Google נחשף דרך Gemini API ככלי בשיטה generateContent. כדי להפעיל ולהגדיר עיגון בעזרת מפות Google, צריך לכלול אובייקט googleMaps בפרמטר tools של הבקשה.

JSON

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

בנוסף, הכלי תומך בהעברת המיקום ההקשרי כ-toolConfig.

JSON

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

הסבר על תשובת העיגון

כשמקרקעים תשובה בהצלחה באמצעות נתונים של מפות Google, התשובה כוללת את השדה groundingMetadata. הנתונים המובנים האלה חיוניים לאימות טענות ולבניית חוויית ציטוט עשירה באפליקציה, וגם לעמידה בדרישות השימוש בשירות.

JSON

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

‫Gemini API מחזיר את המידע הבא עם groundingMetadata:

  • ‫groundingChunks: מערך של אובייקטים שמכילים את מקורות maps (uri,‏ placeId ו-title).
  • ‫groundingSupports: מערך של מקטעים לחיבור טקסט התגובה של המודל למקורות ב-groundingChunks. כל מקטע מקשר בין טווח טקסט (מוגדר על ידי startIndex ו-endIndex) לבין groundingChunkIndices אחד או יותר. זהו המפתח ליצירת ציטוטים מוטמעים.

דוגמה לקטע קוד שמראה איך לרנדר ציטוטים מוטבעים בטקסט מופיעה במאמר בנושא עיגון באמצעות חיפוש Google.

תרחישים לדוגמה

עיגון בעזרת מפות Google תומך במגוון תרחישי שימוש שמתבססים על מיקום. הדוגמאות הבאות מוסברות איך אפשר להשתמש בהנחיות ובפרמטרים שונים כדי למנף את עיגון בעזרת מפות Google. יכול להיות שהמידע בתוצאות המבוססות על נתונים ממפות Google יהיה שונה מהמצב בפועל.

איך עונים על שאלות ספציפיות לגבי מקומות

אתם יכולים לשאול שאלות מפורטות על מקום ספציפי ולקבל תשובות שמבוססות על ביקורות של משתמשי Google ועל נתונים אחרים במפות Google.

Python

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.8-flash',
    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})')
  ```

JavaScript

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.8-flash',
    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();

REST

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash: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}
    }
  }
}'

התאמה אישית לפי מיקום

לקבל המלצות שמותאמות להעדפות של משתמשים ולאזור גיאוגרפי ספציפי.

Python

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.8-flash',
    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})')

JavaScript

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.8-flash',
    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();

REST

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash: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}
    }
  }
}'

עזרה בתכנון מסלול

ליצור תוכניות לכמה ימים עם הוראות הגעה ומידע על מיקומים שונים, מושלם לאפליקציות נסיעות.

Python

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.8-flash',
    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 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})')

JavaScript

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.8-flash',
    contents: prompt,
    config: {
      tools: [{googleMaps: {}}],
      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})`);
        }
      }
    }
  }
}

run();

REST

curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash: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": {}}],
  "toolConfig": {
    "retrievalConfig": {
    "latLng": {"latitude": 37.78193, "longitude": -122.40476}
  }
  }
}'

דרישות לשימוש בשירות

בקטע הזה מתוארות הדרישות לשימוש בשירות Grounding with Google Maps.

לעדכן את המשתמש לגבי השימוש במקורות של מפות Google

לכל תוצאה במפות Google שמבוססת על מקורות מידע, תקבלו מקורות מידע בפורמט groundingChunks שתומכים בכל תשובה. מוחזרים גם המטא-נתונים הבאים:

  • ‫URI במקור
  • title
  • מזהה

כשמציגים תוצאות מ-עיגון בעזרת מפות Google, צריך לציין את המקורות המשויכים במפות Google ולעדכן את המשתמשים לגבי הדברים הבאים:

  • מקורות המידע של מפות Google צריכים להופיע מיד אחרי התוכן שנוצר, אם הם תומכים בו. התוכן שנוצר נקרא גם תוצאה מבוססת-קרקע ב-Google Maps.
  • מקורות המידע במפות Google צריכים להיות גלויים במהלך אינטראקציה אחת של המשתמש.

הצגת מקורות של מפות Google עם קישורים למפות Google

לכל מקור ב-groundingChunks וב-grounding_chunks.maps.placeAnswerSources.reviewSnippets, צריך ליצור תצוגה מקדימה של הקישור בהתאם לדרישות הבאות:

  • צריך לשייך כל מקור למפות Google בהתאם להנחיות לשיוך של מפות Google.
  • הצגת שם המקור שצוין בתשובה.
  • לוחצים על הסמל uri או googleMapsUri בתשובה כדי לקשר למקור.

בתמונות האלה מוצגות הדרישות המינימליות להצגת המקורות והקישורים למפות Google.

פרומפט עם תגובה שכוללת מקורות

אפשר לכווץ את התצוגה של המקורות.

פרומפט עם תשובה ומקורות במצב מכווץ

אופציונלי: אפשר להוסיף לקישור תצוגה מקדימה עם תוכן נוסף, כמו:

מידע נוסף על חלק מספקי הנתונים של מפות Google ועל תנאי הרישיון שלהם מופיע בהודעות המשפטיות של מפות Google ו-Google Earth.

הנחיות לציון מקורות במפות Google

כשמציינים את המקורות במפות Google בטקסט, צריך לפעול לפי ההנחיות הבאות:

  • אל תשנו את הטקסט 'מפות Google' בשום צורה:
    • אל תשנו את האותיות הרישיות במפות Google.
    • אל תעבירו את מפות Google לכמה שורות.
    • לא לתרגם את מפות Google לשפה אחרת.
    • כדי למנוע מדפדפנים לתרגם את מפות Google, משתמשים בתכונה translate="no" של HTML.
  • מעצבים את הטקסט במפות Google לפי ההנחיות שבטבלה הבאה:
נכס סגנון
Font family Roboto. טעינת הגופן היא אופציונלית.
Fallback font family כל גופן sans serif שמשמש כבר במוצר או 'Sans-Serif' כדי להפעיל את גופן המערכת שמוגדר כברירת מחדל
Font style רגיל
Font weight 400
Font color לבן, שחור (‎#1F1F1F) או אפור (‎#5E5E5E). לשמור על ניגודיות נגישה (4.5:1) ביחס לרקע.
Font size
  • גודל גופן מינימלי: 12sp
  • גודל גופן מקסימלי: 16sp
  • מידע נוסף על יחידות sp זמין במאמר בנושא יחידות גודל גופן באתר Material Design.
Spacing רגיל

דוגמה ל-CSS

קוד ה-CSS הבא מעבד את מפות Google עם סגנון טיפוגרפי וצבע מתאימים על רקע לבן או בהיר.

CSS

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

מזהה מקום ומזהה ביקורת

הנתונים ממפות Google כוללים את מזהה המקום ומזהה הביקורת. יכול להיות שתשמרו במטמון, תאחסנו ותייצאו את נתוני התשובות הבאים:

  • placeId
  • reviewId

המגבלות נגד שמירה במטמון שמפורטות בתנאים של עיגון בעזרת מפות Google לא חלות.

פעילות אסורה ואזור אסור

כדי לשמור על פלטפורמה בטוחה ומהימנה, יש הגבלות נוספות על תוכן ופעילויות מסוימים ב-Grounding עם מפות Google. בנוסף להגבלות השימוש שמפורטות בתנאים:

  • לא תשתמשו ב-Grounding עם מפות Google לפעילויות בסיכון גבוה, כולל שירותי תגובה למקרי חירום.
  • לא תפיצו או תשווקו את האפליקציה שלכם שמציעה Grounding עם מפות Google באזור אסור. מידע נוסף זמין במאמר בנושא אזורים אסורים ב-Google Maps Platform. רשימת הטריטוריות האסורות עשויה להתעדכן מעת לעת.

שיטות מומלצות

  • ציון מיקום המשתמש: כדי לקבל תשובות רלוונטיות ומותאמות אישית, תמיד צריך לכלול את user_location (קו רוחב וקו אורך) בהגדרה של googleMapsGrounding כשמיקום המשתמש ידוע.
  • ליידע את משתמשי הקצה: חשוב ליידע את משתמשי הקצה בצורה ברורה שנתוני מפות Google משמשים למענה על השאילתות שלהם, במיוחד כשהכלי מופעל.
  • מעקב אחרי זמן האחזור: באפליקציות שיש בהן ממשק שיחה, חשוב לוודא שזמן האחזור של תגובות מעוגנות (P95) נשאר בגבולות הסבירים כדי לשמור על חוויית משתמש חלקה.
  • השבתה כשלא צריך: עיגון בעזרת מפות Google מושבת כברירת מחדל. כדי לשפר את הביצועים ולצמצם את העלויות, מפעילים את האפשרות הזו ("tools": [{"googleMaps": {}}]) רק כששאילתה כוללת הקשר גיאוגרפי ברור.

מגבלות

  • היקף גיאוגרפי: עיגון בעזרת מפות Google זמין בכל העולם
  • תמיכה במודלים: מידע נוסף זמין בקטע מודלים נתמכים.
  • קלט ופלט מולטימודאליים: בשלב הזה, ההצמדה למציאות באמצעות מפות Google לא תומכת בקלט או בפלט מולטימודאליים מעבר לטקסט.
  • מצב ברירת מחדל: הכלי 'עיגון בעזרת מפות Google' מושבת כברירת מחדל. צריך להפעיל אותו באופן מפורש בבקשות ל-API.

תמחור והגבלות על קצב יצירת הבקשות

התמחור של עיגון בעזרת מפות Google משתנה בהתאם לדור המודל:

  • ‫Gemini 3 ומודלים חדשים יותר: הפרויקט שלכם יחויב על כל שאילתת חיפוש שהמודל יחליט לבצע, עם 5,000 בקשות חינמיות בחודש שמשותפות לכל מודלי Gemini 3 ומודלים חדשים יותר, ולאחר מכן 14$לכל 1,000 שאילתות חיפוש. הנחיה אחת לחיפוש (בקשת ה-API שלכם למודל) עשויה לגרום למודל להריץ כמה שאילתות חיפוש כדי למצוא את המידע הדרוש. כל אחת מהשאילתות האלה נחשבת לשימוש בכלי שחייב בתשלום.
  • ‫Gemini 2.5 ומודלים ישנים יותר: החיוב על הפרויקט הוא לפי הנחיית חיפוש (25$ לכל 1,000 הנחיות מבוססות). חיוב על בקשה מתבצע רק אם ההנחיה מחזירה בהצלחה לפחות תוצאה אחת במפות Google, בלי קשר למספר שאילתות החיפוש שהמודל ביצע באופן פנימי כדי לקבל את התוצאה הזו.

המכסה לעיגון בעזרת מפות Google בדרך כלל תואמת למגבלות הקצב של מודל Gemini הבסיסי. מידע מפורט על התמחור זמין בדף התמחור של Gemini API.

מודלים נתמכים

המודלים הבאים תומכים בעיגון בעזרת מפות Google:

מודל עיגון בעזרת מפות Google
‫Gemini 3.8 Flash ✔️
‫Gemini 3.6 Flash ✔️
‫Gemini 3.5 Flash-Lite ✔️
Gemini 3.1 Pro Preview ✔️
‫Gemini 3.1 Flash-Lite ✔️
תצוגה מקדימה של Gemini 3 Flash ✔️
‫Gemini 2.5 Pro ✔️
‫Gemini 2.5 Flash ✔️
‫Gemini 2.5 Flash-Lite ✔️

שילובים נתמכים של כלים

אתם יכולים להשתמש ב-עיגון בעזרת מפות Google עם כלים מובנים אחרים כמו עיגון באמצעות חיפוש Google (נתמך ב-Gemini 3.5 Flash-Lite ובמודלים מתקדמים יותר) כדי להפעיל תרחישי שימוש מורכבים יותר. מודלים של Gemini 3 תומכים גם בשילוב של הכלים המובנים האלה עם כלים מותאמים אישית (קריאה לפונקציות). מידע נוסף זמין בדף שילובים של כלים.

המאמרים הבאים