בדף הזה מוסבר איך עיגון בעזרת מפות Google עם Gemini Enterprise Agent Platform יכול לשפר את אפליקציות ה-AI הגנרטיבי שלכם באמצעות הקשר גיאוגרפי.
סקירה כללית
עיגון בעזרת מפות Google עם Gemini Enterprise Agent Platform הוא שירות שמקשר בין מודלים של Gemini לבין נתונים גיאוגרפיים ממפות Google. למפות Google יש גישה למידע על מיליוני מיקומים, כולל עסקים, ציוני דרך ונקודות עניין. הנתונים האלה נותנים לכם גישה למידע על יותר מ-250 מיליון מקומות, שאתם יכולים להשתמש בו כדי לעגן את התשובות של המודל, וכך לאפשר לאפליקציות ולסוכני ה-AI שלכם לספק נתונים מחנויות מקומיות והקשר גיאוגרפי.
אפשר גם להפעיל עיגון בו-זמנית עם מפות Google, חיפוש Google ומקורות הנתונים שלכם.
שימושים של עיגון בעזרת מפות Google
אתם יכולים להשתמש בעיגון בעזרת מפות Google למגוון אפליקציות, למשל:
- עוזרים אישיים שמנהלים שיחות ויכולים לענות על שאלות לגבי מקומות בסביבה, כמו "איפה המקום הכי קרוב שאפשר לקנות בו אספרסו איטלקי?"
- תיאורים בהתאמה אישית ותובנות מהקהילה, כמו "אפשר לקבל מידע נוסף על מסעדות שמתאימות לכל המשפחה ונמצאות במרחק הליכה?"
- סיכומים של אזורים סביב מיקומים ספציפיים, כמו תחנת טעינה לרכב חשמלי או מלון.
האפשרות הזו יכולה להועיל בתרחישים לדוגמה באפליקציות של נדל"ן, נסיעות, ניידות ורשתות חברתיות.
מודלים נתמכים
בקטע הזה מפורטים המודלים שתומכים בעיגון בעזרת מפות Google.
לחצו כדי להרחיב את רשימת המודלים הנתמכים
- Gemini Robotics ER 2
- Gemini Nano Banana 2.1
- Gemini 4 Hydrogen
- Gemini 4 Carbon לסייבר
- Gemini 4 Carbon
- Gemini 4 Argon Cyber Permissive
- Gemini 4 Argon
- Gemini 3.8 Live
- Gemini 3.8 Flash Cyber
- Gemini 3.8 Flash
- Gemini 3.7 Flash
- Gemini 3.6 Flash
- Gemini 3.5 Flash-Lite
- Gemini 3.5 Flash
- Gemini 3.1 Pro
- Gemini 3.1 Flash-Lite
- Gemini 3.1 Flash Image
- תמונה של Gemini 3 Pro
- Gemini 3 Flash
- Gemini 2.5 Pro
- Gemini 2.5 Flash-Lite
- Gemini 2.5 Flash עם אודיו מקורי של Gemini Live API
- Gemini 2.5 Flash
מידע נוסף על המודלים של Gemini זמין במאמר המודלים של Gemini.
שימוש בעיגון בעזרת מפות Google כדי לעגן את התשובות של המודל
דוגמת הקוד הזו ממחישה איך להשתמש ב"עיגון בעזרת מפות Google" כדי לעגן את התשובות של המודל.
אפשר להתאים אישית את תוצאות החיפוש למיקום גיאוגרפי ספציפי באמצעות קואורדינטות של קו רוחב וקו אורך.
המסוף
כדי להשתמש ב"עיגון בעזרת מפות Google" ב-Gemini Enterprise Agent Platform:
נכנסים לדף Agent Studio במסוף Google Cloud .
בחלונית הצדדית, בקטע Model settings, עוברים לקטע Grounding ולוחצים על סמל העריכה של חיפוש Google, מפות Google. מופיעה חלונית הגדרות.
מפעילים את המתג של מפות Google.
לוחצים על אישור.
מזינים את ההנחיה בשדה ולוחצים על שליחה. התשובות להנחיות שלכם מבוססות על מפות Google.
Python
התקנה
pip install --upgrade google-genai
מידע נוסף זמין במאמרי העזרה של ה-SDK.
מגדירים משתני סביבה כדי להשתמש ב-Google Gen AI SDK עם Vertex AI:
# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values # with appropriate values for your project. export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT export GOOGLE_CLOUD_LOCATION=global export GOOGLE_GENAI_USE_ENTERPRISE=True
from google import genai
from google.genai.types import (
GenerateContentConfig,
GoogleMaps,
HttpOptions,
Tool,
)
client = genai.Client(http_options=HttpOptions(api_version="v1"))
response = client.models.generate_content(
model="gemini-2.5-flash",
contents="Where can I get the best espresso near me?",
config=GenerateContentConfig(
tools=[
# Use Google Maps Tool
Tool(google_maps=GoogleMaps())
],
tool_config=types.ToolConfig(
retrieval_config = types.RetrievalConfig(
lat_lng = types.LatLng( # Pass geo coordinates for location-aware grounding
latitude=40.7128,
longitude=-74.006
),
language_code = "en_US", # Optional: localize Maps results
),
),
),
)
print(response.text)
# Example response:
# 'Here are some of the top-rated places to get espresso near you: ...'
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- LOCATION: האזור שבו הבקשה תעובד. כדי להשתמש בנקודת קצה גלובלית, צריך להחריג את המיקום משם נקודת הקצה ולהגדיר את מיקום המשאב כגלובלי.
- PROJECT_ID: מזהה הפרויקט. .
- MODEL_ID: מזהה המודל של המודל המולטי-מודאלי.
- PROMPT: ההנחיה שתישלח למודל.
- LATITUDE: קו הרוחב של המיקום. לדוגמה, קו הרוחב
37.7749מייצג את סן פרנסיסקו. אתם יכולים לקבל קואורדינטות של קו רוחב וקו אורך באמצעות שירותים כמו מפות Google או כלים אחרים להמרת כתובות לקואורדינטות (geocoding). - LONGITUDE: קו האורך של המיקום. לדוגמה, קו האורך
-122.4194מייצג את סן פרנסיסקו. - GROUNDING_TYPES: סוגי הביסוס במפות Google שרוצים להפעיל. כרגע יש תמיכה ב-
placesוב-routing.places: חיפוש מידע על מקומות, כולל עסקים, נקודות עניין בולטות ומיקומים גיאוגרפיים.-
routing: חיפוש מסלולים וחיפוש לאורך המסלול.
placesו-routing, ובמודלים קודמים מופעלת רק האפשרותplaces. אם מציינים סוגים, רק הסוגים שברשימה מופעלים.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent
תוכן בקשת JSON:
{
"contents": [{
"role": "user",
"parts": [{
"text": "PROMPT"
}]
}],
"tools": [{
"googleMaps": {
"groundingTypes": {
"places": {},
"routing": {}
}
}
}],
"toolConfig": {
"retrievalConfig": {
"latLng": {
"latitude": LATITUDE,
"longitude": LONGITUDE
},
"languageCode": "en_US"
}
},
"model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout. It has a rating of 4.2 stars based on 411 reviews."
}
]
},
"finishReason": "STOP",
"groundingMetadata": {
"groundingChunks": [
{
"maps": {
"uri": "https://maps.google.com/?cid=9001322937822692826",
"title": "The Italian Place",
"placeId": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w"
}
},
{
"maps": {
"uri": "https://maps.google.com/?cid=9001322937822692826",
"title": "Hank's Pasta Bar",
"placeId": "places/MMVtPzn9FGcevML89",
"placeAnswerSources": {
"reviewSnippets": [
{
"id": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w",
"title": "Google Maps Review",
"uri": "https://maps.google.com/?cid=9001322937822692826"
},
]
}
}
},
...
],
"groundingSupports": [
{
"segment": {
"endIndex": 79,
"text": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout."
},
"groundingChunkIndices": [
0
]
},
],
}
}
],
...
}
מאפייני המקום
בקטע הזה מפורטים מאפייני המקומות שמשמשים לתיאור מיקומים, ומשמשים את התכונה "עיגון בעזרת מפות Google" כדי ליצור תשובות. המאפיינים האלה משמשים כדי לקבוע את סוגי השאלות שניתן לענות עליהן באמצעות עיגון בעזרת מפות Google.
מאפייני מקום לדוגמה
הרשימה הבאה כוללת דוגמאות למאפיינים של מקומות, בסדר אלפביתי, שהמודל יכול להשתמש בהם כדי ליצור תשובות:
- כתובת
- מגמות של עומס
- איסוף מדלת העסק
- כרטיס חיוב מיידי
- מרחק
- מידע על תחנות טעינה לרכבים חשמליים (סוגי מחברים, מהירויות טעינה וזמינות)
- מגרש חניה בחינם
- מחירי דלק וסוגי דלק זמינים
- מתאים לילדים
- מוזיקה חיה
- המיטב מהתפריט
- שעות פתיחה
- אמצעי תשלום (כמו מזומן או כרטיס אשראי)
- ידידותי לחיות מחמד
- עיון בתובנות
- מגישים בירה
- מגישים במקום אוכל צמחוני
- נגישות לכיסא גלגלים
- Wifi
דוגמאות לשימוש במאפייני מקומות
בדוגמאות הבאות נעשה שימוש במאפייני מקומות בשאלות על סוגים שונים של מקומות. העיגון בעזרת מפות Google משתמש במאפיינים כדי להבין את הכוונה שלכם, ואז מספק תשובות רלוונטיות על סמך הנתונים שמשויכים למקומות במפות Google.
לתכנן ארוחת ערב משפחתית: אתם יכולים לשאול, האם "המסעדה האיטלקית" מתאימה לילדים, והאם יש שם טייק אוויי? מה הדירוג שלהם?
התשובות לשאלות האלה עוזרות לקבוע אם מסעדה מתאימה למשפחה ואם היא מציעה שירות נוח.
לגלות מנות מומלצות ומנות דגל בתפריט: אתם יכולים לשאול, למשל, What are the most recommended pasta dishes on the menu at "The Italian Place"? (מהן מנות הפסטה הכי מומלצות בתפריט של "המסעדה האיטלקית"?) האם יש להם מנות ראשונות צמחוניות, ומה כותבי הביקורות אומרים על רוטב המרינרה שלהם?
התשובות לשאלות האלה מבוססות על מנות פופולריות ותובנות מביקורות, כדי לעזור לכם לבדוק מנות ספציפיות ואת המנות האהובות על הקהילה.
לבדוק את הנגישות בשביל חבר: אתם יכולים לשאול, אני צריך מסעדה עם כניסה נגישה לכיסאות גלגלים.
התשובה לשאלה הזו יכולה לעזור לכם להבין אם המקום עונה על צורכי נגישות ספציפיים.
למצוא מקום לנשנוש לילי: אתם יכולים לשאול, האם "Burger Joint" פתוח עכשיו? מגישים שם ארוחת ערב? מהן שעות הפתיחה של העסק ביום שישי?
התשובות לשאלות האלה עוזרות לכם למצוא עסק פתוח שמגיש ארוחה מסוימת בשעה מסוימת.
תכנון טעינת רכב חשמלי ושירותי מלון לנסיעה: אתם יכולים לשאול, אני מתארח ב "מלון ללילה". האם יש במקום תחנות טעינה לרכבים חשמליים, אילו סוגי מחברים נתמכים ועד כמה אזור החנייה עמוס ביום שישי בערב?
התשובות לשאלות האלה משלבות מידע על תחנת הטעינה לרכב חשמלי ומגמות של עומס כדי לעזור לכם לתכנן את טעינת הרכב ולהעריך את רמות העומס במהלך השהות שלכם.
השוואה בין מחירי דלק וסוגי דלק מיוחדים בסביבה: אתם יכולים לשאול, למשל, באילו תחנות דלק בסביבת Mountain View, CA מוכרים דיזל או מימן, ומה ההבדלים בין המחירים הנוכחיים שלהם?
התשובות לשאלות האלה מתבססות על מחירי הדלק וסוגי הדלק הזמינים כדי לעזור לכם לאתר תחנות תדלוק משתלמות וסוגי דלק מיוחדים.
סיכום אווירת העבודה מתוך הביקורות: אתם יכולים לשאול, מה כתוב בסיכומים של ביקורות הלקוחות על רמת הרעש, נוחות הישיבה ואמינות ה-Wi-Fi ב "קפה ארוחת בוקר" לעבודה מרחוק?
התשובה להנחיה הזו מתבססת על תובנות מביקורות כדי להעריך אם בית קפה מתאים לעבודה או ללימודים, על סמך קונצנזוס בקהילה.
המידע בתוצאות המבוססות על מפות Google עשוי להיות שונה מהמצב בפועל בכביש או במקום.
הסבר על התשובה
המקורות של מפות Google מוחזרים ב-groundingMetadata בתוך groundingChunks. המקורות מוחזרים למקומות שמשמשים ליצירת התוצאה המבוססת במפות Google. השדה uri יכול לקשר לביקורת תומכת או ישירות לדף המקום במפות Google.
דוגמת הקוד הזו ממחישה מקור של מקום בתגובה:
"groundingChunks": [
{
"maps": {
"uri": "{Link to place sheet or review on Maps}",
"title": "{Name of Maps Place}",
"placeId": "{Place ID}"
}
}
],
ניתוב – חיפוש מסלול
העיגון בעזרת מפות Google תומך ביכולת למצוא מסלול. התכונה הזו מאפשרת לסוכני ה-AI להבין תנועה פיזית, הערכות זמן נסיעה בזמן אמת ואת היחסים המרחביים בין מיקומים. בעזרת היכולת "חיפוש מסלולים", המודל יכול לספק מסלולים מותאמים לביצועים וזמני הגעה מדויקים שמביאים בחשבון את התנאים בזמן אמת. השילוב הזה מאפשר ל-"עיגון בעזרת מפות Google" לסנן מקומות לפי זמן ההגעה, להציע מסלולים מדויקים חיבור מנקודה לנקודה ולחשב זמני נסיעה משוערים באמצעי תחבורה ספציפיים.
יכולות
התכונה "חיפוש מסלול" מחשבת את המרחקים ומשכי הנסיעה המדויקים בין נקודות המוצא והיעד.
התכונה "חיפוש מסלול" תומכת באפשרויות הבאות:
אמצעי תחבורה: מסלולים לנהיגה, הליכה, רכיבה על אופניים, תחבורה ציבורית וכלי רכב דו-גלגליים ממונעים (לא כל אמצעי התחבורה זמינים בכל המדינות)
מספר נקודות ציון: עד 13 עצירות ביניים בין נקודת המוצא ליעד
מצב התנועה בזמן אמת: המערכת מביאה בחשבון את מצב התנועה הנוכחי כדי לספק זמני נסיעה מדויקים "בזמן אמת" במקום ממוצעים סטטיים.
הנה כמה דוגמאות לסוגי השאלות שאפשר לשאול את Find Directions:
קרבה על סמך זמן הגעה: "אילו מסעדות אמריקאיות נמצאות במרחק של עד 10 דקות הליכה ממלון הילטון בשדרת 6th Ave 1335 בניו יורק?"
הערכת זמן נסיעה: "How long does it take to take public transit from Pike Place Market to Capitol Hill in Seattle?"
הפעלת האפשרות "חיפוש מסלול"
ב-API בארכיטקטורת REST ובערכות ה-SDK, מה שמופעל באמצעות עיגון בעזרת מפות Google כשמשמיטים את grounding_types תלוי במודל:
- Gemini 4 ומודלים חדשים יותר: מקומות ומסלולים, כך שהאפשרות "חיפוש מסלול" זמינה כברירת מחדל.
- מודלים קודמים: נתוני מקומות בלבד. כדי להפעיל את יכולות המסלולים, צריך להגדיר באופן מפורש את
routingב-grounding_typesבהגדרת הבקשה.
אם מגדירים את grounding_types, רק סוגי ה-grounding שציינתם מופעלים. כדי להשתמש גם בכלים של Places וגם בכלים של Routing, צריך לציין גם את places וגם את routing ב-grounding_types. כדי להשתמש רק בנתונים של Places, מציינים רק את places.
הסבר על התשובה
כשהנחיה מפעילה את היכולת "חיפוש מסלול", המודל יוצר תשובה בשפה טבעית שמגובה במטא-נתונים מובְנים. כך אפשר להציג למשתמש מידע מדויק על הנסיעה.
הנתונים הבאים מוחזרים בתגובה למטען הייעודי (payload):
משך זמן: הזמן שנדרש כדי לנסוע בין מיקומים, כולל התחשבות בעומסי תנועה, אם ביקשתם זאת. לדוגמה, "500 שניות".
מרחק: המרחק הפיזי של המסלול. לדוגמה, "1.9 ק"מ".
קו פוליגוני: מחרוזת טקסט מקודדת שמאפשרת להציג באופן חזותי את נתיב המסלול הספציפי במפה.
הדוגמה הבאה היא תשובה להנחיה: "איך מגיעים למסעדת Carmine's ממלון הילטון (1335 6th Ave בניו יורק) שבו אני מתארח?"
כדי להגיע למסעדת Carmine's ממלון הילטון בכתובת 1335 6th Ave בניו יורק, צריך ללכת לסניף של Carmine's בטיימס סקוור בכתובת 200 W 44th St, New York, NY 10036, USA.
הנה מסלול ההליכה:
מתחילים במלון הילטון: יוצאים ממלון הילטון בכתובת 1335 6th Ave.
הולכים דרומה ב-6th Avenue: הולכים דרומה ב-6th Avenue (Avenue of the Americas) לכיוון W 44th Street.
פונים ימינה אל רחוב 44 מערב: פונים ימינה אל רחוב 44 מערב.
Carmine's נמצאת משמאל: הולכים לאורך W 44th Street, ו-Carmine's תהיה בצד שמאל, בכתובת 200 W 44th St..
ההליכה היא באורך של כ-800 מטרים ואמורה להימשך כ-10 עד 15 דקות.
הנה דוגמה לתשובה להנחיה: "כמה זמן לוקח להגיע בתחבורה ציבורית משוק מחנה יהודה לשכונת נחלאות בירושלים?"
כדי להגיע משוק מחנה יהודה לשכונת נחלאות בירושלים בתחבורה ציבורית, יש כמה אפשרויות:
חשמלית (רכבת קלה): הנסיעה בחשמלית מווסטלייק, שנמצאת ליד שוק פייק פלייס, לקפיטול היל נמשכת כ-3 דקות. כולל החלפות, זמן הנסיעה הכולל הוא כ-9 דקות, והחשמליות יוצאות כל 10 דקות.
אוטובוס: אוטובוס ישיר של King County Metro מ-Pike St & 4th Ave (ליד Pike Place Market) לקפיטול היל יוצא כל 20 דקות, והנסיעה נמשכת כ-11 דקות. אפשר גם לנסוע בקו 49, הנסיעה נמשכת כ-16 דקות.
ניתוב – חיפוש לאורך המסלול
התכונה "חיפוש לאורך המסלול" מאפשרת לסוכני ה-AI למצוא נקודות עניין שרלוונטיות מבחינה גיאוגרפית ונוחות למסלול המתוכנן של המשתמש. כשמבססים את התשובות על מנועי החיפוש המרחביים והמסלולים של מפות Google, המודל יכול לתת המלצות שמצמצמות את הצורך בנסיעות ארוכות יותר, ולהבין את הלוגיסטיקה של נסיעה ארוכה או נסיעה יומית.
יכולות
התכונה "חיפוש לאורך המסלול" מאפשרת לאפליקציה לזהות עסקים, שירותים או אטרקציות ספציפיים שנמצאים ישירות לאורך מסלול שנוצר בין נקודת מוצא ליעד. יש תמיכה רק במצב הנסיעה "נהיגה".
הדוגמאות הבאות ממחישות את סוגי השאלות שהכלי "חיפוש לאורך המסלול" יכול לטפל בהן.
- חיפוש מסלול בסיסי: "תמצא תחנות דלק בדרך מרחוב דיזנגוף 50, תל אביב-יפו, לרחוב רוטשילד 10, תל אביב-יפו". (בדרך כלל, כתובות המוצא והיעד נגזרות מהיסטוריית הצ'אט).
- חיפוש לפי מאפייני מקום: "האם יש מאפיות עם דירוג כוכבים של 4 לפחות בין חיפה לבין רחוב רוטשילד 100, תל אביב?"
- חיפוש מסלול עם כמה עצירות: "אני יוצא לטיול מסן פרנסיסקו לסן לואיס אוביספו ומשם ללוס אנג'לס. תציע לי שלוש אפשרויות למטענים לרכב חשמלי בין סן פרנסיסקו לסן לואיס אוביספו, ואז בין סן לואיס אוביספו ללוס אנג'לס".
הפעלת החיפוש לאורך המסלול
כדי לחפש לאורך המסלול, צריך גם את היכולות של Places וגם את היכולות של Routing כדי למצוא מקומות שנמצאים לאורך מסלול הנסיעה. ב-API בארכיטקטורת REST ובערכות ה-SDK, שתי האפשרויות מופעלות כברירת מחדל ב-Gemini 4 ובמודלים מתקדמים יותר, אם לא מציינים את grounding_types. בדגמים קודמים, או אם הגדרתם את grounding_types, אתם צריכים לכלול גם את places וגם את routing ב-grounding_types כדי להפעיל את התכונה "חיפוש לאורך המסלול".
הסבר על התשובה
כאשר פרומפט מפעיל את הכלי 'חיפוש לאורך המסלול', המודל יוצר תשובה בשפה טבעית שמגובה במטא-נתונים מובְנים שמשלבים נתונים מ'מקומות' וגם מ-Routing. כך אפשר להבטיח שהמיקומים המוצעים באמת נוחים למסלול הנסיעה הפיזי. השדה groundingMetadata יכיל את הערך groundingChunks למקומות שיוחזרו ולמסלול שבו בוצע החיפוש.
הנחיה לדוגמה [חיפוש מסלול בסיסי]:
מצא תחנות דלק בדרך מ-1800 Amphibious Blvd. Mountain View, CA 94045, אל 456 Sunny St, Sunnyvale CA.
תגובה לדוגמה [חיפוש מסלול בסיסי]:
הנה כמה תחנות דלק בדרך מ-1800 Amphibious Blvd. Mountain View, CA 94045 אל 456 Sunny St, Sunnyvale, CA:
- תחנת דלק לדוגמה – ממוקמת בכתובת: רחוב הדוגמה 123, תל אביב, 94045. הדירוג שלה הוא 3.5 כוכבים על סמך 122 ביקורות, והיא מוכרת מימן, פרופאן ובנזין, ומציעה גם שירותי שטיפת מכוניות. הוא פתוח עד 21:50 הערב ויש בו שירותים.
- תחנת דלק פיקטיבית – בכתובת 456 Fictional Ave, Sunnyvale, CA 94045. הדירוג שלה הוא 3.6 כוכבים על סמך 52 ביקורות, ויש בה חנות נוחות ושטיפת מכוניות. התחנה פתוחה 24 שעות ויש בה שירותים.
- תחנת דלק גנרית – בכתובת 789 W Generic St, Sunnyvale, CA 94045. הדירוג שלו הוא 3.6 כוכבים על סמך 35 ביקורות. התחנה פתוחה 24 שעות ויש בה שירותים.
הנחיה לדוגמה [חיפוש מסלול עם כמה מקטעים]:
אני יוצא לנסיעה מסן פרנסיסקו לסן לואיס אוביספו ומשם ללוס אנג'לס. תוכל להציע שלוש אפשרויות למטענים לרכב חשמלי בין סן פרנסיסקו לסן לואיס אוביספו, ואז בין סן לואיס אוביספו ללוס אנג'לס?
דוגמה לתשובה [חיפוש מסלול עם כמה מקטעים]:
הנה כמה אפשרויות למטענים לרכב חשמלי בנסיעה מסן פרנסיסקו ללוס אנג'לס, עם עצירות בסן לואיס אוביספו.
בין סן פרנסיסקו לסן לואיס אוביספו:
- עמדת טעינה לדוגמה: ממוקמת ברחוב רוטשילד 123, תל אביב-יפו, 6578501. הדירוג של התחנה הזו הוא 4.5.
- תחנת טעינה פיקטיבית לרכב חשמלי: התחנה הזו נמצאת בכתובת 456 Fictional Rd, Gilroy, CA 95008, והדירוג שלה הוא 4.4.
- תחנת טעינה כללית: התחנה הזו נמצאת בכתובת 789 Generic St, Salinas, CA 95008, והדירוג שלה הוא 3.5.
בין סן לואיס אוביספו ללוס אנג'לס:
- תחנת טעינה לדוגמה: התחנה הזו ממוקמת ברחוב Example Rd 123, סן לואיס אוביספו, קליפורניה 93123, והדירוג שלה הוא 4.3.
- תחנת טעינה לרכב חשמלי (EV) פיקטיבית: התחנה הזו נמצאת בכתובת 456 Fictional Ave, Santa Barbara, CA 93123, והדירוג שלה הוא 3.9.
- תחנת טעינה כללית: התחנה הזו נמצאת ברחוב הכללי 789, גלנדייל, קליפורניה 93123, והדירוג שלה הוא 3.0.
נסיעה טובה!
דרישות לגבי השימוש בשירות
בקטע הזה מפורטות הדרישות לשימוש בשירות "עיגון בעזרת מפות Google".
ליידע את המשתמש על השימוש במקורות של מפות Google
בכל תוצאה מעוגנת במפות Google, תקבלו מקורות ב-groundingChunks שתומכים בכל תשובה. מוחזרים גם המטא-נתונים הבאים:
- URI במקור
- כותרת
- מזהה
כשמציגים תוצאות מ"עיגון בעזרת מפות Google" ב-Gemini Enterprise Agent Platform, צריך לציין את המקורות המשויכים במפות Google, ולהודיע למשתמשים על הדברים הבאים:
- המקורות של מפות Google חייבים להופיע מיד אחרי התוכן שנוצר שהמקורות תומכים בו. התוכן שנוצר נקרא גם תוצאה מבוססת-מפות Google.
- המקורות של מפות Google צריכים להיות גלויים באינטראקציה אחת של המשתמש.
לממשקים שמתבססים על קול
מקורות: המקורות של מפות Google חייבים להופיע בממשק משתמש נלווה שמציג תיעוד היסטורי מילה במילה של כל שיחה קולית עם ה-AI. הרשומה הזו צריכה לעמוד בדרישות המקור, והיא כפופה למגבלות הרלוונטיות על שמירת נתונים במטמון ועל אחסון נתונים.
גילוי נאות פעיל של מקורות: משתמשי הקצה צריכים להיות מודעים באופן סביר לתפקיד של מפות Google בחוויה שלהם, ולדעת איך למצוא מקורות מפורטים בזמן האינטראקציה.
הגילוי הנאות הפעיל של המקורות חייב להעביר את הנקודות הבאות:
תוכן שנוצר על ידי AI עשוי לכלול מידע ממפות Google.
המקורות המפורטים זמינים בממשק המשתמש של הכלי.
אתם צריכים להעביר את הגילוי הנאות הפעיל של המקורות באמצעות אחת לפחות מהשיטות הבאות.
תצוגה חזותית: באינטראקציות קוליות שמתרחשות במכשיר עם מסך, צריך להציג את ההודעה הפעילה במסך בכל פעם שמשתמשים בעיגון בעזרת מפות Google.
הודעה קולית: הקראת ההודעה הפעילה למשתמש. ההודעה הזו צריכה להופיע באינטראקציה הראשונה שנתמכת על ידי "עיגון בעזרת מפות Google", ולחזור על עצמה לפחות כל 6 חודשים.
דוגמה לגילוי נאות: "תוכן שנוצר על ידי AI עשוי לכלול מידע ממפות Google. אפשר למצוא מקורות מפורטים באפליקציה הנלווית".
גילוי נאות קבוע: צריך להציג למשתמש הקצה הסבר קבוע על כך שתוכן ממפות Google עשוי לשמש בתוכן שנוצר על ידי AI (לדוגמה, בתפריט הגדרות הקול או בגילוי נאות על אינטראקציה קולית).
פניות של משתמשים: העוזר הקולי חייב לענות בצורה מדויקת על פניות של משתמשי קצה לגבי מקור התוכן, כולל מקרים שבהם תוכן שנוצר על ידי AI כולל מידע ממפות Google. אם המקור הוא מפות Google, צריך להפנות את משתמשי הקצה לממשק המשתמש הנלווה כדי לגשת למידע ספציפי על המקור.
הצגת מקורות במפות Google עם קישורים למפות Google
לכל מקור ב-groundingChunks, צריך ליצור תצוגה מקדימה של קישור בהתאם לדרישות הבאות:
- צריך לשייך כל מקור למפות Google בהתאם להנחיות לשיוך טקסט במפות Google.
- הצגת כותרת המקור שמופיעה בתשובה.
- מקשרים למקור באמצעות
uriמהתשובה.
בתמונות האלה מוצגות הדרישות המינימליות להצגת המקורות והקישורים למפות Google.
אתם יכולים לכווץ את תצוגת המקורות.
אופציונלי: אפשר להוסיף לתצוגה המקדימה של הקישור תוכן נוסף, כמו:
- סמל האתר של מפות Google מוצג לפני שיוך הטקסט של מפות Google.
- תמונה מכתובת ה-URL של המקור (
og:image).
מידע נוסף על חלק מספקי הנתונים של מפות Google ותנאי הרישיון שלהם זמין בהודעות המשפטיות של מפות Google ו-Google Earth.
הנחיות לשיוך טקסט במפות Google
כשמציינים את מפות Google כמקור בטקסט, צריך לפעול לפי ההנחיות הבאות:
- אין לשנות את הטקסט מפות Google בשום צורה:
- אל תשנו את האותיות הרישיות ב-מפות Google.
- אל תפצלו את המונח מפות Google לכמה שורות.
- אל תתרגמו את מפות Google לשפה אחרת.
- כדי למנוע מדפדפנים לתרגם את מפות Google, משתמשים במאפיין ה-HTML
translate="no".
- הטקסט של מפות Google צריך להיות מעוצב כמו שמתואר בטבלה הבאה:
| מאפיין (property) | סגנון |
|---|---|
| משפחת גופנים | Roboto. לא חובה לטעון את הגופן. |
| משפחת גופנים חלופית | כל גופן Sans Serif שכבר נמצא בשימוש במוצר, או "Sans-Serif" כדי להפעיל את גופן ברירת המחדל של המערכת |
| סגנון הגופן | רגילה |
| עובי הגופן | 400 |
| צבע גופן | לבן, שחור (#1F1F1F) או אפור (#5E5E5E). לשמור על ניגודיות נגישה (4.5:1) ביחס לרקע. |
| גודל גופן | גודל גופן מינימלי: 12sp גודל גופן מקסימלי: 16sp מידע נוסף על sp זמין בקטע "יחידות של גודל גופן" באתר Material Design. |
| הריווח בין האותיות | רגילה |
דוגמה ל-CSS
ה-CSS הבא מעבד את מפות Google עם הסגנון והצבע הטיפוגרפיים המתאימים על רקע לבן או בהיר.
@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" לא חלות.
אזור אסור
כדי לשמור על פלטפורמה בטוחה ואמינה, יש הגבלות על תוכן ופעילויות מסוימים בעיגון בעזרת מפות Google. הלקוח לא יפיץ או ישווק אפליקציה של הלקוח שמציעה עיגון בעזרת מפות Google בטריטוריה אסורה. מידע נוסף זמין במאמר אזורים אסורים ב-Google Maps Platform. רשימת האזורים האסורים עשויה להתעדכן מעת לעת.
חיוב
החיוב על עיגון בעזרת מפות Google הוא לכל שאילתה במפות Google (ראו תמחור).
בקשה שלקוח שולח ל-Gemini יכולה להוביל לשאילתה אחת או יותר במפות Google. במודלים של Gemini 4 ואילך, אם משמיטים את grounding_types, גם Places וגם Routing מופעלים, כך שבקשה כזו יכולה להוביל לשאילתות של חיפוש מקומות, חיפוש מסלולים וחיפוש לאורך המסלול. כדי להגביל בקשה לשאילתות חיפוש מקומות, צריך לציין רק את places ב-grounding_types. בטבלה הבאה מוצגות כמה דוגמאות:
| פרומפט לדוגמה | מספר השאילתות הפוטנציאליות במפות Google | דוגמה ליצירת שאילתה |
|---|---|---|
| מסעדות סושי ליד מלון הילטון (1335 6th Ave בניו יורק). | 3 שאילתות של חיפוש מקומות (שאילתות במפות Google), בהנחה שההנחיה הזו יוצרת 3 שאילתות מפוצלות. | 3 שאילתות חיפוש מקומות: - הסושי הכי טוב ליד Hilton Midtown Manhattan - מסעדות סושי ליד 1335 6th Ave New York - מסעדות יפניות ליד 1335 6th Ave New York |
| איך מגיעים אל 200 W 44th St, New York מ-Hilton Hotel, 1335 6th Ave. | שאילתה אחת למציאת מסלול (שאילתה במפות Google) | 1 שאילתה של חיפוש מסלול: - מסלול מ-Hilton Hotel, 1335 6th Ave, New York, NY אל 200 W 44th St, New York, NY 10036 |
| המרחק ממלון הילטון (1335 6th Ave בניו יורק) לשדה התעופה. | 4 שאילתות במפות Google (שאילתה אחת של חיפוש מקומות + 3 שאילתות של חיפוש מסלולים), בהנחה שהחיפוש של המקום מחזיר 3 שדות תעופה. | שאילתה אחת של חיפוש מקומות: - שדות תעופה ליד ניו יורק 3 שאילתות של חיפוש מסלול: - מסלול מ-1335 6th Ave, New York, NY 10019, USA אל John F. Kennedy International Airport, Queens, NY 11430, USA - מסלול מ-1335 6th Ave, New York, NY 10019, USA אל Newark Liberty International Airport, Newark, NJ 07114, USA - מסלול מ-1335 6th Ave, New York, NY 10019, USA אל LaGuardia |
| תמצא תחנות דלק בדרך מ-1800 Amphibious Blvd. Mountain View, CA 94045, אל 456 Sunny St, Sunnyvale CA. | שאילתה אחת של "חיפוש לאורך המסלול" (שאילתה במפות Google) | שאילתה אחת של חיפוש לאורך המסלול: - תחנות דלק משדרות ירושלים 65, תל אביב-יפו, עד רחוב הרצל 456, רמת גן |
המאמרים הבאים
- איך מבססים את מודלי Gemini על הנתונים שלכם
- במאמר אתיקה של בינה מלאכותית מפורט מידע נוסף על השיטות המומלצות לאתיקה של בינה מלאכותית ועל מסנני הבטיחות של Gemini Enterprise Agent Platform.