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

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

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

  • "איך מוסיפים מפה לאפליקציה ל-Android?"
  • "What is the best way to get the user's current location on a map in iOS?"
  • "תן דוגמה לשימוש בשירות המסלולים ב-Maps JavaScript 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, אתם יכולים להשתמש בטפסים הבאים: