Grounding Lite

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

כלים

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

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

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

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

חיוב ומכסות

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

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

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

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

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

מותר להשתמש ב-Grounding Lite רק עם מודל שפה גדול שעומד בתנאים ובהגבלות של 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, קודם צריך מפתח API שמופעל בו שירות ה-API‏ Maps Grounding Lite. לאחר מכן, תוכלו להגדיר מודלים של שפה גדולה (LLM) כדי לגשת לשרת MCP. שרת Grounding Lite MCP משתמש בתעבורת HTTP שניתנת להזרמה.

יצירה או הגדרה של מפתח API

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

כדי להפעיל את ה-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

  5. כדי ליצור או להגדיר מפתח API, פועלים לפי השלבים במאמר תחילת העבודה עם הפלטפורמה של מפות Google.

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

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

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

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

בקטע הזה מוסבר איך להגדיר את שרת Grounding Lite MCP באמצעות 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, אפשר להשתמש בטפסים הבאים: