עיגון בעזרת מפות 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 או כלים אחרים להמרת כתובות לקואורדינטות (geocoding).
  • ‫LONGITUDE: קו האורך של המיקום. לדוגמה, קו האורך -122.4194 מייצג את סן פרנסיסקו.
  • ‫GROUNDING_TYPES: סוגי הביסוס במפות Google שרוצים להפעיל. כרגע יש תמיכה ב-places וב-routing.
    • places: חיפוש מידע על מקומות, כולל עסקים, נקודות עניין בולטות ומיקומים גיאוגרפיים.
    • ‫routing: חיפוש מסלולים וחיפוש לאורך המסלול.
    אם לא צוין אחרת, מודלים של Gemini 4 ואילך מפעילים את 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" פתוח עכשיו? מגישים שם ארוחת ערב? מהן שעות הפתיחה של העסק ביום שישי?

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

  • תכנון טעינת רכב חשמלי ושירותי מלון לנסיעה ארוכה: אתם יכולים לשאול, אני מתארח ב-Overnight Motel. האם יש במקום תחנות טעינה לרכבים חשמליים, אילו סוגי מחברים נתמכים וכמה עמוס אזור החנייה בימי שישי בערב?

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

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

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

  • סיכום האווירה במקום העבודה על סמך ביקורות: אתם יכולים לשאול, מה כתוב בסיכומים של ביקורות הלקוחות על רמת הרעש, נוחות הישיבה ואמינות ה-Wi-Fi ב-Breakfast Cafe לעבודה מרחוק?

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

יכול להיות שהמידע בתוצאות המבוססות של מפות 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.

אלה ההוראות למסלול ההליכה:

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

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

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

  4. ‫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, המודל יכול לספק המלצות שמצמצמות את הצורך בנסיעות ארוכות יותר, ולהבין את הזרימה הלוגיסטית של נסיעה ארוכה או נסיעה יומית.

יכולות

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

הדוגמאות הבאות ממחישות את סוגי השאלות שהכלי "חיפוש לאורך המסלול" יכול לטפל בהן.

  • חיפוש מסלול בסיסי: "תמצא תחנות דלק בדרך משדרות ירושלים 65, תל אביב-יפו, לרחוב הרצל 456, רמת גן". (בדרך כלל, כתובות המוצא והיעד נגזרות מהיסטוריית הצ'אט).
  • חיפוש לפי מאפייני מקום: "האם יש מאפיות עם דירוג כוכבים של 4 לפחות בין חיפה לבין רחוב הזיתים 23, תל אביב?"
  • חיפוש מסלול עם כמה עצירות: "אני יוצא לטיול מסן פרנסיסקו לסן לואיס אוביספו ומשם ללוס אנג'לס. תציע לי שלוש אפשרויות למטענים לרכב חשמלי בין סן פרנסיסקו לסן לואיס אוביספו, ואז בין סן לואיס אוביספו ללוס אנג'לס".

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

כדי לחפש לאורך המסלול, צריך גם את היכולות של מקומות וגם את היכולות של מסלולים כדי למצוא מקומות שנמצאים לאורך מסלול הנסיעה. ב-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 Example Blvd, Campbell, CA 95008, והדירוג שלה הוא 4.5.
  • תחנת טעינה פיקטיבית לרכב חשמלי: התחנה הזו נמצאת בכתובת 456 Fictional Rd, Gilroy, CA 95008, והדירוג שלה הוא 4.4.
  • תחנת טעינה כללית: התחנה הזו נמצאת בכתובת 789 Generic St, Salinas, CA 95008, והדירוג שלה הוא 3.5.

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

  • עמדת טעינה לדוגמה: ממוקמת ברחוב השלום 123, נתניה, 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.

  • מקורות מפורטים זמינים בממשק המשתמש של 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" לא חלות.

אזור אסור

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

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