ערכת הכלים Google Maps Platform Code Assist (בשלב הניסוי)

ערכת הכלים Google Maps Platform Code Assist היא שרת Model Context Protocol ‏(MCP) שמשפר את התשובות של מודלים גדולים של שפה (LLM) שמשמשים לפיתוח אפליקציות בפלטפורמה של מפות Google. התשובות מעוגנות בתיעוד הרשמי והעדכני ובדוגמאות קוד.

מכיוון ששרת ה-MCP ניגש לתוכן כשמזינים הנחיה למודל, ההקשר של ה-LLM לגבי Google Maps Platform לא צריך להיות מוגבל לנתונים הזמינים בתאריך האימון של המודל.

המשאבים של Google Maps Platform ששרת ה-MCP יכול לגשת אליהם כוללים:

  • מסמכי התיעוד בפלטפורמה של מפות Google
  • התנאים וההגבלות של Google Maps Platform
  • Google Maps Platform Trust Center
  • מאגרי המקורות של הקוד בארגונים הרשמיים של Google Maps Platform ב-GitHub

כלים

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

  • ‫retrieve-instructions: כלי עזר שמשמש את הלקוח כדי לקבל הוראות מערכת חיוניות לגבי הדרך הטובה ביותר להבין את כוונת המשתמש (Intent) ולנסח קריאות יעילות לכלי retrieve-google-maps-platform-docs.
  • ‫retrieve-google-maps-platform-docs: הכלי הראשי. הוא מקבל שאילתה בשפה טבעית ושולח אותה למנוע Retrieval-Augmented Generation (יצירה משולבת-אחזור, RAG) שמתארח בשרת. מנוע ה-RAG מחפש גרסאות עדכניות של מסמכים רשמיים, מדריכים ודוגמאות קוד של Google Maps Platform, ומחזיר הקשר רלוונטי ל-LLM כדי ליצור תשובה מדויקת.

חיוב

אין חיוב על השימוש ב-Maps Code Assist כשהוא בשלב הניסוי.

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

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

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

מותר להשתמש ב-Maps Code Assist רק עם מודל שפה גדול (LLM) שעומד בתנאים ובהגבלות של Google Maps Platform.

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

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

כשמציגים תוצאות שמתבססות על כלים שסופקו על ידי Maps Code Assist, צריך לכלול את המקורות המשויכים של מפות Google.

הגדרת מודלי LLM לגישה לשרת ה-MCP של Maps Code Assist

כדי להגדיר למודלים גדולים של שפה (LLM) גישה לשרת ה-MCP, פועלים לפי ההוראות במסמכי התיעוד של הגדרת ה-MCP ומשתמשים בנקודת הקצה של שרת ה-MCP של Code Assist: ‏https://mapscodeassist.googleapis.com/mcp.

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

תרחישים לדוגמה

אחרי ההגדרה, תוכלו לשאול את ה-LLM שאלות על Google Maps Platform. הנה כמה הנחיות לדוגמה:

  • "איך מוסיפים מפה לאפליקציה ל-Android?"
  • "מה הדרך הכי טובה לקבל את המיקום הנוכחי של המשתמש במפה ב-iOS?"
  • "תן דוגמה לשימוש בשירות המסלולים ב-Maps JavaScript API".

התאמה לשרת ה-MCP של Developer Knowledge

שרת ה-MCP של Developer Knowledge הוא שרת MCP מרוחק שמחפש במסמכי התיעוד הרשמיים באתרי המפתחים של Google, כולל Google Maps Platform,‏ Firebase,‏ Google Cloud ו-Android, כדי שהעוזר האישי מבוסס-AI יוכל לבסס את התשובות שלו על מסמכים עדכניים. הוא מספק את הכלים search_documents,‏ get_documents ו-answer_query, שמשלימים את הכלים של Maps Code Assist ולא מחליפים אותם. ‫Maps ‫Code Assist נוצר במיוחד בשביל Google Maps Platform, ולכן השילוב בין השניים הכי שימושי כשהפרויקט שלכם משתמש גם במוצרים אחרים של Google.

כדי להוסיף אותו לאפליקציית ה-AI לצד Maps Code Assist, פועלים לפי ההוראות במאמר הגדרת סביבת הפיתוח המשולבת (IDE) או סוכן התכנות ובוחרים את הלקוח. כדי לעזור ל-Assistant להחליט מתי לחפש במסמכי התיעוד, כדאי להתקין גם את מיומנות הסוכן retrieving-developer-knowledge. אחרי שמגדירים את שני השרתים, אפשר לשאול שאלות שקשורות לשני המוצרים, כמו:

  • "חפש את הפורמט של בקשת ההשלמה האוטומטית של Places API (החדש) ואת המסמכים של Cloud Functions for Firebase, ואז כתוב פונקציה שניתן להפעיל שמשמשת כשרת proxy לבקשות השלמה אוטומטית באמצעות מפתח ה-API המוגבל שלי".

באילו כלים אפשר להשתמש

במסמכי העזרה של Maps Code Assist MCP מפורטים כלי ה-MCP שזמינים בשרת Maps Code Assist MCP, כולל תיאורים שלהם.

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

כדי לוודא שהשרת פועל ולראות רשימה של הכלים הזמינים, אתם יכולים לשלוח בקשת HTTP מסוג tools/list ישירות לשרת ה-MCP המרוחק של Maps Code Assist. השיטה tools/list לא דורשת אימות.

curl -X POST https://mapscodeassist.googleapis.com/TOOLSET_ENDPOINT \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'MCP-Protocol-Version: MCP_PROTOCOL_VERSION' \
    -H 'Mcp-Method: tools/list' \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/list",
      "params": {
        "_meta": {
          "io.modelcontextprotocol/protocolVersion": "MCP_PROTOCOL_VERSION",
          "io.modelcontextprotocol/clientCapabilities": {
            "extensions": {
              "io.modelcontextprotocol/ui": {
                "mimeTypes": ["text/html;profile=mcp-app"]
              }
            }
          }
        }
      }
    }'

מחליפים את מה שכתוב בשדות הבאים:

  • ‫TOOLSET_ENDPOINT: החלק שנותר בנקודת הקצה של ה-MCP אחרי שם השירות. ב-Maps Code Assist, זה mcp.
  • ‫MCP_PROTOCOL_VERSION: גרסת פרוטוקול ה-MCP. לדוגמה, 2026-07-28.

שיתוף משוב

כדי לשלוח משוב על Maps Code Assist, אתם יכולים להשתמש בטפסים הבאים: