עיגון בעזרת מפות Google ב-Gemini Enterprise Agent Platform

במאמר הזה מוסבר איך אפשר להשתמש ב-עיגון בעזרת מפות Google באמצעות Gemini Enterprise Agent Platform כדי לשפר את אפליקציות ה-AI הגנרטיבי על ידי מתן הקשר גיאו-מרחבי.

סקירה כללית

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

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

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

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

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

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

נסה את הדגמת עיגון בעזרת מפות Google

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

בקטע הזה מפורטים הדגמים שתומכים בעיגון בעזרת מפות Google.

לחצו כדי להרחיב את רשימת המודלים הנתמכים

• ‫Gemini 3.6 Flash
• ‫Gemini 3.5 Flash-Lite
• ‫Gemini 3.5 Flash
• ‫Gemini 3.1 Pro preview
• ‫Gemini 3.1 Flash-Lite
• ‫Gemini 3 Pro Image
• ‫Gemini 3 Flash תצוגה מקדימה
• ‫Gemini 2.5 Pro
• ‫Gemini 2.5 Flash-Lite
• ‫Gemini 2.5 Flash עם אודיו מקורי של Gemini Live API
• ‫Gemini 2.5 Flash

מידע נוסף על מודלים של Gemini

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

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

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

המסוף

כדי להשתמש ב-Grounding עם מפות Google באמצעות Gemini Enterprise Agent Platform, צריך לבצע את השלבים הבאים:

1. נכנסים לדף Agent Studio במסוף Google Cloud .

   מעבר ל-Agent Studio

2. בחלונית הצדדית, בקטע Model settings (הגדרות המודל), עוברים לקטע Grounding (הארקה) ולוחצים על סמל העריכה של Google Search, Google Maps (חיפוש Google, מפות Google). יופיע חלונית הגדרות.

3. מעבירים את המתג של מפות Google למצב פעיל.

4. לוחצים על אישור.

5. מזינים את ההנחיה בשדה ולוחצים על שליחה. התשובות שלכם להנחיות מבוססות על נתונים במפות 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: [מזהה הפרויקט](/resource-manager/docs/creating-managing-projects#identifiers). .
• ‫MODEL_ID: מזהה המודל של המודל הרב-אופני.
• ‫PROMPT: ההנחיה לשליחה למודל.
• ‫LATITUDE: קו הרוחב של המיקום. לדוגמה, קו רוחב של 37.7749 מייצג את סן פרנסיסקו. אפשר לקבל קואורדינטות של קו רוחב וקו אורך באמצעות שירותים כמו מפות Google או כלי גיאו-קידוד אחרים.
• ‫LONGITUDE: קו האורך של המיקום. לדוגמה, קו אורך של -122.4194 מייצג את סן פרנסיסקו.
• ‫GROUNDING_TYPES: סוגי ההארקה של מפות Google שרוצים להפעיל. כרגע יש תמיכה ב-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"
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent" | Select-Object -Expand Content

אתם אמורים לקבל תגובת 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 ליצירת תשובות. המאפיינים האלה משמשים לקביעת סוגי השאלות שאפשר לקבל עליהן תשובות באמצעות Grounding עם מפות Google.

מאפיינים לדוגמה של מקום

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

• כתובת
• איסוף מדלת העסק
• כרטיס חיוב מיידי
• מרחק
• מגרש חניה בחינם
• מוזיקה חיה
• תפריט לילדים
• שעות פתיחה
• אפשרויות תשלום (למשל מזומן או כרטיס אשראי)
• תשובה לשאלה על מקום
• ידידותי לחיות מחמד
• מגישים בירה
• מגישים אוכל צמחוני
• נגישות לכיסא גלגלים
• Wifi

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

דוגמאות לשימוש במאפייני מקום

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

• לתכנן ארוחת ערב משפחתית: אפשר לשאול, האם מסעדת "המקום האיטלקי" מתאימה לילדים, והאם יש בה שירות משלוחים? מה הדירוג שלהם?

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

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

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

• למצוא מקום לנשנוש בשעת לילה מאוחרת: אפשר לשאול, Is "Burger Joint" open now? האם מגישים במקום ארוחת ערב? מהן שעות הפתיחה ביום שישי?

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

• פגישה עם לקוח לקפה: אפשר לשאול, Does "Cafe Central" have Wifi?‎ האם מגישים במקום הזה קפה? מה רמת המחירים שלהם, והאם הם מקבלים כרטיסי אשראי?

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

המידע בתוצאות מבוססות-קרקע במפות Google עשוי להיות שונה מהמצב בפועל בכביש.

הסבר על התשובה

המקורות של מפות Google מוחזרים ב-groundingMetadata תוך groundingChunks. התוצאות מבוססות על מקומות ועל ביקורות משתמשים, שמשמשות ליצירת תוצאה מבוססת במפות Google.

בדוגמת הקוד הזו מוצגים מקור של מקום ומקור של תשובה לגבי מקום בתגובה:

"groundingChunks": [
  {
    "maps": {
      "uri": "{Link to Maps Content}",
      "title": "{Name of Maps Place}",
      "placeId": "{Place ID}",
      "placeAnswerSources": {
        "reviewSnippets" : [
          {
            "reviewId": "{Review ID}",
            "googleMapsUri": "{Link to Maps Content}",
            "title": "{Title of review}"
          }
        ]
      }
    },
  }
],

תכנון מסלול – חיפוש מסלול

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

יכולות

הפונקציה Find Directions מחשבת מרחקי נסיעה ומשכי זמן מדויקים בין נקודות מוצא ליעדים.

התכונה 'חיפוש מסלול' תומכת בפעולות הבאות:

• אמצעי תחבורה: תכנון מסלול לנסיעה, הליכה, רכיבה על אופניים, תחבורה ציבורית וכלי רכב ממונעים עם שני גלגלים (לא כל אמצעי ההגעה זמינים בכל המדינות)

• מספר נקודות ציון: עד 13 עצירות ביניים בין נקודת היציאה ליעד

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

אלה דוגמאות לסוגי השאלות שאפשר לשאול את התכונה 'חיפוש מסלול':

• קרבה לפי זמן נסיעה: "What are some American restaurants within a 10-minute walk from the Hilton Hotel on 1335 6th Ave in NYC?‎"

• הערכת זמן הנסיעה: "How long does it take to take public transit from Pike Place Market to Capitol Hill in Seattle?‎"

הסבר על התשובה

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

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

• משך: הזמן שנדרש לנסיעה בין מיקומים, כולל תנועת התנועה אם נדרש. לדוגמה, "500 שניות".

• מרחק: המרחק הפיזי של המסלול. לדוגמה, ‎"1.9 km".

• ‫Polyline (קו פוליגוני): מחרוזת טקסט מקודדת שמאפשרת להציג באופן חזותי את נתיב המסלול הספציפי במפה.

הדוגמה הבאה היא של תשובה לפרומפט: "How do I get to Carmine's restaurant from the Hilton Hotel (1335 6th Ave in NYC) where I'm staying?"

כדי להגיע למסעדת Carmine's ממלון Hilton בכתובת 1335 6th Ave בניו יורק, צריך לנסוע למיקום של Carmine's בכיכר טיימס בכתובת 200 W 44th St, New York, NY 10036, USA.

מסלול ההליכה:

1. מתחילים במלון הילטון: יוצאים ממלון הילטון בכתובת 1335 6th Ave.

2. הליכה דרומה בשדרה השישית: הולכים דרומה בשדרה השישית (שדרת אמריקה) לכיוון רחוב 44 מערב.

3. פונים ימינה אל רחוב 44 מערב: פונים ימינה אל רחוב 44 מערב.

4. מסעדת Carmine's נמצאת משמאל: הולכים לאורך רחוב W 44th, ומסעדת Carmine's תהיה בצד שמאל בכתובת 200 W 44th St.

המסלול הזה הוא באורך של כ-0.8 ק"מ, והוא אמור להימשך כ-10 עד 15 דקות.

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

כדי להגיע משוק פייק פלייס לגבעת הקפיטול בסיאטל באמצעות תחבורה ציבורית, יש כמה אפשרויות:

• חשמלית (רכבת קלה): הנסיעה בחשמלית מ-Westlake, שנמצאת ליד שוק Pike Place, אל Capitol Hill נמשכת כ-3 דקות. כולל העברות, זמן הנסיעה הכולל הוא כ-9 דקות, והחשמליות יוצאות כל 10 דקות.

• אוטובוס: אוטובוס ישיר של King County Metro מ-Pike St & 4th Ave (ליד שוק Pike Place) לקפיטול היל יוצא כל 20 דקות, והנסיעה נמשכת כ-11 דקות. אפשרות נוספת היא לקחת את אוטובוס קו 49, שייקח אתכם לשם תוך כ-16 דקות.

תכנון מסלול – חיפוש לאורך המסלול

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

יכולות

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

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

• חיפוש מסלול בסיסי: "תמצא תחנות דלק בדרך מ-1800 Amphibious Blvd. Mountain View, CA 94045,‎ ל-456 Sunny St, Sunnyvale CA". (בדרך כלל, כתובות המקור והיעד נגזרות מהיסטוריית הצ'אט).
• חיפוש לפי מאפייני מקום: "יש מאפיות עם דירוג של 4 כוכבים לפחות בין סן פרנסיסקו לבין 1800 Amphibious Blvd. Mountain View, CA 94045?"
• חיפוש מסלול עם כמה מקטעים: "אני נוסע בטיול דרכים מסן פרנסיסקו לסן לואיס אוביספו ללוס אנג'לס. אפשר לקבל שלוש אפשרויות לטעינת רכב חשמלי בין סן פרנסיסקו לסן לואיס אוביספו, ובין סן לואיס אוביספו ללוס אנג'לס?"

הסבר על התשובה

כשפרומפט מפעיל את הכלי 'חיפוש לאורך המסלול', המודל יוצר תשובה בשפה טבעית שמגובה במטא-נתונים מובְנים שמשלבים נתונים של מקומות ושל ניווט. כך אפשר לוודא שהמיקומים המוצעים נמצאים בנתיב הנסיעה הפיזי. האובייקט 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 Example Rd, Sunnyvale, CA 94045. הדירוג שלו הוא 3.5 כוכבים מ-122 ביקורות, והוא מוכר מימן, פרופאן ובנזין, וגם מציע שירותי שטיפת רכבים. הוא פתוח עד 21:50 הערב ויש בו שירותים.
• תחנת דלק פיקטיבית – ממוקמת בכתובת 456 Fictional Ave, Sunnyvale, CA 94045. הדירוג שלה הוא 3.6 כוכבים מ-52 ביקורות, ויש בה חנות נוחות ושטיפת רכב. התחנה פתוחה מסביב לשעון ויש בה שירותים.
• תחנת דלק כללית – ממוקמת בכתובת 789 W Generic St, Sunnyvale, CA 94045. הדירוג שלו הוא 3.6 כוכבים על סמך 35 ביקורות. התחנה הזו פתוחה 24 שעות ביממה ויש בה שירותים.

הנחיה לדוגמה [חיפוש מסלול עם כמה קטעים]:

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

דוגמה לתשובה [חיפוש מסלול עם כמה קטעים]:

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

בין סן פרנסיסקו לסן לואיס אוביספו:

• דוגמה למטען: המטען ממוקם בכתובת 123 Example Blvd,‏ Campbell, CA 95008, והדירוג שלו הוא 4.5.
• תחנת טעינה פיקטיבית לרכב חשמלי: אפשר למצוא את התחנה הזו בכתובת 456 Fictional Rd, Gilroy, CA 95008, עם דירוג של 4.4.
• תחנת טעינה כללית: התחנה הזו נמצאת בכתובת 789 Generic St, Salinas, CA 95008, והדירוג שלה הוא 3.5.

בין סן לואיס אוביספו ללוס אנג'לס:

• דוגמה למטען: המטען ממוקם בכתובת 123 Example Rd, San Luis Obispo, CA 93123, והדירוג שלו הוא 4.3.
• תחנת טעינה פיקטיבית לרכבים חשמליים: התחנה הזו נמצאת בכתובת 456 Fictional Ave, Santa Barbara, CA 93123, עם דירוג של 3.9.
• תחנת טעינה כללית: אפשר למצוא את התחנה הזו בכתובת 789 Generic St, Glendale, CA 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 וב-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, אפשר להשתמש בתג HTML‏ translate="no".
• מעצבים את הטקסט Google Maps כמו שמתואר בטבלה הבאה:

מאפיין (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 כוללים את מזהה המקום ומזהה הביקורת. יכול להיות שתשמרו במטמון, תאחסנו ותייצאו את נתוני התשובה הבאים:

• placeId
• reviewId

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

אזור אסור

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

חיוב

השימוש בעיגון בעזרת מפות Google כרוך בתשלום על כל שאילתה במפות Google (ראו תמחור).

בקשה של לקוח ל-Gemini עשויה להוביל לשאילתה אחת או יותר במפות Google. בטבלה הבאה מוצגות כמה דוגמאות:

הנחיה לדוגמה	מספר פוטנציאלי של שאילתות במפות Google	יצירת שאילתה לדוגמה
מסעדות סושי ליד מלון הילטון (1335 6th Ave in NYC).	‫3 שאילתות לחיפוש מקומות (שאילתות במפות Google), בהנחה שההנחיה הזו יוצרת 3 שאילתות fanout.	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.	1 שאילתת חיפוש של מסלול (שאילתת חיפוש במפות Google)	‫1 שאילת חיפוש של הוראות הגעה: – הוראות הגעה מ-Hilton Hotel, ‏ 1335 6th Ave, New York, NY אל 200 W 44th St, New York, NY 10036
המרחק ממלון הילטון (1335 6th Ave in NYC) לשדה התעופה.	‫4 שאילתות במפות Google (שאילתת חיפוש מקום אחת + 3 שאילתות של חיפוש מסלולים), בהנחה שחיפוש המקום מחזיר 3 שדות תעופה.	שאילתת חיפוש מקומות אחת עם פיצול: – שדות תעופה ליד ניו יורק 3 שאילתות של חיפוש מסלולים: – מסלול נסיעה מ-1335 6th Ave, New York, NY 10019, USA אל John F. ‪Kennedy International Airport, Queens, NY 11430, USA - Directions from 1335 6th Ave, New York, NY 10019, USA to Newark Liberty International Airport, Newark, NJ 07114, USA - Directions from 1335 6th Ave, New York, NY 10019, USA to LaGuardia
תמצא תחנות דלק בדרך מ-1800 Amphibious Blvd. Mountain View, CA 94045, אל 456 Sunny St, Sunnyvale CA.	‫1 שאילתת חיפוש לאורך מסלול (שאילתה במפות Google)	‫1 שאילתת חיפוש לאורך המסלול: – תחנות דלק מ-1800 Amphibious Blvd. Mountain View, CA 94045, אל 456 Sunny St, Sunnyvale CA

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

• איך מקשרים את מודלי Gemini לנתונים שלכם
• מידע נוסף על שיטות מומלצות לשימוש אחראי ב-AI ועל מסנני הבטיחות של Gemini Enterprise Agent Platform זמין במאמר אתיקה של בינה מלאכותית.