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

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

סקירה כללית

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

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

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

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

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

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

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

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

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

מידע נוסף על המודלים של Gemini זמין במאמר המודלים של Gemini.

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

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

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

המסוף

כדי להשתמש ב"עיגון בעזרת מפות Google" ב-Gemini Enterprise Agent Platform:

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

    מעבר אל Agent Studio

  2. בחלונית הצדדית, בקטע Model settings, עוברים לקטע Grounding ולוחצים על סמל העריכה של חיפוש 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: מזהה הפרויקט. .
  • ‫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"
}

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

אתם אמורים לקבל תגובת 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"?‎ (מהן מנות הפסטה המומלצות ביותר בתפריט של "המסעדה האיטלקית"?) האם יש להם מנות ראשונות צמחוניות, ומה כותבי הביקורות אומרים על רוטב המרינרה שלהם?

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

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

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

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

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

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

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

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

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

  • סיכום אווירת העבודה מתוך ביקורות: אתם יכולים לשאול, מה כתוב בסיכומי הביקורות של הלקוחות על רמת הרעש, נוחות הישיבה ואמינות ה-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 להבין תנועה פיזית, הערכות נסיעה בזמן אמת ויחסים מרחביים בין מיקומים. בעזרת היכולת "חיפוש מסלול", המודל יכול לספק מסלולים מותאמים לביצועים וזמני הגעה מדויקים שמביאים בחשבון את התנאים בזמן אמת. השילוב הזה מאפשר ל-Grounding עם מפות Google לסנן מקומות על סמך זמן הנסיעה, להציע מסלולים מדויקים מנקודה לנקודה ולחשב את זמני הנסיעה המשוערים באמצעי תחבורה ספציפיים.

יכולות

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

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

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

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

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

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

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

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

הפעלת האפשרות "חיפוש מסלול"

ב-API בארכיטקטורת REST ובערכות ה-SDK, העיגון בעזרת מפות Google מוגדר כברירת מחדל לנתוני Places רק כשמשמיטים את grounding_types. כדי להפעיל את יכולות המסלולים, צריך להגדיר באופן מפורש את routing ב-grounding_types בהגדרת הבקשה. אם אתם רוצים להשתמש גם בכלים של Places וגם בכלים של Routing, אתם צריכים לציין גם את places וגם את routing ב-grounding_types.

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

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

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

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

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

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

הדוגמה הבאה היא תשובה להנחיה: "איך מגיעים למסעדת Carmine's ממלון הילטון (‎1335 6th Ave בניו יורק) שבו אני מתארח?"

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

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

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

  2. הולכים דרומה בשדרה השישית: הולכים דרומה בשדרה השישית (Avenue of the Americas) לכיוון W 44th Street.

  3. פונים ימינה אל W 44th Street: פונים ימינה אל W 44th Street.

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

ההליכה היא לאורך כ-800 מטרים ואמורה להימשך כ-10 עד 15 דקות.

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

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

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

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

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

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

יכולות

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

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

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

הפעלת האפשרות 'חיפוש לאורך המסלול'

התכונה 'חיפוש לאורך המסלול' דורשת את היכולות מקומות וניתוב כדי למצוא מקומות שממוקמים לאורך מסלול נסיעה. ב-API בארכיטקטורת REST וב-SDK, צריך להגדיר במפורש את 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 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.
  • תחנת טעינה לרכב חשמלי (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.

  • המקורות המפורטים זמינים בממשק המשתמש של Gemini Companion.

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

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

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

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

גילוי נאות קבוע: צריך להציג למשתמש הקצה הסבר קבוע על כך שתוכן ממפות Google עשוי לשמש בתוכן שנוצר על ידי AI (למשל, בתפריט הגדרות קוליות או בגילוי נאות לגבי אינטראקציה קולית).

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

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

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

הנחיה עם תשובה שכוללת מקורות

אתם יכולים לכווץ את תצוגת המקורות.

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

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

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

  • placeId
  • reviewId

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

אזור אסור

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

חיוב

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

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

הנחיה לדוגמה מספר השאילתות הפוטנציאליות במפות Google דוגמה ליצירת שאילתה
מסעדות סושי ליד מלון הילטון (1335 6th Ave בניו יורק). ‫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. שאילתה אחת למציאת מסלול (שאילתה במפות 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. ‫1 שאילתת חיפוש לאורך המסלול (שאילתה במפות Google) שאילתה אחת של חיפוש לאורך המסלול:
- תחנות דלק משדרות ירושלים 65, תל אביב-יפו, עד רחוב הרצל 456, רמת גן

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