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.

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

דרישות ייחוס למקורות של מפות 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. מפעילים את Grounding Lite בספריית ה-API של מסוף Google Cloud.

אימות באמצעות מפתח 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, אפשר להשתמש בטפסים הבאים: