Grounding Lite

‫Google Maps Platform Grounding Lite הוא שירות עם תמיכה ב-Model Context Protocol ‏(MCP) שמאפשר לעגן בקלות את אפליקציות ה-AI שלכם באמצעות נתונים גיאוספציאליים מהימנים ממפות Google. שרת ה-MCP מספק כלים שמאפשרים למודלים גדולים של שפה (LLM) לגשת ליכולות שקשורות למקומות, למזג האוויר ולמסלולים. אתם יכולים לנסות את Grounding Lite על ידי הפעלתו בכל כלי שתומך בשרתי MCP.

כלים

‫Grounding Lite מספק כלים שמאפשרים למודלים של שפה גדולה (LLM) לגשת ליכולות הבאות של מפות Google:

  • ‫Search places: שליחת בקשה לקבלת מידע על מקומות וקבלת סיכומים של נתוני מקומות שנוצרו על ידי AI, וכן מזהי מקומות, קואורדינטות של קווי רוחב ואורך וקישורים למפות Google לכל אחד מהמקומות שכלולים בסיכום. אתם יכולים להשתמש במזהי המקומות ובקואורדינטות של קווי האורך והרוחב שמוחזרים עם ממשקי API אחרים של Google Maps Platform כדי להציג מקומות במפה.
  • ‫Lookup weather: מבקש מידע על מזג האוויר ומחזיר את התנאים הנוכחיים, תחזיות שעתיות ותחזיות יומיות.

  • ‫Compute routes (חישוב מסלולים): שליחת בקשה לקבלת מידע על מסלולי נסיעה או הליכה בין שני מיקומים והחזרת מידע על המרחק ומשך המסלול.

הפעלת שרת ה-MCP של Maps Grounding Lite מאפשרת למודלים גדולים של שפה (LLM) להפעיל את הכלים החדשים שנחשפים על ידי השרת כדי להחזיר מידע נוסף על העיגון של סוגי הנתונים שצוינו למעלה. ה-LLM יכול להשתמש במידע הנוסף הזה כדי לקבל הקשר, אבל יכול להיות שהתשובה שהוא יפיק בסופו של דבר לא תכלול את המידע המדויק שהוחזר משרת ה-MCP. חשוב לאמת את הדיוק של התשובה שנוצרה.

אפשר לנסות את אפליקציית הדוגמה Grounding Lite (פתיחה בכרטיסייה חדשה)

חיוב ומכסות

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

  • חיפוש מקומות: 100 שאילתות לדקה, לכל פרויקט. ‫1,000 שאילתות ביום לכל פרויקט.
  • חיפוש מזג אוויר: 300 שאילתות בדקה, לכל פרויקט.
  • חישוב מסלולים: 300 שאילתות לדקה, לכל פרויקט.

מדיניות ותנאים והגבלות

השימוש ב-Grounding Lite כפוף לתנאים ולהגבלות של הפלטפורמה של מפות Google, כולל התנאים הספציפיים לשירות. בקטע הזה מפורטות דרישות נוספות לשימוש בשירות Grounding Lite, כולל מודלים תואמים של LLM ודרישות שיוך למקור.

הדרישות למודלים תואמים של LLM

מותר להשתמש ב-Grounding Lite רק עם מודל LLM שעומד בדרישות התנאים וההגבלות של Google Maps Platform.

לדוגמה, באחריותכם לוודא שתוכן מפות Google לא נשמר במטמון, לא מאוחסן ולא משמש לשיפור מודל שפה גדול (LLM) שבחרתם להשתמש בו. לפני שמשתמשים ב-Grounding Lite, צריך לעיין בתנאים ובהגבלות של כל מודל שמתכוונים להשתמש בו עם Grounding Lite. אסור להשתמש ב-Grounding Lite עם מודלים שמשתמשים בנתונים שמוזנים למודל לצורך אימון או שיפור המודל. באחריותכם לוודא שהשימוש שלכם במודל עומד באופן מלא בהגבלות על תוכן של מפות Google שמפורטות בתנאים ובהגבלות של Google Maps Platform, כולל התנאים הספציפיים לשירות.

דרישות ייחוס למקורות של מפות Google

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

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

מקורות לכלי 'חיפוש מקומות'

הכלי search_places בשדה places מספק מקורות שתומכים בsummary. עבור places, מוחזרים המטא-נתונים הבאים:

  • place (שם המשאב)
  • id
  • location
  • googleMapsLinks

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

הגדרת מודלים גדולים של שפה (LLM) לשימוש בשרת MCP

כדי להשתמש ב-Grounding Lite, קודם צריך פרויקט ב-Google Cloud שבו מופעל שירות ה-API‏ Maps Grounding Lite, וגם מפתח API או מזהה לקוח OAuth. לאחר מכן, תוכלו להגדיר מודלים של שפה גדולה (LLM) כדי לגשת לשרת ה-MCP. שרת MCP של Grounding Lite משתמש בתעבורת HTTP שניתנת להזרמה.

הפעלת השירות Maps Grounding Lite בפרויקט ב-Google Cloud

כדי להפעיל את ה-API בפרויקט:

  1. במסוף Google Cloud, בוחרים את הפרויקט שרוצים להשתמש בו ב-Grounding Lite.
  2. מפעילים את החיוב בפרויקט במסוף Google Cloud.
  3. בתפריט הניווט העליון, פותחים את הטרמינל של Cloud Shell.

  4. מריצים את הפקודות הבאות כדי להפעיל את השירות ואת נקודת הקצה של MCP:

    gcloud beta services enable mapstools.googleapis.com --project=PROJECT_ID
gcloud beta services mcp enable mapstools.googleapis.com --project=PROJECT_ID

אימות באמצעות מפתח API

אתם יכולים להשתמש במפתח API קיים עם Maps Grounding Lite או ליצור מפתח חדש, בתנאי שתפעילו את שירות Maps Grounding Lite API בפרויקט ב-Google Cloud ובמפתח.

כדי לבצע אימות באמצעות מפתח API:

  1. כדי ליצור או להגדיר מפתח API, פועלים לפי השלבים במאמר תחילת העבודה עם הפלטפורמה של מפות Google.
  2. מעבירים את המפתח לשרת ה-MCP באמצעות הכותרת X-Goog-Api-Key. צריך לציין את זה ככותרת HTTP מותאמת אישית בהגדרות של כלי ה-MCP של ה-LLM.

אימות באמצעות OAuth

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

כדי לבצע אימות באמצעות OAuth:

  1. במסוף Google Cloud, בוחרים את הפרויקט שרוצים להשתמש בו ב-Grounding Lite.
  2. בתפריט API & Services, בוחרים באפשרות Credentials.
  3. בתפריט העליון, בוחרים באפשרות Create credentials > OAuth client ID (יצירת פרטי כניסה > מזהה לקוח OAuth).
  4. אם בפרויקט לא מוגדר מסך הסכמה, לוחצים על Configure consent screen ופועלים לפי ההוראות במסך.
  5. בקטע מדדים, לוחצים על יצירת לקוח OAuth.
  6. במסך Create OAuth client ID (יצירת מזהה לקוח OAuth), בוחרים סוג אפליקציה ומזינים שם למזהה הלקוח.
  7. מציינים את הפרטים הנוספים שרלוונטיים לסוג האפליקציה. לדוגמה, אם אתם יוצרים אפליקציית אינטרנט, צריך להוסיף כתובות URI מורשות לבקשות של דפדפן ושרת.
  8. אחרי שיוצרים את הלקוח, שומרים את מספר הלקוח ואת הסוד.
  9. כשמגדירים את אפליקציית שרת ה-MCP או מארח ה-MCP כדי לגשת ל-Grounding Lite, צריך להעביר את מזהה הלקוח והסוד של OAuth.

למידע נוסף, תוכלו לקרוא את המאמר שימוש ב-OAuth 2.0 לגישה ל-Google APIs.

הגדרת מודלים של שפה גדולה (LLM) לגישה לשרת ה-MCP של Grounding Lite

אחרי שיש לכם פרויקט ב-Google Cloud עם השירות Maps Grounding Lite API מופעל ועם פרטי כניסה תקינים, כמו מפתח API או מזהה לקוח וסוד לקוח של OAuth, אתם יכולים להגדיר מודלים של LLM כדי לגשת לשרת MCP. לשם כך, צריך לפעול לפי הוראות ההגדרה של MCP ולהשתמש בכתובת ה-URL של שרת Grounding Lite MCP:‏ https://mapstools.googleapis.com/mcp

מידע נוסף זמין במאמר בנושא הגדרת MCP באפליקציית AI.

הגדרת Grounding Lite באמצעות Gemini CLI

בקטע הזה מוסבר איך להגדיר את שרת ה-MCP של Grounding Lite באמצעות Gemini CLI. פרטים נוספים זמינים במאמר שרתי MCP עם Gemini CLI.

  1. אחרי שמתקינים את Gemini CLI, אפשר להשתמש בפקודה add כדי להגדיר את שרת ה-MCP של Maps Grounding Lite:

    gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp

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

  2. כדי לוודא שהשרת פועל בצורה תקינה, מריצים את הפקודה /mcp list:

    > /mcp list

Configured MCP servers:

maps-grounding-lite-mcp - Ready (3 tools)
Tools:
-   compute_routes
-   lookup_weather
-   search_places

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

שיתוף משוב

כדי לשלוח משוב על Grounding Lite, אפשר להשתמש בטפסים הבאים: