העיגון בעזרת מפות 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 שרלוונטיים למיקום שצוין.
התהליך בדרך כלל כולל:
- שאילתת משתמש: משתמש שולח שאילתה לאפליקציה שלכם, שיכולה לכלול הקשר גיאוגרפי (לדוגמה, "בתי קפה בסביבה שלי", "מוזיאונים בסן פרנסיסקו").
- הפעלת הכלי: מודל Gemini מזהה את הכוונה הגיאוגרפית ומפעיל את הכלי "עיגון בעזרת מפות Google". אפשר להוסיף לכלי הזה את
latitudeו-longitudeשל המשתמש. הכלי הוא כלי לחיפוש טקסטואלי והוא פועל באופן דומה לחיפוש במפות Google, בכך ששאילתות מקומיות ("בסביבה") ישתמשו בקואורדינטות, בעוד ששאילתות ספציפיות או לא מקומיות לא צפויות להיות מושפעות מהמיקום המפורש. - אחזור נתונים: שירות העיגון בעזרת מפות Google שולח שאילתות למפות Google כדי לקבל מידע רלוונטי (למשל: מקומות, ביקורות, תמונות, כתובות, שעות פתיחה).
- יצירת תשובה מבוססת-קרקע: הנתונים שאוחזרו ממפות Google משמשים כבסיס לתשובה של מודל Gemini, כדי להבטיח שהיא תהיה מדויקת מבחינה עובדתית ורלוונטית.
- תשובה: המודל מחזיר תשובת טקסט שכוללת ציטוטים ממקורות במפות 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}
}
}
}'
דרישות לשימוש בשירות
בקטע הזה מפורטות הדרישות לשימוש בשירות "ביסוס בעזרת מפות Google".
ליידע את המשתמש על השימוש במקורות של מפות Google
לכל תוצאה במפות Google שמבוססת על מקורות מידע, תקבלו מקורות מידע בפורמט groundingChunks שתומכים בכל תשובה. מוחזרים גם המטא-נתונים הבאים:
- URI במקור
- title
- מזהה
כשמציגים תוצאות מעיגון בעזרת מפות Google, צריך לציין את המקורות המשויכים במפות Google, ולהודיע למשתמשים על הדברים הבאים:
- המקורות ממפות Google חייבים להופיע מיד אחרי התוכן שנוצר שהמקורות תומכים בו. התוכן שנוצר נקרא גם "תוצאה מעוגנת במפות Google".
- מקורות המידע במפות Google צריכים להיות גלויים במהלך אינטראקציה אחת של המשתמש.
הצגת מקורות של מפות Google עם קישורים למפות Google
לכל מקור ב-groundingChunks וב-grounding_chunks.maps.placeAnswerSources.reviewSnippets, צריך ליצור תצוגה מקדימה של קישור בהתאם לדרישות הבאות:
- צריך לשייך כל מקור למפות Google בהתאם להנחיות השיוך של מפות Google.
- הצגת שם המקור שצוין בתשובה.
- קישור למקור באמצעות
uriאוgoogleMapsUriמהתשובה.
התמונות האלה מציגות את הדרישות המינימליות להצגת המקורות והקישורים למפות Google.
אתם יכולים לכווץ את תצוגת המקורות.
אופציונלי: אפשר להוסיף לתצוגה המקדימה של הקישור תוכן נוסף, כמו:
- סמל האתר של מפות Google מוצג לפני השיוך של הטקסט למפות Google.
- תמונה מכתובת ה-URL של המקור (
og:image).
מידע נוסף על חלק מספקי הנתונים של מפות 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 |
|
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 כוללים את מזהה המקום ואת מזהה הביקורת. אתם יכולים לשמור במטמון, לאחסן ולייצא את נתוני התגובה הבאים:
placeIdreviewId
המגבלות נגד שמירה במטמון שמפורטות בתנאים של עיגון בעזרת מפות 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 4 Argon | ✔️ |
| 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 תומכים גם בשילוב של הכלים המובנים האלה עם כלים מותאמים אישית (קריאה לפונקציות). מידע נוסף זמין בדף שילובים של כלים.
המאמרים הבאים
- כדאי לנסות את המתכון לעיגון באמצעות חיפוש Google ב-Gemini API.
- מידע על כלים זמינים אחרים
- כדי לקבל מידע נוסף על שיטות מומלצות לאתיקה של AI ועל מסנני הבטיחות של Gemini API, אפשר לעיין במדריך להגדרות הבטיחות.