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