עיגון בעזרת מפות 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

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

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

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

המסוף

כדי להשתמש בעיגון בעזרת מפות Google באמצעות Gemini Enterprise Agent Platform, פועלים לפי השלבים הבאים:

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

    מעבר אל Agent Studio

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

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

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

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

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

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

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

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

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

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

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

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

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

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

יכולות

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

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

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

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

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

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

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

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

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

  • ‫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. פונים ימינה אל W 44th Street: פונים ימינה אל W 44th Street.

  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 Market) לקפיטול היל יוצא כל 20 דקות, והנסיעה נמשכת כ-11 דקות. אפשרות נוספת היא לקחת את אוטובוס קו 49, שייקח אתכם לשם תוך כ-16 דקות.

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

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

יכולות

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

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

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

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

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

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

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

לכל מקור ב-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. ‫1 שאילתת חיפוש של מסלול הגעה (שאילתה במפות 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
- 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) שאילת שאילתה אחת של חיפוש לאורך המסלול:
– תחנות דלק מ-1800 Amphibious Blvd. Mountain View, CA 94045, עד 456 Sunny St, Sunnyvale CA

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