מפרט כלים

כל 42 הכלים, עם כל פרמטר, ברירת מחדל, מגבלה ודוגמה. אותו ממשק זמין דרך MCP ו-CLI.

מוסכמות הפעלה

הדוגמאות הן אובייקטי ארגומנטים של MCP. בקריאת MCP ישירה מסוג tools/call, השתמשו בשם הכלי ב-name ובאובייקט ב-arguments. מארחים עשויים להוסיף קידומת לשמות. קריאות CLI המקבילות להלן משתמשות ב-mcp-gmap-rs call TOOL --args JSON.

רק לפרמטרים ברמה העליונה יש אפשרויות CLI. העבירו אובייקטים מקוננים ומערכים כ-JSON. אפשרות בוליאנית ללא ערך פירושה true; --flag false מגדיר false. מאפיינים לא מוכרים נדחים. בדקו את הגרסה המותקנת עם tools או schema TOOL.

אימות Google ושפה הם הגדרות תהליך, לא פרמטרים של כלי. קואורדינטות מדויקות מונעות פתרון כתובות; מיקומים לפי שם עשויים לדרוש גם מפתח API ל-Geocoding. ראו אימות זהות ותצורה.

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

סוגים, שדות נדרשים וגבולות הסכמה מגיעים מהמפרט הנגזר מסכמות קובץ ההפעלה. ברירות מחדל, תיאורי תוצאות ומגבלות בין שדות נבדקים מול המימוש. Google עשויה להטיל מגבלות כיסוי ומכסה נוספות.

מאפיינים לא מוכרים ברמה העליונה נדחים; גופי בקשות מקוריים של ה־API מקבלים שדות של Google, שנבדקים בידי Google. פעולות שינוי אינן מתבצעות שוב אוטומטית.

כלים

• maps_geocode
• maps_validate_address
• maps_pollen
• maps_area_insights
• maps_snap_to_roads
• maps_nearest_roads
• maps_reverse_geocode
• maps_search_places
• maps_search_nearby
• maps_place_details
• maps_directions
• maps_distance_matrix
• maps_elevation
• maps_timezone
• maps_weather
• maps_air_quality
• maps_static_map
• maps_batch_geocode
• maps_explore_area
• maps_plan_route
• maps_compare_places
• maps_search_along_route
• maps_local_rank_tracker
• maps_speed_limits
• maps_autocomplete
• maps_geolocate
• maps_solar
• maps_aerial_view
• maps_render_aerial_video
• maps_map_tiles
• maps_streetview
• maps_streetview_publish
• maps_datasets
• maps_route_optimization
• maps_air_quality_forecast
• maps_air_quality_history
• maps_air_quality_heatmap
• maps_pollen_heatmap
• maps_weather_history
• maps_weather_alerts
• maps_weather_minute_forecast
• maps_weather_map

maps_geocode

המרת כתובת או אתר לציון לקואורדינטות.

פתרון כתובת או אתר לציון להתאמת Geocoding הראשונה לקבלת קואורדינטות ומזהה מקום לשימוש חוזר; אינו מאמת אפשרות משלוח דואר.

פקודת CLI: geocode. גישה ל-Google: נדרש מפתח API במימוש זה.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
address / --address	מחרוזת; לפחות 1 תווים	כן	—	כתובת, עיר או אתר לציון לקידוד גאוגרפי.

התנהגות ומגבלות

• אין התאמה הוא שגיאת כלי, ולא מיקום ריק מוצלח.
• כלי ישיר זה משתמש ב-Geocoding v3; גיבוי Places משמש בכלים משולבים הפותרים מיקומים, ולא בקריאה זו.

תוצאה

אובייקט הכולל location.lat, location.lng, formatted_address ו-place_id. רק התוצאה הראשונה מוחזרת.

דוגמה

ארגומנטי MCP:

{
  "address": "Eiffel Tower, Paris, France"
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_geocode --args '{"address":"Eiffel Tower, Paris, France"}'

maps_validate_address

אימות כתובת למשלוח ותקנונה; מחזיר מסקנה, תיקונים, רכיבים וקידוד גאוגרפי של Google. המסקנה היא ראיה ולא הבטחת משלוח.

אימות רכיבי כתובת והחזרת תיקונים, כתובת תקנית ומסקנת Google. יש להשאיר מסקנה ורכיבים לא פתורים גלויים לקורא.

פקודת CLI: validate-address. גישה ל-Google: מפתח API או OAuth לממשק המרכזי.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
addressLines / --address-lines	מערך מחרוזות; 1–10 פריטים; כל פריט לפחות 1 תווים	כן	—	שורה אחת או יותר של כתובת למשלוח, לפי הסדר.
administrativeArea / --administrative-area	מחרוזת; לפחות 1 תווים	לא	לא מסופק	מדינה, מחוז או יחידה מנהלית מקבילה.
enableUspsCass / --enable-usps-cass	בוליאני	לא	false	בקשת עיבוד USPS CASS; במימוש זה regionCode חייב להיות US או PR כשהערך true.
locality / --locality	מחרוזת; לפחות 1 תווים	לא	לא מסופק	עיר או יישוב.
postalCode / --postal-code	מחרוזת; לפחות 1 תווים	לא	לא מסופק	מיקוד או ZIP.
regionCode / --region-code	מחרוזת; תבנית: ^[A-Z]{2}$	לא	לא מסופק; Google עשויה להסיק אותו	קוד מדינה או אזור בן שתי אותיות גדולות; מומלץ להסרת עמימות בכתובת.
sessionToken / --session-token	מחרוזת; לפחות 1 תווים	לא	ללא קיבוץ למפגש; חיוב לכל בקשה	אסימון בטוח ל-URL שנוצר בידי הקורא, עד 36 תווי ASCII; מומלץ UUID v4 חדש לכל מפגש. יש להעביר אותו גם ל-Place Details או Address Validation המסיים.

התנהגות ומגבלות

• מסקנת אימות אינה הבטחת משלוח.
• כיסוי אזורי ו-API משתנה. הכלי אינו שולח משוב אימות ואינו מאשר תיקונים אוטומטית.

תוצאה

תשובת האימות המלאה, בדרך כלל עם result.verdict, result.address, result.geocode ו-responseId; Google עשויה להשמיט שדות שאינם זמינים.

דוגמה

ארגומנטי MCP:

{
  "addressLines": [
    "5 Avenue Anatole France"
  ],
  "regionCode": "FR",
  "locality": "Paris",
  "postalCode": "75007"
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_validate_address --args '{"addressLines":["5 Avenue Anatole France"],"regionCode":"FR","locality":"Paris","postalCode":"75007"}'

maps_pollen

קבלת תחזית אבקנים, מדדים והמלצות בריאות ל-1–5 ימים בקואורדינטות מדויקות. הכיסוי משתנה לפי מיקום ועונה.

שליפת תחזית אבקנים יומית קצרה לקואורדינטות מדויקות. התשובה שומרת סוגי אבקנים, מדדים, מידע על צמחים והמלצות ספק.

פקודת CLI: pollen. גישה ל-Google: נדרש מפתח API במימוש זה.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
days / --days	מספר שלם; 1–5	לא	1	מספר רשומות תחזית יומיות לבקשה.
latitude / --latitude	מספר; -90.0–90.0	כן	—	קו רוחב WGS84 במעלות עשרוניות; צפון חיובי.
longitude / --longitude	מספר; -180.0–180.0	כן	—	קו אורך WGS84 במעלות עשרוניות; מזרח חיובי.
plantsDescription / --plants-description	בוליאני	לא	false	הכללת תיאורי צמחים מפורטים ומידע קשור כשזמין.

התנהגות ומגבלות

• הבקשות משתמשות בגודל עמוד 5, המספיק לבקשה המרבית של חמישה ימים; עמודים נוספים אינם נשלפים אוטומטית.
• הזמינות תלויה במיקום, בעונה ובכיסוי Google.

תוצאה

תשובת Pollen המקורית, כולל regionCode, dailyInfo וכל nextPageToken. כל יום עשוי לכלול מידע על סוגי אבקנים וצמחים.

דוגמה

ארגומנטי MCP:

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "days": 3,
  "plantsDescription": false
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_pollen --args '{"latitude":48.8584,"longitude":2.2945,"days":3,"plantsDescription":false}'

maps_area_insights

ספירת מקומות במעגל, באזור או במצולע באמצעות Places Aggregate. מזהים אופציונליים זמינים רק לספירה של 100 ומטה; אין בקשות פרטים אוטומטיות.

ספירת מקומות מתאימים במעגל, באזור או במצולע עם Places Aggregate. זו שאילתה מצטברת ולא ספירת עמוד חיפוש Places מוגבל.

פקודת CLI: area-insights. גישה ל-Google: מפתח API או OAuth לממשק המרכזי.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
area / --area	אובייקט	כן	—	אחד בלבד מבין circle, region או customArea.
area.circle	אובייקט	לא	לא מסופק	אזור מעגלי; אינו משולב עם region או customArea.
area.circle.latLng	אובייקט	כשהאובייקט ההורה מסופק	—	מרכז המעגל בקואורדינטות מדויקות.
area.circle.latLng.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	—	קו רוחב WGS84 במעלות עשרוניות; צפון חיובי.
area.circle.latLng.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	—	קו אורך WGS84 במעלות עשרוניות; מזרח חיובי.
area.circle.radius	מספר שלם; 23–50000	כשהאובייקט ההורה מסופק	—	רדיוס המעגל במטרים.
area.customArea	אובייקט	לא	לא מסופק	אזור מצולע מותאם; אינו משולב עם circle או region.
area.customArea.polygon	אובייקט	כשהאובייקט ההורה מסופק	—	גבול המצולע.
area.customArea.polygon.coordinates	מערך אובייקטים; 4–1000 פריטים	כשהאובייקט ההורה מסופק	—	טבעת מסודרת של אובייקטי קואורדינטות; הראשונה והאחרונה חייבות להיות זהות.
area.customArea.polygon.coordinates[].latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	—	קו רוחב WGS84 במעלות עשרוניות; צפון חיובי.
area.customArea.polygon.coordinates[].longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	—	קו אורך WGS84 במעלות עשרוניות; מזרח חיובי.
area.region	אובייקט	לא	לא מסופק	אזור מנהלי או גאוגרפי המזוהה באמצעות משאב מקום Google.
area.region.place	מחרוזת; תבנית: ^places/[A-Za-z0-9_-]+$	כשהאובייקט ההורה מסופק	—	משאב אזור בפורמט places/PLACE_ID, ולא שם אזור בטקסט חופשי.
excludedTypes / --excluded-types	מערך מחרוזות; 1–50 פריטים; כל פריט לפחות 1 תווים	לא	ללא מסנן סוגים מוחרגים	סוגי מקומות Google להחרגה.
includePlaces / --include-places	בוליאני	לא	false	בקשת מזהי משאבי מקומות מתאימים בנוסף לספירה.
includedTypes / --included-types	מערך מחרוזות; 1–50 פריטים; כל פריט לפחות 1 תווים	כן	—	סוגי מקומות Google להכללה, כגון restaurant או cafe.
maxRating / --max-rating	מספר; 1.0–5.0	לא	ללא מסנן ציון עליון	גבול עליון כולל לציון.
minRating / --min-rating	מספר; 1.0–5.0	לא	ללא מסנן ציון תחתון	גבול תחתון כולל לציון; אינו יכול לעלות על maxRating.
operatingStatus / --operating-status	מערך מחרוזות; 1–3 פריטים; ערכים: OPERATING_STATUS_OPERATIONAL, OPERATING_STATUS_PERMANENTLY_CLOSED, OPERATING_STATUS_TEMPORARILY_CLOSED	לא	ברירת המחדל של Google היא מקומות פעילים	מצבי פעילות מותרים.
priceLevels / --price-levels	מערך מחרוזות; 1–5 פריטים; ערכים: PRICE_LEVEL_FREE, PRICE_LEVEL_INEXPENSIVE, PRICE_LEVEL_MODERATE, PRICE_LEVEL_EXPENSIVE, PRICE_LEVEL_VERY_EXPENSIVE	לא	כל רמות המחירים	רמות מחירים מותרות.

התנהגות ומגבלות

• ספקו צורת אזור אחת בדיוק. אובייקטים מקוננים הם ערכי JSON ב-CLI; לפרמטרי הבנים אין אפשרויות עצמאיות.
• טבעות מצולע חייבות להיות סגורות. Google בודקת גם גאומטריה, סוגים נתמכים, שטח וכיסוי.
• מזהי מקומות זמינים רק בספירה של 100 ומטה. הכלי אינו מבקש Place Details אוטומטית.

תוצאה

תשובת Google עם count (בדרך כלל מחרוזת int64) ומשאבי placeInsights[].place אופציונליים כשהמזהים התבקשו וזמינים.

דוגמה

ארגומנטי MCP:

{
  "area": {
    "circle": {
      "latLng": {
        "latitude": 48.8584,
        "longitude": 2.2945
      },
      "radius": 500
    }
  },
  "includedTypes": [
    "restaurant"
  ],
  "minRating": 4
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_area_insights --args '{"area":{"circle":{"latLng":{"latitude":48.8584,"longitude":2.2945},"radius":500}},"includedTypes":["restaurant"],"minRating":4}'

maps_snap_to_roads

התאמת תוואי GPS מסודר של 2–100 נקודות לכבישים. מומלץ מרחק של כ-300 מטר בין נקודות עוקבות. אינטרפולציה אופציונלית מוסיפה גאומטריית כביש.

התאמת תוואי GPS מסודר לגאומטריית הכביש הסבירה ביותר. לנקודות עצמאיות השתמשו ב-Nearest Roads ולא בתוואי נסיעה.

פקודת CLI: snap-to-roads. גישה ל-Google: נדרש מפתח API במימוש זה.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
interpolate / --interpolate	בוליאני	לא	false	הוספת גאומטריית כביש ביניים בין הנקודות שסופקו.
path / --path	מערך אובייקטים; 2–100 פריטים	כן	—	אובייקטי קואורדינטות GPS בסדר הנסיעה.
path[].latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	—	קו רוחב WGS84 במעלות עשרוניות; צפון חיובי.
path[].longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	—	קו אורך WGS84 במעלות עשרוניות; מזרח חיובי.

התנהגות ומגבלות

• נקודות קלט עוקבות צריכות להיות במרחק של כ-300 מטר לקבלת התאמה טובה.
• לנקודות אינטרפולציה ייתכן שאין originalIndex. הכלי אינו מבקש מגבלות מהירות.

תוצאה

תשובת Roads המקורית, כולל snappedPoints וכל warningMessage. הנקודות שומרות placeId, location ו-originalIndex כשסופקו.

דוגמה

ארגומנטי MCP:

{
  "path": [
    {
      "latitude": -35.27801,
      "longitude": 149.12958
    },
    {
      "latitude": -35.28032,
      "longitude": 149.12907
    }
  ],
  "interpolate": true
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_snap_to_roads --args '{"path":[{"latitude":-35.27801,"longitude":149.12958},{"latitude":-35.28032,"longitude":149.12907}],"interpolate":true}'

maps_nearest_roads

מציאת מקטעי הכביש הקרובים ל-1–100 נקודות GPS עצמאיות; נשמרים originalIndex ומזהי כבישים של Google.

מציאת מקטעי כביש ליד נקודות GPS עצמאיות בלי לפרש אותן כתוואי רציף אחד.

פקודת CLI: nearest-roads. גישה ל-Google: נדרש מפתח API במימוש זה.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
points / --points	מערך אובייקטים; 1–100 פריטים	כן	—	אובייקטי קואורדינטות עצמאיים להתאמה.
points[].latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	—	קו רוחב WGS84 במעלות עשרוניות; צפון חיובי.
points[].longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	—	קו אורך WGS84 במעלות עשרוניות; מזרח חיובי.

התנהגות ומגבלות

• נקודה יכולה להתאים לכמה מקטעי כביש; שמרו originalIndex במקום להניח פלט אחד לכל קלט.
• הכלי אינו מבקש מגבלות מהירות.

תוצאה

תשובת Roads המקורית עם snappedPoints, placeId של הכביש, location ו-originalIndex המקשר לנקודות הקלט.

דוגמה

ארגומנטי MCP:

{
  "points": [
    {
      "latitude": -35.27801,
      "longitude": 149.12958
    },
    {
      "latitude": -35.28032,
      "longitude": 149.12907
    }
  ]
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_nearest_roads --args '{"points":[{"latitude":-35.27801,"longitude":149.12958},{"latitude":-35.28032,"longitude":149.12907}]}'

maps_reverse_geocode

המרת קואורדינטות לכתובת רחוב.

המרת קואורדינטות מדויקות לתוצאת Geocoding הפוכה הראשונה. השתמשו ברכיבי התוצאה כשהכתובת המעוצבת אינה מספיקה.

פקודת CLI: reverse-geocode. גישה ל-Google: נדרש מפתח API במימוש זה.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
latitude / --latitude	מספר; -90.0–90.0	כן	—	קו רוחב WGS84 במעלות עשרוניות; צפון חיובי.
longitude / --longitude	מספר; -180.0–180.0	כן	—	קו אורך WGS84 במעלות עשרוניות; מזרח חיובי.

התנהגות ומגבלות

• רק התוצאה הראשונה מוחזרת. אין התאמה הוא שגיאת כלי.

תוצאה

תוצאת Geocoding המקורית הראשונה, כולל formatted_address, address_components, geometry ו-place_id כשזמינים.

דוגמה

ארגומנטי MCP:

{
  "latitude": 48.8584,
  "longitude": 2.2945
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_reverse_geocode --args '{"latitude":48.8584,"longitude":2.2945}'

maps_search_places

חיפוש טקסט ב-Places (New) עם מסנני מיקום וציון אופציונליים.

חיפוש ב-Places (New) בטקסט ועם מסנני מיקום, ציון וסוג אופציונליים. השתמשו במזהים שהוחזרו לבקשות פרטים סלקטיביות.

פקודת CLI: search-places. גישה ל-Google: מפתח API או OAuth לממשק המרכזי.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
includedType / --included-type	מחרוזת; לפחות 1 תווים	לא	ללא מסנן סוג	סוג מקום Google, כגון cafe.
locationBias / --location-bias	אובייקט	לא	ללא הטיית מיקום	הטיית חיפוש מעגלית אופציונלית; הטיה אינה מגבלה גאוגרפית קשיחה.
locationBias.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	—	קו רוחב WGS84 במעלות עשרוניות; צפון חיובי.
locationBias.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	—	קו אורך WGS84 במעלות עשרוניות; מזרח חיובי.
locationBias.radius	מספר; 0.1–50000.0	לא	5000	רדיוס ההטיה במטרים.
minRating / --min-rating	מספר; 0.0–5.0	לא	ללא מסנן ציון	ציון המשתמש המינימלי המבוקש מ-Google.
openNow / --open-now	בוליאני	לא	ללא הגבלת מצב פתיחה	הגבלה למקומות פתוחים כעת כשהערך true.
query / --query	מחרוזת; לפחות 1 תווים	כן	—	שאילתת מקום בשפה טבעית.

התנהגות ומגבלות

• הכלי מבקש עמוד אחד של 20 תוצאות ואינו מחזיר או עוקב אוטומטית אחר אסימון עמוד.
• היעדר נתוני פתיחה או ציון תלוי בכיסוי Google; אין להסיק מלאי ממצה מהחיפוש.

תוצאה

מערך של עד 20 אובייקטי Google Place עם שדות חיפוש נבחרים, קישורי Maps/מקור ומטא-נתוני ייחוס.

דוגמה

ארגומנטי MCP:

{
  "query": "coffee near Gare de Lyon, Paris",
  "openNow": true,
  "minRating": 4
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_search_places --args '{"query":"coffee near Gare de Lyon, Paris","openNow":true,"minRating":4}'

maps_search_nearby

מציאת מקומות סביב כתובת או קואורדינטות מדויקות, בסינון סוג, ציון ומצב פתיחה.

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

פקודת CLI: search-nearby. גישה ל-Google: Places מקבל מפתח API או OAuth. מרכזים לפי כתובת או אתר לציון דורשים גם מפתח API לפתרון Geocoding.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
center / --center	אובייקט	כן	—	קלט המרכז והדגל המתאר איך לפרשו.
center.isCoordinates	בוליאני	לא	false	התייחסות ל-value כקואורדינטות מדויקות ללא קידוד גאוגרפי.
center.value	מחרוזת; לפחות 1 תווים	כשהאובייקט ההורה מסופק	—	כתובת או אתר לציון, או מחרוזת latitude,longitude כשהערך isCoordinates הוא true.
keyword / --keyword	מחרוזת; לפחות 1 תווים	לא	ללא מסנן סוג	סוג מקום Google המועבר כ-includedTypes, כגון cafe; לא מילת חיפוש חופשית.
minRating / --min-rating	מספר; 0.0–5.0	לא	ללא מסנן ציון	ציון מינימלי המוחל מקומית על המקומות שהוחזרו.
openNow / --open-now	בוליאני	לא	false	שמירת תוצאות רק כש-currentOpeningHours.openNow הוא true.
radius / --radius	מספר; 0.1–50000.0	לא	1000	רדיוס חיפוש במטרים.

התנהגות ומגבלות

• בסינון, מצב פתיחה חסר אינו נחשב פתוח וציון חסר מטופל כ-0.
• מרכזים לפי כתובת דורשים פתרון מיקום; קואורדינטות מונעות קריאה נוספת זו.

תוצאה

מערך של עד 20 אובייקטי Place נבחרים. מסנני פתיחה וציון מקומיים עשויים לצמצם אותו עוד.

דוגמה

ארגומנטי MCP:

{
  "center": {
    "value": "48.8584,2.2945",
    "isCoordinates": true
  },
  "keyword": "cafe",
  "radius": 500
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_search_nearby --args '{"center":{"value":"48.8584,2.2945","isCoordinates":true},"keyword":"cafe","radius":500}'

maps_place_details

קבלת פרטי מקום, ביקורות וייחוס. כתובות תמונה אופציונליות שומרות ייחוס מחבר. הציגו מטא-נתוני מקור וגילוי לצד התוכן.

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

פקודת CLI: place-details. גישה ל-Google: מפתח API או OAuth לממשק המרכזי.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
maxPhotos / --max-photos	מספר שלם; 0–10	לא	0	מספר מרבי של חיפושי כתובות מדיה לתמונות.
placeId / --place-id	מחרוזת; לפחות 1 תווים	כן	—	מזהה מקום Google, עם קידומת places/ אופציונלית.
sessionToken / --session-token	מחרוזת; לפחות 1 תווים	לא	ללא קיבוץ למפגש; חיוב לכל בקשה	אסימון בטוח ל-URL שנוצר בידי הקורא, עד 36 תווי ASCII; מומלץ UUID v4 חדש לכל מפגש. יש להעביר אותו גם ל-Place Details או Address Validation המסיים.

התנהגות ומגבלות

• כל תמונה שנבחרה עשויה ליצור בקשה נוספת; אפס תמונות מונע קריאות אלה.
• הכלי משתמש במסכת פרטים קבועה ולא בכל שדות Google Place האפשריים. שדות לא זמינים עשויים להיעדר.

תוצאה

אובייקט Google Place מקורי למסכת השדות המבוקשת. כשמבקשים תמונות, photoUrls מכיל כתובות מדיה, ייחוס מחברי תמונות וקישורי מקור.

דוגמה

ארגומנטי MCP:

{
  "placeId": "ChIJLU7jZClu5kcR4PcOOO6p3I0",
  "maxPhotos": 1
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_place_details --args '{"placeId":"ChIJLU7jZClu5kcR4PcOOO6p3I0","maxPhotos":1}'

maps_directions

קבלת הוראות, גאומטריית מסלול, צעדי ניווט ומשך נסיעה.

חישוב מסלול בין שתי נקודות קצה והצגת נתוני Google נבחרים וסיכומים מנורמלים.

פקודת CLI: directions. גישה ל-Google: Routes ו-Places מקבלים מפתח API או OAuth. פתרון מיקומים בשמות דורש גם מפתח API ל-Geocoding; מחרוזות קואורדינטות מדויקות מונעות זאת.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
arrival_time / --arrival-time	מחרוזת; לפחות 1 תווים	לא	לא מסופק	הגעה רצויה ב-RFC 3339 עם אזור זמן; לתחבורה ציבורית בלבד.
avoid_highways / --avoid-highways	בוליאני	לא	false	הימנעות מכבישים מהירים; true נתמך רק בנהיגה.
avoid_tolls / --avoid-tolls	בוליאני	לא	false	הימנעות מכבישי אגרה; true נתמך רק בנהיגה.
departure_time / --departure-time	מחרוזת; לפחות 1 תווים	לא	לא מסופק	רגע יציאה בפורמט RFC 3339 עם Z או היסט UTC מפורש.
destination / --destination	מחרוזת; לפחות 1 תווים	כן	—	כתובת או אתר יעד, או מחרוזת latitude,longitude מדויקת.
mode / --mode	מחרוזת; ערכים: driving, walking, bicycling, transit	לא	driving	אופן נסיעה. נהיגה משתמשת בניתוב המתחשב בתנועה.
origin / --origin	מחרוזת; לפחות 1 תווים	כן	—	כתובת או אתר מוצא, או מחרוזת latitude,longitude מדויקת.
polylineQuality / --polyline-quality	מחרוזת; ערכים: OVERVIEW, HIGH_QUALITY	לא	HIGH_QUALITY כאשר trafficSegments=true; אחרת ברירת המחדל של Google היא OVERVIEW	איכות הגאומטריה: OVERVIEW או HIGH_QUALITY. בחירה מפורשת תמיד קודמת, גם OVERVIEW יחד עם trafficSegments=true. שולטת בצפיפות הנקודות בנפרד מחישובי התנועה.
trafficSegments / --traffic-segments	בוליאני	לא	false	אפשרות בוליאנית לבחירה מפורשת, לנהיגה בלבד. מבקשת TRAFFIC_ON_POLYLINE עם גאומטריה מסוג ENCODED_POLYLINE; ברירת המחדל HIGH_QUALITY חלה אלא אם polylineQuality נבחרה במפורש. מידע תנועה לאורך קווים מפעיל את תעריף Compute Routes Enterprise היקר יותר; יש להשאיר false כשאין צורך בפירוט מקטעים.

התנהגות ומגבלות

• לא ניתן לספק יחד departure_time ו-arrival_time. arrival_time מתקבל רק לתחבורה ציבורית.
• אפשרויות הימנעות דורשות נהיגה. Google מטילה מגבלות נוספות של אופן נסיעה, זמן ואזור.
• אין מסלול זמין הוא שגיאה מפורשת.
• כאשר trafficSegments=true, ‏Routes מחזיר טווחי NORMAL, ‏SLOW או TRAFFIC_JAM. מקטעי המסלול והחלקים המנורמלים משתמשים כל אחד בקו שלו ובאינדקסי נקודות עצמאיים. הטווחים של Google הם [start,end); גאומטריית המקטע שומרת את קודקוד הגבול הסופי המשותף כדי לכלול את הצלע האחרונה. כיסוי חסר או לא תקין מדווח במפורש, בלי להמציא תנועה רגילה.
• segmentMetadata.retrievedAt הוא זמן אחזור התשובה המקומי, ולא זמן תצפית התנועה של הספק; trafficObservedAt הוא null משום ש־Routes אינו מחזיר אותו. גם roadCategory ו־speedLimit הם null, כי תשובת Routes זו אינה מספקת אותם. אין קריאות משתמעות ל־Roads או מכפילי משך בצד הלקוח; הזמנים נשארים תחזיות Google.
• מקטעי תנועה מופעלים במפורש ומוגבלים לנהיגה בתוכנית זו. האפשרות מבקשת קווים עם מידע תנועה ומפעילה חיוב Compute Routes Enterprise. מפרט הטווחים; תנאי הפעלת התעריפים העדכניים.
• polylineQuality בוחרת את פירוט הגאומטריה שמחזירה Google: ‏HIGH_QUALITY משתמשת ביותר נקודות, מגדילה את התשובה ועלולה להגדיל את ההשהיה. בחירה מפורשת של OVERVIEW תקפה גם עם trafficSegments=true. כשאיכות אינה מצוינת, מקטעי תנועה משתמשים ב־HIGH_QUALITY; אחרת Google משתמשת ב־OVERVIEW. התוכנית אינה מייצרת פרטים נוספים ואינה משלימה אותם באמצעות אינטרפולציה. האיכות נפרדת מ־extraComputations: בחירת HIGH_QUALITY בלבד אינה מפעילה TRAFFIC_ON_POLYLINE. ההגדרה הרשמית של PolylineQuality.

מקורות ראשוניים: https://developers.google.com/maps/billing-and-pricing/sku-details/routes, https://developers.google.com/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#PolylineQuality, https://developers.google.com/maps/documentation/routes/traffic_on_polylines

תוצאה

אובייקט עם routes, summary, total_distance (במטרים), total_duration (בשניות) ואינדקסי אופטימיזציה אופציונליים. מסלולים כוללים מקטעים, צעדים, קו מקודד ואזהרות נבחרים. כאשר trafficSegments=true, המסלולים והחלקים כוללים גם segments מנורמלים ו־segmentMetadata.

דוגמה

ארגומנטי MCP:

{
  "origin": "48.8584,2.2945",
  "destination": "48.8606,2.3376",
  "mode": "walking"
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_directions --args '{"origin":"48.8584,2.2945","destination":"48.8606,2.3376","mode":"walking"}'

maps_distance_matrix

חישוב מרחקי נסיעה וזמנים למספר מוצאים ויעדים.

השוואת מרחק וזמן לכל צמד מוצא ויעד. בדקו תאים ושגיאות בנפרד במקום לראות בתשובה מוצלחת תוצאה מלאה.

פקודת CLI: distance-matrix. גישה ל-Google: מפתח API או OAuth לממשק המרכזי.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
avoid_highways / --avoid-highways	בוליאני	לא	false	הימנעות מכבישים מהירים; true נתמך רק בנהיגה.
avoid_tolls / --avoid-tolls	בוליאני	לא	false	הימנעות מכבישי אגרה; true נתמך רק בנהיגה.
departure_time / --departure-time	מחרוזת; לפחות 1 תווים	לא	לא מסופק	רגע יציאה בפורמט RFC 3339 עם Z או היסט UTC מפורש.
destinations / --destinations	מערך מחרוזות; 1–50 פריטים; כל פריט לפחות 1 תווים	כן	—	מחרוזות יעד: כתובות או צמדי latitude,longitude מדויקים.
mode / --mode	מחרוזת; ערכים: driving, walking, bicycling, transit	לא	driving	אופן נסיעה. נהיגה משתמשת בניתוב המתחשב בתנועה.
origins / --origins	מערך מחרוזות; 1–50 פריטים; כל פריט לפחות 1 תווים	כן	—	מחרוזות מוצא: כתובות או צמדי latitude,longitude מדויקים.

התנהגות ומגבלות

• עד 625 צמדי מוצא × יעד; תחבורה ציבורית מוגבלת ל-100 צמדים.
• לכל היותר 50 מחרוזות מוצא/יעד שאינן קואורדינטות בסך הכול. מגבלות סכמה לכל מערך אינן מבטלות מגבלות משולבות אלה.
• הימנעות מאגרה וכבישים מהירים חלה רק בנהיגה. הכלי אינו חושף arrival_time.
• בקשת HTTP אחת למטריצה עשויה לחייב כמה רכיבים.

תוצאה

אובייקט עם origin_addresses, destination_addresses, מטריצות distances ו-durations בסדר שורות, ומערך errors. ערכי תאים מוצלחים הם במטרים ובשניות; תאים כושלים או חסרים נשארים null.

דוגמה

ארגומנטי MCP:

{
  "origins": [
    "48.8584,2.2945"
  ],
  "destinations": [
    "48.8606,2.3376",
    "48.8530,2.3499"
  ],
  "mode": "walking"
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_distance_matrix --args '{"origins":["48.8584,2.2945"],"destinations":["48.8606,2.3376","48.8530,2.3499"],"mode":"walking"}'

maps_elevation

קבלת גובה במטרים לקואורדינטות גאוגרפיות.

קבלת גובה גאוגרפי לנקודות קואורדינטות מדויקות.

פקודת CLI: elevation. גישה ל-Google: נדרש מפתח API במימוש זה.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
locations / --locations	מערך אובייקטים; 1–512 פריטים	כן	—	אובייקטי קואורדינטות שעבורם מבקשים גובה.
locations[].latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	—	קו רוחב WGS84 במעלות עשרוניות; צפון חיובי.
locations[].longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	—	קו אורך WGS84 במעלות עשרוניות; מזרח חיובי.

התנהגות ומגבלות

• הכלי מחזיר את נתוני Google ללא המרת יחידות גובה.

תוצאה

מערך results המקורי של Elevation. רשומות עשויות לכלול elevation במטרים, location ו-resolution.

דוגמה

ארגומנטי MCP:

{
  "locations": [
    {
      "latitude": 48.8584,
      "longitude": 2.2945
    }
  ]
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_elevation --args '{"locations":[{"latitude":48.8584,"longitude":2.2945}]}'

maps_timezone

קבלת אזור זמן, היסטי UTC/שעון קיץ ושעה מקומית. timestamp במילישניות Unix.

פתרון זהות אזור זמן והיסטי UTC/שעון קיץ ברגע נתון, והפקת חותמת זמן מקומית.

פקודת CLI: timezone. גישה ל-Google: נדרש מפתח API במימוש זה.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
latitude / --latitude	מספר; -90.0–90.0	כן	—	קו רוחב WGS84 במעלות עשרוניות; צפון חיובי.
longitude / --longitude	מספר; -180.0–180.0	כן	—	קו אורך WGS84 במעלות עשרוניות; מזרח חיובי.
timestamp / --timestamp	מספר שלם; 0–253402300799999	לא	זמן UTC נוכחי במילישניות	מילישניות מאז תחילת Unix, ולא שניות.

התנהגות ומגבלות

• הבקשה ממירה מילישניות לשניות שלמות; דיוק של חלקי שנייה אינו נשמר.
• השעה המקומית משתמשת בהיסט הרגיל ובהיסט שעון הקיץ שהוחזרו עבור הרגע המבוקש.

תוצאה

שדות אזור זמן כגון timeZoneId, timeZoneName, rawOffset ו-dstOffset בשניות, ו-localTime נגזר בפורמט RFC 3339.

דוגמה

ארגומנטי MCP:

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "timestamp": 1793448000000
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_timezone --args '{"latitude":48.8584,"longitude":2.2945,"timestamp":1793448000000}'

maps_weather

קבלת מזג אוויר נוכחי, תחזית יומית או שעתית.

בקשת תנאים נוכחיים או עמוד אחד של נתוני תחזית יומית/שעתית לקואורדינטות מדויקות.

פקודת CLI: weather. גישה ל-Google: מפתח API או OAuth לממשק המרכזי.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
forecastDays / --forecast-days	מספר שלם; 1–10	לא	5	אורך תחזית יומית מבוקשת; בשימוש רק עם forecast_daily.
forecastHours / --forecast-hours	מספר שלם; 1–240	לא	24	אורך תחזית שעתית מבוקשת; בשימוש רק עם forecast_hourly.
latitude / --latitude	מספר; -90.0–90.0	כן	—	קו רוחב WGS84 במעלות עשרוניות; צפון חיובי.
longitude / --longitude	מספר; -180.0–180.0	כן	—	קו אורך WGS84 במעלות עשרוניות; מזרח חיובי.
type / --type	מחרוזת; ערכים: current, forecast_daily, forecast_hourly	לא	current	בחירת תנאים נוכחיים, תחזית יומית או שעתית.

התנהגות ומגבלות

• forecastDays מתעלם בסוגים אחרים; forecastHours מתעלם מחוץ ל-forecast_hourly.
• הכלי אינו עוקב אוטומטית אחר אסימוני עימוד. הטווח המבוקש עשוי לעלות על הרשומות שבעמוד תשובה אחד.
• כיסוי וזמינות תחזיות תלויים ב-Google.

תוצאה

תשובת Weather המקורית: שדות תנאים נוכחיים, forecastDays או forecastHours, לפי הסוג. שמרו יחידות, חותמות זמן וכל nextPageToken.

דוגמה

ארגומנטי MCP:

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "type": "forecast_daily",
  "forecastDays": 3
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_weather --args '{"latitude":48.8584,"longitude":2.2945,"type":"forecast_daily","forecastDays":3}'

maps_air_quality

קבלת מדדי איכות אוויר, ריכוזי מזהמים אופציונליים והמלצות בריאות.

קבלת מדדי איכות אוויר נוכחיים עם ריכוזי מזהמים והמלצות בריאות ספק אופציונליים.

פקודת CLI: air-quality. גישה ל-Google: מפתח API או OAuth לממשק המרכזי.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
includeHealthRecommendations / --include-health-recommendations	בוליאני	לא	true	בקשת חישוב המלצות בריאות של Google.
includePollutants / --include-pollutants	בוליאני	לא	false	בקשת ריכוזי מזהמים.
latitude / --latitude	מספר; -90.0–90.0	כן	—	קו רוחב WGS84 במעלות עשרוניות; צפון חיובי.
longitude / --longitude	מספר; -180.0–180.0	כן	—	קו אורך WGS84 במעלות עשרוניות; מזרח חיובי.

התנהגות ומגבלות

• ההמלצות הן נתוני ספק ולא הערכה רפואית אישית.
• הכלי חושף תנאים נוכחיים ולא נקודות קצה היסטוריות או תחזיות.

תוצאה

תשובת התנאים הנוכחיים המקורית של Air Quality, כולל מדדים ו-healthRecommendations/pollutants אופציונליים כשסופקו בידי Google.

דוגמה

ארגומנטי MCP:

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "includePollutants": true
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_air_quality --args '{"latitude":48.8584,"longitude":2.2945,"includePollutants":true}'

maps_static_map

שליפת מפת PNG עם סמנים ותוואים. MCP מחזיר תמונה מוטמעת; CLI מחזיר base64 JSON או כותב --output.

יצירת מפת PNG עם סמנים ומפרטי תוואי אופציונליים.

פקודת CLI: static-map. גישה ל-Google: נדרש מפתח API במימוש זה.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
center / --center	מחרוזת; לפחות 1 תווים	לא	לא מסופק	מרכז ככתובת או כמחרוזת latitude,longitude.
maptype / --maptype	מחרוזת; ערכים: roadmap, satellite, terrain, hybrid	לא	roadmap	סגנון מפת הבסיס.
markers / --markers	מערך מחרוזות; 1–100 פריטים; כל פריט לפחות 1 תווים	לא	ללא סמנים	מפרטי סמנים חוזרים של Google Static Maps, לדוגמה color:red|48.8584,2.2945.
path / --path	מערך מחרוזות; 1–100 פריטים; כל פריט לפחות 1 תווים	לא	ללא תוואים	מפרטי תוואי חוזרים של Google Static Maps, לדוגמה color:blue|48.8584,2.2945|48.8606,2.3376.
size / --size	מחרוזת; תבנית: ^[1-9][0-9]{0,2}x[1-9][0-9]{0,2}$	לא	600x400	ממדים בפיקסלים WIDTHxHEIGHT; זמן הריצה מגביל כל ממד ל-1–640.
zoom / --zoom	מספר שלם; 0–21	לא	מושמט; Google בוחרת או מסיקה אותו	רמת זום מפורשת.

התנהגות ומגבלות

• נדרש לפחות אחד מבין center, markers או path.
• כתובת הבקשה המלאה חייבת להתאים ל-16,384 תווים. תבנית size בסכמה רחבה ממגבלת 640 הפיקסלים בזמן הריצה.
• עיצוב סמנים ותוואים תואם לתחביר Google Static Maps. ייחוס Google נשאר בתמונה שנוצרה.

תוצאה

MCP מחזיר תוכן image/png מוטמע. CLI מחזיר JSON מסוג {mimeType,base64}, או בתים גולמיים של PNG כשמסופק --output.

דוגמה

ארגומנטי MCP:

{
  "center": "48.8584,2.2945",
  "zoom": 14,
  "size": "320x240",
  "markers": [
    "color:red|48.8584,2.2945"
  ]
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_static_map --args '{"center":"48.8584,2.2945","zoom":14,"size":"320x240","markers":["color:red|48.8584,2.2945"]}'

maps_batch_geocode

קידוד גאוגרפי של עד 50 כתובות עם הצלחה או שגיאה לכל כתובת ומקביליות מוגבלת.

קידוד גאוגרפי של רשימת כתובות מוגבלת תוך שמירה על סדר הקלט והצלחת או כישלון כל פריט.

פקודת CLI: batch-geocode. גישה ל-Google: נדרש מפתח API במימוש זה.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
addresses / --addresses	מערך מחרוזות; 1–50 פריטים; כל פריט לפחות 1 תווים	כן	—	מחרוזות כתובות או אתרים לציון לפתרון.

התנהגות ומגבלות

• משתמש במקביליות מוגבלת של עד חמש בקשות Google פעילות לתהליך.
• כשלי פריטים אינם מחייבים קוד יציאה שאינו אפס; בדקו success ו-error בכל שורה.

תוצאה

מערך בסדר הקלט. כל שורה מכילה address, success ו-data (אובייקט קידוד גאוגרפי) או error.

דוגמה

ארגומנטי MCP:

{
  "addresses": [
    "Paris, France",
    "London, UK"
  ]
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_batch_geocode --args '{"addresses":["Paris, France","London, UK"]}'

maps_explore_area

פתרון מיקום וחקירת קטגוריות עם פרטים לתוצאות המובילות. השתמשו באתרים מוגדרים לתכנון נסיעה.

פתרון מיקום אחד, חיפוש קטגוריות נבחרות סביבו והרחבת התוצאות המובילות בלבד בכל קטגוריה.

פקודת CLI: explore-area. גישה ל-Google: Places מקבל מפתח API או OAuth. מיקומים בשמות דורשים גם מפתח API ל-Geocoding.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
location / --location	מחרוזת; לפחות 1 תווים	כן	—	כתובת, אתר לציון או מחרוזת latitude,longitude מדויקת.
radius / --radius	מספר; 0.1–50000.0	לא	1000	רדיוס חיפוש קטגוריה במטרים.
topN / --top-n	מספר שלם; 1–20	לא	3	מספר מרבי של מקומות בכל קטגוריה להרחבה עם פרטים.
types / --types	מערך מחרוזות; 1–10 פריטים; כל פריט לפחות 1 תווים	לא	restaurant, cafe, tourist_attraction	קטגוריות מקומות Google לחיפוש.

התנהגות ומגבלות

• כל קטגוריה מחפשת עד 20 מקומות; count הוא ספירת העמוד שהוחזר ולא מלאי מצטבר.
• כשלי קטגוריות ופרטים נשארים גלויים בפלט עליון מוצלח.
• הקריאה המשולבת שולחת כמה בקשות Google; הגבילו קטגוריות ו-topN לצורכי המשימה.

תוצאה

אובייקט עם location שנפתר, radius ו-categories. לכל קטגוריה type/count/top או שגיאה; מקומות מורחבים עשויים לכלול details_error.

דוגמה

ארגומנטי MCP:

{
  "location": "48.8584,2.2945",
  "types": [
    "cafe"
  ],
  "radius": 500,
  "topN": 1
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_explore_area --args '{"location":"48.8584,2.2945","types":["cafe"],"radius":500,"topN":1}'

maps_plan_route

תכנון מסלול דרך 2–27 עצירות. אופטימיזציה של 2–25 עצירות ביניים, למעט תחבורה ציבורית. קואורדינטות מדויקות נשמרות.

תכנון מסלול אחד דרך עצירות מסודרות, עם בקשה אופציונלית מ-Google לסדר מחדש עצירות ביניים תוך שמירת נקודות הקצה.

פקודת CLI: plan-route. גישה ל-Google: Routes ו-Places מקבלים מפתח API או OAuth. פתרון מיקומים בשמות דורש גם מפתח API ל-Geocoding; מחרוזות קואורדינטות מדויקות מונעות זאת.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
avoid_highways / --avoid-highways	בוליאני	לא	false	הימנעות מכבישים מהירים; true נתמך רק בנהיגה.
avoid_tolls / --avoid-tolls	בוליאני	לא	false	הימנעות מכבישי אגרה; true נתמך רק בנהיגה.
departure_time / --departure-time	מחרוזת; לפחות 1 תווים	לא	לא מסופק	רגע יציאה בפורמט RFC 3339 עם Z או היסט UTC מפורש.
mode / --mode	מחרוזת; ערכים: driving, walking, bicycling, transit	לא	driving	אופן נסיעה. נהיגה משתמשת בניתוב המתחשב בתנועה.
optimize / --optimize	בוליאני	לא	true, בכפוף לתנאים אלה	בקשת אופטימיזציה לעצירות ביניים כשיש יותר משלוש עצירות בסך הכול והמצב אינו transit.
polylineQuality / --polyline-quality	מחרוזת; ערכים: OVERVIEW, HIGH_QUALITY	לא	HIGH_QUALITY כאשר trafficSegments=true; אחרת ברירת המחדל של Google היא OVERVIEW	איכות הגאומטריה: OVERVIEW או HIGH_QUALITY. בחירה מפורשת תמיד קודמת, גם OVERVIEW יחד עם trafficSegments=true. שולטת בצפיפות הנקודות בנפרד מחישובי התנועה.
stops / --stops	מערך מחרוזות; 2–27 פריטים; כל פריט לפחות 1 תווים	כן	—	כתובות או אתרים לציון מסודרים, או מחרוזות latitude,longitude מדויקות; הראשון והאחרון נשארים נקודות קצה.
trafficSegments / --traffic-segments	בוליאני	לא	false	אפשרות בוליאנית לבחירה מפורשת, לנהיגה בלבד. מבקשת TRAFFIC_ON_POLYLINE עם גאומטריה מסוג ENCODED_POLYLINE; ברירת המחדל HIGH_QUALITY חלה אלא אם polylineQuality נבחרה במפורש. מידע תנועה לאורך קווים מפעיל את תעריף Compute Routes Enterprise היקר יותר; יש להשאיר false כשאין צורך בפירוט מקטעים.

התנהגות ומגבלות

• תחבורה ציבורית תומכת רק בשתי נקודות קצה, ללא עצירות ביניים.
• האופטימיזציה חלה רק מארבע עצירות בסך הכול (לפחות שתי עצירות ביניים).
• הכלי ממטב סדר עצירות במסלול יחיד, ולא שיוך כלי רכב או משימות בצי.
• כאשר trafficSegments=true, ‏Routes מחזיר טווחי NORMAL, ‏SLOW או TRAFFIC_JAM. מקטעי המסלול והחלקים המנורמלים משתמשים כל אחד בקו שלו ובאינדקסי נקודות עצמאיים. הטווחים של Google הם [start,end); גאומטריית המקטע שומרת את קודקוד הגבול הסופי המשותף כדי לכלול את הצלע האחרונה. כיסוי חסר או לא תקין מדווח במפורש, בלי להמציא תנועה רגילה.
• segmentMetadata.retrievedAt הוא זמן אחזור התשובה המקומי, ולא זמן תצפית התנועה של הספק; trafficObservedAt הוא null משום ש־Routes אינו מחזיר אותו. גם roadCategory ו־speedLimit הם null, כי תשובת Routes זו אינה מספקת אותם. אין קריאות משתמעות ל־Roads או מכפילי משך בצד הלקוח; הזמנים נשארים תחזיות Google.
• מקטעי תנועה מופעלים במפורש ומוגבלים לנהיגה בתוכנית זו. האפשרות מבקשת קווים עם מידע תנועה ומפעילה חיוב Compute Routes Enterprise. מפרט הטווחים; תנאי הפעלת התעריפים העדכניים.
• polylineQuality בוחרת את פירוט הגאומטריה שמחזירה Google: ‏HIGH_QUALITY משתמשת ביותר נקודות, מגדילה את התשובה ועלולה להגדיל את ההשהיה. בחירה מפורשת של OVERVIEW תקפה גם עם trafficSegments=true. כשאיכות אינה מצוינת, מקטעי תנועה משתמשים ב־HIGH_QUALITY; אחרת Google משתמשת ב־OVERVIEW. התוכנית אינה מייצרת פרטים נוספים ואינה משלימה אותם באמצעות אינטרפולציה. האיכות נפרדת מ־extraComputations: בחירת HIGH_QUALITY בלבד אינה מפעילה TRAFFIC_ON_POLYLINE. ההגדרה הרשמית של PolylineQuality.

מקורות ראשוניים: https://developers.google.com/maps/billing-and-pricing/sku-details/routes, https://developers.google.com/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#PolylineQuality, https://developers.google.com/maps/documentation/routes/traffic_on_polylines

תוצאה

אובייקט עם mode, ערך optimized אפקטיבי, stops פתורים ומסודרים, legs להצגה, total_distance, total_duration, polyline ואזהרות. durationSeconds של מקטע הוא מספר שניות. כאשר trafficSegments=true, המסלולים והחלקים כוללים גם segments מנורמלים ו־segmentMetadata.

דוגמה

ארגומנטי MCP:

{
  "stops": [
    "48.8584,2.2945",
    "48.8606,2.3376",
    "48.8530,2.3499"
  ],
  "mode": "walking",
  "optimize": false
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_plan_route --args '{"stops":["48.8584,2.2945","48.8606,2.3376","48.8530,2.3499"],"mode":"walking","optimize":false}'

maps_compare_places

חיפוש והשוואת מקומות עם פרטים ומרחק נהיגה אופציונלי מ-userLocation.

מציאת רשימת מקומות מצומצמת והעשרתה, עם השוואת מרחק נהיגה מקואורדינטות משתמש מדויקות לפי בחירה.

פקודת CLI: compare-places. גישה ל-Google: Places ו-Routes האופציונלי מקבלים מפתח API או OAuth.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
limit / --limit	מספר שלם; 1–20	לא	5	מספר מרבי של מקומות מתאימים להעשרה.
query / --query	מחרוזת; לפחות 1 תווים	כן	—	שאילתת חיפוש טקסט של Places.
userLocation / --user-location	אובייקט	לא	ללא השוואת מרחק או זמן	קואורדינטות משתמש מדויקות להשוואת מרחק אופציונלית.
userLocation.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	—	קו רוחב WGS84 במעלות עשרוניות; צפון חיובי.
userLocation.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	—	קו אורך WGS84 במעלות עשרוניות; מזרח חיובי.

התנהגות ומגבלות

• ההשוואה משתמשת בנהיגה; אין לכלי פרמטר לשינוי אופן הנסיעה.
• כשלי פרטים ומרחק נשמרים במקום למחוק מקומות שימושיים אחרת.
• רק הרשימה המצומצמת המבוקשת מועשרת.

תוצאה

אובייקט עם places ו-distance_error אופציונלי. מקומות עשויים לכלול details/details_error, distance, drive_time ו-distance_errors לכל מקום.

דוגמה

ארגומנטי MCP:

{
  "query": "cafes near Eiffel Tower, Paris",
  "userLocation": {
    "latitude": 48.8584,
    "longitude": 2.2945
  },
  "limit": 3
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_compare_places --args '{"query":"cafes near Eiffel Tower, Paris","userLocation":{"latitude":48.8584,"longitude":2.2945},"limit":3}'

maps_search_along_route

מציאת מקומות לאורך מסלול באמצעות הקו המקודד שלו.

חישוב מסלול וחיפוש Places באמצעות הקו המקודד שלו, במקום לקירוב הנסיעה בחיפוש מעגלי יחיד.

פקודת CLI: search-along-route. גישה ל-Google: Routes ו-Places מקבלים מפתח API או OAuth. פתרון מיקומים בשמות דורש גם מפתח API ל-Geocoding; מחרוזות קואורדינטות מדויקות מונעות זאת.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
destination / --destination	מחרוזת; לפחות 1 תווים	כן	—	כתובת או אתר יעד המסלול, או מחרוזת latitude,longitude מדויקת.
maxResults / --max-results	מספר שלם; 1–20	לא	5	מספר מרבי של תוצאות Places המבוקשות בעמוד התשובה.
mode / --mode	מחרוזת; ערכים: driving, walking, bicycling, transit	לא	walking	אופן הנסיעה למסלול המשמש בחיפוש.
origin / --origin	מחרוזת; לפחות 1 תווים	כן	—	כתובת או אתר מוצא המסלול, או מחרוזת latitude,longitude מדויקת.
textQuery / --text-query	מחרוזת; לפחות 1 תווים	כן	—	שאילתת Places לעצירות לאורך המסלול, כגון בתי קפה או עמדות טעינה.

התנהגות ומגבלות

• ברירת המחדל היא walking, בניגוד ל-directions, matrix ו-plan-route שברירת המחדל שלהם driving.
• אין עימוד אוטומטי או הרחבת Place Details.
• הכלי אינו חושף פרמטרי יציאה, הגעה או הימנעות של directions.

תוצאה

אובייקט עם places, routingSummaries אופציונלי וה-route המחושב, כולל נתוני מסלול Google נבחרים וסיכומים מנורמלים.

דוגמה

ארגומנטי MCP:

{
  "textQuery": "cafes",
  "origin": "48.8584,2.2945",
  "destination": "48.8606,2.3376",
  "mode": "walking",
  "maxResults": 3
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_search_along_route --args '{"textQuery":"cafes","origin":"48.8584,2.2945","destination":"48.8606,2.3376","mode":"walking","maxResults":3}'

maps_local_rank_tracker

מעקב דירוג חיפוש ברשת גאוגרפית ל-1–3 מילות מפתח; מחזיר ARP, ATRP, SoLV ושגיאות לכל נקודה.

מדידת הופעת מקום יעד ב-20 תוצאות Text Search הראשונות בכל נקודת רשת גאוגרפית.

פקודת CLI: local-rank-tracker. גישה ל-Google: מפתח API או OAuth לממשק המרכזי.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
center / --center	אובייקט	כן	—	מרכז מדויק של רשת הסריקה.
center.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	—	קו רוחב WGS84 במעלות עשרוניות; צפון חיובי.
center.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	—	קו אורך WGS84 במעלות עשרוניות; מזרח חיובי.
gridSize / --grid-size	מספר שלם; 3–7	לא	3	מספר שורות ועמודות; כל המספרים השלמים 3–7 מתקבלים.
gridSpacing / --grid-spacing	מספר; 100.0–10000.0	לא	1000	מרחק במטרים בין נקודות רשת שכנות.
keyword / --keyword	מחרוזת; לפחות 1 תווים	לא	לא מסופק	מילת חיפוש אחת; השתמשו ב-keyword או keywords.
keywords / --keywords	מערך מחרוזות; 1–3 פריטים; כל פריט לפחות 1 תווים	לא	לא מסופק	אחת עד שלוש מילות חיפוש; מקבל קדימות אם שני השדות סופקו.
placeId / --place-id	מחרוזת; לפחות 1 תווים	כן	—	מזהה מקום היעד, עם קידומת places/ אופציונלית.

התנהגות ומגבלות

• נדרש לפחות keyword או keywords; שורות הסכמה הבודדות אינן מבטאות חלופה זו.
• מספר בקשות החיפוש גדל כמספר המילים × gridSize² (עד 147 לפני ניסיונות חוזרים).
• נקודות כושלות מוחרגות ממדדי הדירוג ולא מטופלות כהיעדר תקין. המדדים עשויים להיות null כשאין תצפיות שימושיות.
• דירוג חיפוש אינו ציון ביקורות המשתמשים של המקום. התוצאות הן דגימות מחיפושי טקסט מוטים, ולא הבטחה לדירוג משתמש ב-Google Maps.

תוצאה

אובייקט עם target, grid_size, grid_spacing_m ומדדים/רשת לכל מילה. ARP הוא ממוצע דירוגים שנמצאו; ATRP משתמש בדירוג 21 לשאילתות מוצלחות שהיעד נעדר מהן; SoLV הוא אחוז הנקודות המוצלחות בדירוג שלוש הראשונות. failed_points ו-found_in חושפים כיסוי.

דוגמה

ארגומנטי MCP:

{
  "keyword": "cafe",
  "placeId": "ChIJLU7jZClu5kcR4PcOOO6p3I0",
  "center": {
    "latitude": 48.8584,
    "longitude": 2.2945
  },
  "gridSize": 3,
  "gridSpacing": 500
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_local_rank_tracker --args '{"keyword":"cafe","placeId":"ChIJLU7jZClu5kcR4PcOOO6p3I0","center":{"latitude":48.8584,"longitude":2.2945},"gridSize":3,"gridSpacing":500}'

maps_speed_limits

מהירויות מותרות עם הרשאת Asset Tracking.

קבלת מהירויות מותרות לרכב במקטעי כביש לפי מסלול GPS או מזהי הצמדה של Roads. נדרשת גישת Asset Tracking; הפעלת Roads בלבד אינה מספיקה.

פקודת CLI: speed-limits. גישה ל-Google: נדרש מפתח API במימוש זה, גם במצב OAuth; יש להפעיל שירות, חיוב והגבלות מתאימות.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
path / --path	מערך אובייקטים; 1–100 פריטים	לא	לא נשלח	1–100 נקודות GPS; אינו משתלב עם roadPlaceIds. Google מצמידה לכביש לפני חיפוש המהירות.
path[].latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש לכל נקודת מסלול	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
path[].longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש לכל נקודת מסלול	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
roadPlaceIds / --road-place-ids	מערך מחרוזות; 1–100 פריטים; כל פריט לפחות 1 תווים	לא	לא נשלח	1–100 מזהי מקטע מכלי הצמדת כבישים; למזהי עסקים רגילים עשוי שלא להיות מידע. אינו משתלב עם path.
units / --units	מחרוזת; ערכים: KPH, MPH	לא	KPH	יחידת מהירות: KPH לקמ״ש או MPH למייל לשעה.

התנהגות ומגבלות

• Google דורשת רישיון Asset Tracking; פרויקטי Premium שהועברו עם יכולת זו עשויים לשמר גישה. חשבון חיוב רגיל או API פעיל אינם מוכיחים זכאות. כל רשומת speedLimits מחויבת, ובקשה אחת עשויה לחייב כמה רשומות; יש לצמצם אצוות.
• במהירויות משתנות מוחזר המקסימום לרכב. המידע אינו בזמן אמת ועשוי להיות חסר, משוער או מיושן; יש לפעול לפי שילוט ודרישות בטיחות. שגיאת 403 שומרת סיבה מסוננת ומוסיפה הנחיית גישה, אך יכולה לנבוע גם מהפעלה, הגבלות מפתח או הרשאות; לא כל 403 הוא רישוי.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/roads/speed-limits

מקורות ראשוניים: https://developers.google.com/maps/documentation/roads/speed-limits

תוצאה

תשובת Roads מלאה, לרבות speedLimits עם placeId, speedLimit, units, ‏snappedPoints אופציונליים למסלול, אזהרות ומטא-נתונים.

דוגמה

ארגומנטי MCP:

{
  "roadPlaceIds": [
    "ChIJs5ydyTiuEmsR0fRSlU0C7k0"
  ],
  "units": "KPH"
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_speed_limits --args '{"roadPlaceIds":["ChIJs5ydyTiuEmsR0fRSlU0C7k0"],"units":"KPH"}'

maps_autocomplete

הצעות מקומות וכתובות תוך כדי הקלדה.

חיזויי Places API New תוך כדי הקלדה, עם מקומות ושאילתות, העדפה או הגבלה גאוגרפית, מסנני סוגים ואזורים, מיקום סמן ואסימוני חיוב בניהול הקורא.

פקודת CLI: autocomplete. גישה ל-Google: מפתח API או OAuth ל-Places בהיקף Places/cloud-platform.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
includeFutureOpeningBusinesses / --include-future-opening-businesses	בוליאני	לא	false	הכללת עסקים שייפתחו בעתיד.
includePureServiceAreaBusinesses / --include-pure-service-area-businesses	בוליאני	לא	false	הכללת עסקים שמגיעים ללקוחות או מבצעים משלוחים ללא כתובת ציבורית.
includeQueryPredictions / --include-query-predictions	בוליאני	לא	false	הכללת חיזויי שאילתה לצד חיזויי מקומות.
includedPrimaryTypes / --included-primary-types	מערך מחרוזות; 0–5 פריטים; כל פריט לפחות 1 תווים	לא	כל הסוגים	עד חמישה סוגי מקומות ראשיים; (cities) או (regions) חייב להיות הערך היחיד בעת שימוש בו.
includedRegionCodes / --included-region-codes	מערך מחרוזות; 0–15 פריטים	לא	כל האזורים	עד 15 קודי אזור CLDR בני שתי אותיות; בשילוב locationRestriction נלקח החיתוך. מערך ריק אינו מגביל.
input / --input	מחרוזת; לפחות 1 תווים	כן	—	טקסט חיפוש לא ריק, לרבות שם מקום או כתובת חלקיים.
inputOffset / --input-offset	מספר שלם; 0–4294967295	לא	סוף הקלט	מיקום סמן מאפס בתווי Unicode; אינו יכול לחרוג מאורך input.
languageCode / --language-code	מחרוזת; לפחות 1 תווים	לא	ערך GOOGLE_MAPS_LANGUAGE המוגדר	תג שפה IETF BCP-47 לטקסט הזמין; Google עשויה לבחור בשפה הנתמכת הקרובה.
locationBias / --location-bias	אובייקט	לא	העדפת Google לפי IP בהיעדר שתי האפשרויות הגאוגרפיות	העדפה סביב מעגל או מלבן יחיד; תוצאות עשויות לחרוג ממנו. אינו משתלב עם locationRestriction.
locationBias.circle	אובייקט	לא	לא נשלח	אזור מעגלי; אינו משתלב עם rectangle.
locationBias.circle.center	אובייקט	כשהאובייקט ההורה מסופק	נדרש עם מעגל	מרכז המעגל בקואורדינטות WGS84.
locationBias.circle.center.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש עם מרכז	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
locationBias.circle.center.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש עם מרכז	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
locationBias.circle.radius	מספר; 0.0–50000.0	כשהאובייקט ההורה מסופק	נדרש עם מעגל	רדיוס במטרים עד 50000; חייב להיות חיובי ב-locationRestriction.
locationBias.rectangle	אובייקט	לא	לא נשלח	מלבן סגור שאינו משתלב עם circle; גבולות האורך יכולים לחצות את קו התאריך.
locationBias.rectangle.high	אובייקט	כשהאובייקט ההורה מסופק	נדרש עם מלבן	הגבול הצפון-מזרחי; קו הרוחב אינו קטן מ-low.latitude.
locationBias.rectangle.high.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש עם גבול	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
locationBias.rectangle.high.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש עם גבול	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
locationBias.rectangle.low	אובייקט	כשהאובייקט ההורה מסופק	נדרש עם מלבן	הגבול הדרום-מערבי; קו הרוחב אינו עולה על high.latitude.
locationBias.rectangle.low.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש עם גבול	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
locationBias.rectangle.low.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש עם גבול	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
locationRestriction / --location-restriction	אובייקט	לא	העדפת Google לפי IP בהיעדר שתי האפשרויות הגאוגרפיות	הגבלת תוצאות למעגל או מלבן יחיד; אינו משתלב עם locationBias.
locationRestriction.circle	אובייקט	לא	לא נשלח	אזור מעגלי; אינו משתלב עם rectangle.
locationRestriction.circle.center	אובייקט	כשהאובייקט ההורה מסופק	נדרש עם מעגל	מרכז המעגל בקואורדינטות WGS84.
locationRestriction.circle.center.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש עם מרכז	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
locationRestriction.circle.center.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש עם מרכז	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
locationRestriction.circle.radius	מספר; 0.0–50000.0	כשהאובייקט ההורה מסופק	נדרש עם מעגל	רדיוס במטרים עד 50000; חייב להיות חיובי ב-locationRestriction.
locationRestriction.rectangle	אובייקט	לא	לא נשלח	מלבן סגור שאינו משתלב עם circle; גבולות האורך יכולים לחצות את קו התאריך.
locationRestriction.rectangle.high	אובייקט	כשהאובייקט ההורה מסופק	נדרש עם מלבן	הגבול הצפון-מזרחי; קו הרוחב אינו קטן מ-low.latitude.
locationRestriction.rectangle.high.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש עם גבול	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
locationRestriction.rectangle.high.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש עם גבול	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
locationRestriction.rectangle.low	אובייקט	כשהאובייקט ההורה מסופק	נדרש עם מלבן	הגבול הדרום-מערבי; קו הרוחב אינו עולה על high.latitude.
locationRestriction.rectangle.low.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש עם גבול	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
locationRestriction.rectangle.low.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש עם גבול	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
origin / --origin	אובייקט	לא	המרחק מושמט	קואורדינטות ייחוס לחישוב המרחק הגאודזי distanceMeters.
origin.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש עם נקודת מוצא	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
origin.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש עם נקודת מוצא	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
regionCode / --region-code	מחרוזת; תבנית: ^[A-Za-z]{2}$	לא	לא נשלח	קוד אזור CLDR בן שתי אותיות לעיצוב ודירוג; אינו מגביל תוצאות לאזור.
sessionToken / --session-token	מחרוזת; לפחות 1 תווים; תבנית: ^[A-Za-z0-9_-]+$	לא	ללא קיבוץ למפגש; חיוב לכל בקשה	אסימון בטוח ל-URL שנוצר בידי הקורא, עד 36 תווי ASCII; מומלץ UUID v4 חדש לכל מפגש. יש להעביר אותו גם ל-Place Details או Address Validation המסיים.

התנהגות ומגבלות

• הכלי אינו יוצר או מסיים מפגשים אוטומטית. כל מפגש משתמש בפרטי אימות מפרויקט Google Cloud אחד ומסתיים ב-Place Details או Address Validation מתאים. יש ליצור אסימון חדש למפגש הבא; היעדרו או שימוש חוזר עלולים לגרום לחיוב לכל בקשה.
• רדיוס מעגל עד 50000 מ׳, וחיובי בהגבלה. גבולות רוחב המלבן חייבים להיות מסודרים; נתמכת חציית קו התאריך בקווי האורך. יש לשמר ייחוס Google Maps והספק; תנאי EEA וזמינות שדות עשויים להשתנות.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/autocomplete

מקורות ראשוניים: https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/autocomplete

תוצאה

תשובת suggestions מלאה: placePrediction/queryPrediction, התאמות טקסט ועיצוב, מזהי מקומות, distanceMeters אופציונלי ומטא-נתונים; ללא מסכת שדות המסירה תוכן.

דוגמה

ארגומנטי MCP:

{
  "input": "coffee near Paris",
  "sessionToken": "550e8400-e29b-41d4-a716-446655440000",
  "includedRegionCodes": [
    "FR"
  ],
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 48.8566,
        "longitude": 2.3522
      },
      "radius": 5000
    }
  },
  "includeQueryPredictions": true
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_autocomplete --args '{"input":"coffee near Paris","sessionToken":"550e8400-e29b-41d4-a716-446655440000","includedRegionCodes":["FR"],"locationBias":{"circle":{"center":{"latitude":48.8566,"longitude":2.3522},"radius":5000}},"includeQueryPredictions":true}'

maps_geolocate

הערכת מיקום לפי אנטנות ו-Wi-Fi.

הערכת מיקום מכשיר לפי אנטנות סלולריות או נקודות Wi-Fi עם גוף Geolocation JSON מקורי מלא.

פקודת CLI: geolocate. גישה ל-Google: נדרש מפתח API במימוש זה, גם במצב OAuth; יש להפעיל שירות, חיוב והגבלות מתאימות.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
body / --body	אובייקט	כן	—	אובייקט Geolocation מקורי: homeMobileCountryCode, homeMobileNetworkCode, radioType ‏gsm/cdma/wcdma/lte/nr, carrier, considerIp, cellTowers, wifiAccessPoints. תומך ב-cellId/newRadioCellId ובאות. גוף ריק מאפשר גיבוי לפי IP השרת; Google מאמתת שדות פנימיים.

התנהגות ומגבלות

• ברירת המחדל של considerIp היא true. בהיעדר תצפיות רדיו תקינות, הגיבוי מאתר את IP היציאה של השרת, לא את המשתמש; יש להגדיר body.considerIp=false כדי לאסור זאת.
• נדרשות לפחות שתי נקודות Wi-Fi קבועות ושונות פיזית. Google מוציאה כתובות MAC מקומיות ושמורות; נקודות ניידות ותצפיות לא תקינות עשויות להיכשל. Google מאמתת את פרטי הפרוטוקול; המעטפת דוחה פרמטרים חיצוניים לא מוכרים. ההערכה מקורבת ועשויה להיכשל ב-NOT_FOUND; יש לבדוק accuracy.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/geolocation/requests-geolocation

מקורות ראשוניים: https://developers.google.com/maps/documentation/geolocation/requests-geolocation

תוצאה

location.lat, location.lng ו-accuracy (רדיוס אי-ודאות במטרים), וכל שדה Google נוסף.

דוגמה

ארגומנטי MCP:

{
  "body": {
    "considerIp": false,
    "wifiAccessPoints": [
      {
        "macAddress": "00:25:9c:cf:1c:ac",
        "signalStrength": -43
      },
      {
        "macAddress": "00:25:9c:cf:1c:ad",
        "signalStrength": -55
      }
    ]
  }
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_geolocate --args '{"body":{"considerIp":false,"wifiAccessPoints":[{"macAddress":"00:25:9c:cf:1c:ac","signalStrength":-43},{"macAddress":"00:25:9c:cf:1c:ad","signalStrength":-55}]}}'

maps_solar

תובנות מבנים ושכבות אנרגיה סולרית.

שימוש בשלוש שיטות Solar הראשיות: מבנה קרוב, מטא-נתוני שכבות אזוריות והורדת GeoTIFF מוגבלת לפי מזהה נכס.

פקודת CLI: solar. גישה ל-Google: מפתח API או אסימון OAuth2 בהיקף cloud-platform; יש להפעיל API וחיוב. למשתמש האימות בפרויקט המכסה נדרשת serviceusage.services.use.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
additionalInsights / --additional-insights	מערך מחרוזות; 0–1 פריטים; ערכים: DETECTED_ARRAYS	לא	ללא תובנות נוספות	DETECTED_ARRAYS אופציונלי עבור building_insights לזיהוי מערכי גג קיימים.
exactQualityRequired / --exact-quality-required	בוליאני	לא	false	דרישת האיכות המדויקת במקום קבלת איכות גבוהה יותר, לתובנות ולשכבות.
experiments / --experiments	מערך מחרוזות; 0–1 פריטים; ערכים: EXPANDED_COVERAGE	לא	ללא ניסויים	ניסוי EXPANDED_COVERAGE אופציונלי לתובנות ולשכבות; מוגדר טרום זמינות כללית ב-Google.
id / --id	מחרוזת; לפחות 1 תווים	לא	— עבור geo_tiff	מזהה נכס אטום מפרמטר id ב-URL של שכבת Solar; עבור geo_tiff בלבד. יש לשלוח מזהה ולא כתובת.
location / --location	אובייקט	לא	לא נשלח	מיקום חיפוש הבניין או מרכז שכבות האזור; נדרש עבור building_insights/data_layers.
location.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש עם מיקום	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
location.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש עם מיקום	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
operation / --operation	מחרוזת; ערכים: building_insights, data_layers, geo_tiff	כן	—	building_insights, data_layers או geo_tiff; מתקבלים רק הפרמטרים של הפעולה שנבחרה.
pixelSizeMeters / --pixel-size-meters	מספר; ערכים: 0.1, 0.25, 0.5, 1.0	לא	0.1	גודל פיקסל מינימלי: 0.1, 0.25, 0.5 או 1 מטר; לשכבות מסוימות רזולוציה מקורית גסה יותר.
radiusMeters / --radius-meters	מספר; ללא גבול–1000	לא	לא נשלח	רדיוס חיובי עבור data_layers, עד 1000 מ׳. מעל 100 אסור לחרוג מ-pixelSizeMeters×1000; מעל 175 נדרש מבט ללא שטף חודשי או צל שעתי.
requiredQuality / --required-quality	מחרוזת; ערכים: HIGH, MEDIUM, BASE	לא	HIGH (ברירת המחדל של Google)	איכות תמונה מינימלית HIGH, MEDIUM או BASE; ‏BASE משתמשת בתצלומי לוויין משופרים. הזמינות גאוגרפית.
view / --view	מחרוזת; ערכים: DSM_LAYER, IMAGERY_LAYERS, IMAGERY_AND_ANNUAL_FLUX_LAYERS, IMAGERY_AND_ALL_FLUX_LAYERS, FULL_LAYERS	לא	FULL_LAYERS (ברירת המחדל של Google)	בחירת שכבות: DSM_LAYER, IMAGERY_LAYERS, IMAGERY_AND_ANNUAL_FLUX_LAYERS, IMAGERY_AND_ALL_FLUX_LAYERS או FULL_LAYERS.

התנהגות ומגבלות

• כיסוי ואיכות משתנים לפי מיקום; החיפוש עשוי להחזיר NOT_FOUND אם אין מבנה בטווח כ-50 מ׳. הכתובות זמניות ומאומתות; מעתיקים רק id ל-geo_tiff, המוריד מ-solar.googleapis.com/v1/geoTiff:get ללא URL שרירותי.
• מגבלת תשובה 16 MiB עם תקציב בקשות ומועד סיום; קבצים גדולים עשויים לדרוש רדיוס קטן או פיקסלים גסים. פענוח רסטר ותכנון התקנה אינם כלולים. EXPANDED_COVERAGE טרום זמינות כללית; תנאי EEA עשויים להשתנות ותוכן להישמט. חיוב ומכסות נפרדים לכל נתיב; יש לשמר ייחוס Google Maps.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/comms/eea/solar ; https://developers.google.com/maps/documentation/solar/coverage ; https://developers.google.com/maps/documentation/solar/reference/rest/v1/buildingInsights/findClosest ; https://developers.google.com/maps/documentation/solar/reference/rest/v1/dataLayers/get ; https://developers.google.com/maps/documentation/solar/reference/rest/v1/geoTiff/get

מקורות ראשוניים: https://developers.google.com/maps/comms/eea/solar, https://developers.google.com/maps/documentation/solar/coverage, https://developers.google.com/maps/documentation/solar/reference/rest/v1/buildingInsights/findClosest, https://developers.google.com/maps/documentation/solar/reference/rest/v1/dataLayers/get, https://developers.google.com/maps/documentation/solar/reference/rest/v1/geoTiff/get

תוצאה

building_insights/data_layers מחזירים JSON מלא עם תאריכים, איכות, פוטנציאל סולרי וכתובות זמניות לאחר הסרת פרטי אימות. geo_tiff מחזיר בתים מוגבלים עם MIME אמיתי וכותרות מטמון; JSON ב-CLI משתמש ב-base64.

דוגמה

ארגומנטי MCP:

{
  "operation": "data_layers",
  "location": {
    "latitude": 37.444,
    "longitude": -122.16
  },
  "radiusMeters": 100,
  "view": "IMAGERY_AND_ANNUAL_FLUX_LAYERS"
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_solar --args '{"operation":"data_layers","location":{"latitude":37.444,"longitude":-122.16},"radiusMeters":100,"view":"IMAGERY_AND_ANNUAL_FLUX_LAYERS"}'

maps_aerial_view

קישורי סרטוני Aerial View ומטא-נתונים.

קבלת קישורי ניגון קצרי חיים או מטא-נתונים של סרטון Aerial View קיים, ללא הורדת הסרטון.

פקודת CLI: aerial-view. גישה ל-Google: נדרש מפתח API במימוש זה, גם במצב OAuth; יש להפעיל שירות, חיוב והגבלות מתאימות.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
address / --address	מחרוזת; לפחות 1 תווים	לא	לא נשלח	כתובת דואר נתמכת בארה״ב; יש לבחור בדיוק אחד: address או videoId.
operation / --operation	מחרוזת; ערכים: lookup, metadata	לא	lookup	lookup מחזיר קישורי ניגון ומטא-נתונים (בחיוב); metadata מחזיר נתונים ללא קישורים (שיטת Google חינמית).
videoId / --video-id	מחרוזת; לפחות 1 תווים	לא	לא נשלח	מזהה סרטון Aerial View קודם; אינו משתלב עם address.

התנהגות ומגבלות

• כתובות נתמכות בארה״ב בלבד ובכיסוי 3D. סרטון חסר מחזיר NOT_FOUND; מבקשים יצירה ב-maps_render_aerial_video. יש לבדוק מצב ב-metadata החינמי במרווח סביר, ולהשתמש ב-lookup המחויב כשצריך לנגן.
• הקישורים פגים במהירות; יש לבקש קישור חדש לכל תצוגה. Google אוסרת הורדה, אחסון או מטמון של הסרטונים; הכלי מחזיר קישורים בלבד. ניתן לשמור מזהי סרטון לפי החריג המתועד. יש לשמר ייחוס בניגון; תנאי EEA ותפקוד עשויים להשתנות.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/aerial-view/lookup-video ; https://developers.google.com/maps/documentation/aerial-view/policies"]

מקורות ראשוניים: https://developers.google.com/maps/documentation/aerial-view/lookup-video, https://developers.google.com/maps/documentation/aerial-view/policies

תוצאה

תשובת Google מקורית עם מצב עיבוד או פעילות ומטא-נתונים, וקישורים לפי פורמט ורזולוציה כשהסרטון פעיל. metadata אינו מחזיר קישורים.

דוגמה

ארגומנטי MCP:

{
  "operation": "metadata",
  "address": "600 Montgomery St, San Francisco, CA 94111"
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_aerial_view --args '{"operation":"metadata","address":"600 Montgomery St, San Francisco, CA 94111"}'

maps_render_aerial_video

בקשה מפורשת ליצירת סרטון אווירי.

הוספת בקשת יצירת סרטון Aerial View אסינכרונית לתור לכתובת אמריקאית נתמכת. מופרדת מקריאה כדי שהסוכן יזהה את השינוי.

פקודת CLI: render-aerial-video. גישה ל-Google: נדרש מפתח API במימוש זה, גם במצב OAuth; יש להפעיל שירות, חיוב והגבלות מתאימות.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
address / --address	מחרוזת; לפחות 1 תווים	כן	—	כתובת דואר נתמכת בארה״ב לבקשת יצירת הסרטון.

התנהגות ומגבלות

• הבקשה משנה את התור של Google. אין ניסיון חוזר אוטומטי לאחר כשל זמני, אין המתנה לסיום ואין הורדת סרטון. בודקים התקדמות ב-maps_aerial_view metadata עם הכתובת או videoId; משתמשים ב-lookup רק לקישורי ניגון.
• חלות מגבלות כיסוי ארה״ב/3D, מכסות ותנאי שירות; הפעלת API אינה מבטיחה אפשרות יצירה. אין להוריד, לאחסן או לשמור מטמון סרטונים; מציגים קישורים עדכניים עם ייחוס.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo

מקורות ראשוניים: https://developers.google.com/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo

תוצאה

תשובת יצירה מקורית עם מצב ונתונים זמינים; PROCESSING מציין המתנה או עיבוד, וסרטון קיים עשוי להחזיר ACTIVE מיד.

דוגמה

ארגומנטי MCP:

{
  "address": "600 Montgomery St, San Francisco, CA 94111"
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_render_aerial_video --args '{"address":"600 Montgomery St, San Francisco, CA 94111"}'

maps_map_tiles

אריחי מפות 2D, ‏3D ו-Street View לתצוגה.

יצירת מפגשי Map Tiles וקבלת משאבי 2D, ‏3D ו-Street View למציג מפות; הכלי אינו מציג. Google מתירה אריחים להמחשה בלבד ואוסרת פירוש מכונה, ניתוח תמונות, זיהוי עצמים, חילוץ נתונים גאוגרפיים ושימוש לא מקוון.

פקודת CLI: map-tiles. גישה ל-Google: מפתח API או אסימון OAuth2 בהיקף cloud-platform; יש להפעיל API וחיוב. למשתמש האימות בפרויקט המכסה נדרשת serviceusage.services.use.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
east / --east	מספר; -180.0–180.0	לא	לא נשלח; נדרש לפעולות המתוארות	קו האורך המזרחי הנדרש; יכול להיות שלילי עם west חיובי לחציית קו התאריך.
fov / --fov	מספר; 30.0–120.0	לא	90	שדה ראייה אופקי לתמונה ממוזערת, 30–120 מעלות.
height / --height	מספר שלם; 16–250	לא	250	גובה תמונה ממוזערת, 16–250 פיקסלים.
latitude / --latitude	מספר; -90.0–90.0	לא	לא נשלח; נדרש לפעולות המתוארות	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
locations / --locations	מערך אובייקטים; 1–100 פריטים	לא	לא נשלח; נדרש לפעולות המתוארות	מיקום אחד עד 100 עבור streetview_pano_ids, כל אובייקט מכיל lat ו-lng.
locations[].lat	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	לא נשלח; נדרש לפעולות המתוארות	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
locations[].lng	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	לא נשלח; נדרש לפעולות המתוארות	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
longitude / --longitude	מספר; -180.0–180.0	לא	לא נשלח; נדרש לפעולות המתוארות	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
north / --north	מספר; -90.0–90.0	לא	לא נשלח; נדרש לפעולות המתוארות	קו הרוחב הצפוני הנדרש ל-viewport, וחייב לעלות על south.
operation / --operation	מחרוזת; ערכים: create_session, tile_2d, viewport, root_3d, resource_3d, streetview_pano_ids, streetview_metadata, streetview_thumbnail, streetview_tile	כן	—	create_session, tile_2d, viewport, root_3d, resource_3d, streetview_pano_ids, streetview_metadata, streetview_thumbnail או streetview_tile; קובע את נקודת הקצה והשדות הנדרשים.
panoId / --pano-id	מחרוזת; לפחות 1 תווים	לא	לא נשלח; נדרש לפעולות המתוארות	נדרש לאריח או תמונה ממוזערת של Street View, או חלופה לקואורדינטות במטא-נתונים. אין להסתמך עליו מעבר למפגש משתמש אחד.
pitch / --pitch	מספר; -90.0–90.0	לא	0	זווית מצלמה אנכית במעלות, בין ‎-90 ל-90.
radius / --radius	מספר; 0.0–100000.0	לא	50 מטרים	רדיוס חיפוש Street View במטרים, 0–100000, עבור pano_ids או metadata לפי קואורדינטות; אינו משתלב עם panoId.
resourceUrl / --resource-url	מחרוזת; לפחות 1 תווים	לא	לא נשלח; נדרש לפעולות המתוארות	עבור resource_3d: כתובת Google מוחלטת https://tile.googleapis.com/v1/3dtiles/... ממערכת האריחים; ללא מארח אחר, יציאה מותאמת, פרטי משתמש, מקטע או נתיב מקודד. המפתח מהכתובת מוסר ונעשה שימוש באימות המוגדר.
session / --session	מחרוזת; לפחות 1 תווים	לא	לא נשלח; נדרש לפעולות המתוארות	אסימון createSession; נדרש לבקשות 2D ו-Street View, לא ל-3D. יש לפעול לפי expiry בתשובה.
sessionOptions / --session-options	אובייקט	לא	לא נשלח; נדרש לפעולות המתוארות	אפשרויות createSession המקוריות; mapType, language ו-region נדרשים עבור create_session.
sessionOptions.highDpi	בוליאני	לא	false	הגדלת ממדי פיקסלים בקנה מידה 2x או 4x; ללא השפעה ב-1x.
sessionOptions.imageFormat	מחרוזת; ערכים: jpeg, png	לא	Google בוחרת בפורמט המתאים	פורמט jpeg או png; ‏JPEG אינו תומך בשכבות שקופות.
sessionOptions.language	מחרוזת; לפחות 1 תווים	כשהאובייקט ההורה מסופק	לא נשלח; נדרש לפעולות המתוארות	תג שפה IETF כגון en-US.
sessionOptions.layerTypes	מערך מחרוזות; 1–3 פריטים; ערכים: layerRoadmap, layerStreetview, layerTraffic	לא	ללא שכבות נוספות	שכבה אחת עד שלוש: layerRoadmap, layerStreetview, layerTraffic. ‏terrain דורש layerRoadmap.
sessionOptions.mapType	מחרוזת; ערכים: roadmap, satellite, terrain, streetview	כשהאובייקט ההורה מסופק	לא נשלח; נדרש לפעולות המתוארות	roadmap, satellite, terrain או streetview; ‏terrain דורש layerRoadmap בתוך layerTypes.
sessionOptions.overlay	בוליאני	לא	false	כאשר true, ‏layerTypes מוצגים ללא תמונת הבסיס.
sessionOptions.region	מחרוזת; תבנית: ^[A-Z]{2}$	כשהאובייקט ההורה מסופק	לא נשלח; נדרש לפעולות המתוארות	קוד CLDR בשתי אותיות גדולות כגון US, המתאר את מיקום המשתמש בפועל.
sessionOptions.scale	מחרוזת; ערכים: scaleFactor1x, scaleFactor2x, scaleFactor4x	לא	scaleFactor1x	גודל רכיבי המפה: scaleFactor1x, scaleFactor2x או scaleFactor4x.
sessionOptions.styles	מערך אובייקטים; 1–100 פריטים	לא	עיצוב ברירת המחדל של Google	אובייקטי עיצוב מפה מקוריים של Google, עבור roadmap בלבד; התחביר מתועד ב-Google.
south / --south	מספר; -90.0–90.0	לא	לא נשלח; נדרש לפעולות המתוארות	קו הרוחב הדרומי הנדרש ל-viewport.
west / --west	מספר; -180.0–180.0	לא	לא נשלח; נדרש לפעולות המתוארות	קו האורך המערבי הנדרש ל-viewport.
width / --width	מספר שלם; 16–600	לא	600	רוחב תמונה ממוזערת, 16–600 פיקסלים.
x / --x	מספר שלם; 0–4194303	לא	לא נשלח; נדרש לפעולות המתוארות	עמודת האריח; ב-2D קטנה מ-‎2^zoom. גבולות Street View תלויים בממדי הפנורמה במטא-נתונים.
y / --y	מספר שלם; 0–4194303	לא	לא נשלח; נדרש לפעולות המתוארות	שורת האריח; ב-2D קטנה מ-‎2^zoom. גבולות Street View תלויים בממדי הפנורמה במטא-נתונים.
yaw / --yaw	מספר; -360.0–360.0	לא	0	כיוון מצלמה אופקי לתמונה ממוזערת, בין ‎-360 ל-360 מעלות.
zoom / --zoom	מספר שלם; 0–22	לא	לא נשלח; נדרש לפעולות המתוארות	זום שלם: 0–22 עבור tile_2d/viewport, ‏0–5 עבור streetview_tile. יש לבדוק זמינות דרך viewport.

התנהגות ומגבלות

• create_session דורש sessionOptions; ‏tile_2d דורש session/zoom/x/y; ‏viewport דורש session/zoom/north/south/east/west; ‏root_3d ללא שדות נוספים; ‏resource_3d דורש resourceUrl; ‏pano_ids דורש session/locations; ‏metadata דורש session ומזהה פנורמה או זוג קואורדינטות; ‏thumbnail דורש session/panoId; ‏streetview_tile דורש session/panoId/zoom/x/y. שדות לא בשימוש נדחים.
• יצירת מפגש אינה מנוסה שוב אוטומטית; חיפוש פנורמות הוא POST לקריאה בלבד. המציג בהמשך אחראי לחיבור ולרינדור. אין מטמון אריחים, הורדת אזורים גורפת, מפות לא מקוונות או ניתוח תמונה. אין לשלוח תמונות למודל ראייה לפירוש או חילוץ נתונים.
• ההסכם אוסר שליפה מוקדמת, אינדוקס ואחסון לא מורשים; יש לכבד Cache-Control ו-ETag. יש להציג סמל Google Maps וייחוס ספקים. משתמשים בזכויות viewport ל-2D, בזכויות Street View ובקישור הדיווח, ובקרדיטים במציג 3D; אין לחתוך קרדיטים. כיסוי, חיוב, מכסות ותנאי EEA משתנים. פועלים לפי expiry; מזהי פנורמות זמניים.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/tile/2d-tiles-overview ; https://developers.google.com/maps/documentation/tile/3d-tiles ; https://developers.google.com/maps/documentation/tile/get-api-key ; https://developers.google.com/maps/documentation/tile/policies ; https://developers.google.com/maps/documentation/tile/session_tokens ; https://developers.google.com/maps/documentation/tile/streetview ; https://developers.google.com/maps/documentation/tile/style-reference ; https://tile.googleapis.com/v1/3dtiles/

מקורות ראשוניים: https://developers.google.com/maps/documentation/tile/2d-tiles-overview, https://developers.google.com/maps/documentation/tile/3d-tiles, https://developers.google.com/maps/documentation/tile/get-api-key, https://developers.google.com/maps/documentation/tile/policies, https://developers.google.com/maps/documentation/tile/session_tokens, https://developers.google.com/maps/documentation/tile/streetview, https://developers.google.com/maps/documentation/tile/style-reference

תוצאה

JSON מקורי למפגשים, תצוגה, פנורמות וקובצי מערכת 3D, עם ייחוס, זכויות, קישור דיווח ותוקף מפגש. תמונות ומשאבי 3D שאינם JSON מוחזרים כבתים עם MIME, ‏Cache-Control ו-ETag. ‏MCP מציג תמונות נתמכות והיתר ב-base64; ‏CLI --output כותב בתים.

דוגמה

ארגומנטי MCP:

{
  "operation": "root_3d"
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_map_tiles --args '{"operation":"root_3d"}'

maps_streetview

מטא-נתוני Street View ותמונת JPEG.

בדיקת מטא-נתוני פנורמת Street View או קבלת JPEG סטטי לפי מיקום או מזהה. אפשר לבדוק זמינות ב-metadata לפני תמונה מחויבת.

פקודת CLI: streetview. גישה ל-Google: נדרש מפתח API ל-Street View Static; ‏OAuth לבדו אינו מספיק. יש להפעיל Street View Static API. ‏Google ממליצה על חתימה דיגיטלית ובחלק מהחשבונות דורשת אותה.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
fov / --fov	מספר; 1.0–120.0	לא	90	שדה ראייה אופקי של התמונה, 1–120 מעלות.
heading / --heading	מספר; 0.0–360.0	לא	Google מכוונת למיקום שנשלח	כיוון המצלמה במצפן, בין 0 ל-360 מעלות.
height / --height	מספר שלם; 1–640	לא	400	גובה תמונה 1–640 פיקסלים, ל-image בלבד.
location / --location	מחרוזת; לפחות 1 תווים	לא	לא נשלח; נדרש לפעולות המתוארות	כתובת, זוג קואורדינטות טקסטואלי כגון 48.8584,2.2945 או place_id:PLACE_ID; יש לבחור בדיוק אחד: location או panoId.
operation / --operation	מחרוזת; ערכים: metadata, image	כן	—	metadata למטא-נתוני JSON או image לבתי JPEG.
panoId / --pano-id	מחרוזת; לפחות 1 תווים	לא	לא נשלח; נדרש לפעולות המתוארות	מזהה פנורמת Street View; עשוי להשתנות ואין להסתמך עליו לאורך זמן.
pitch / --pitch	מספר; -90.0–90.0	לא	0	זווית מצלמה אנכית במעלות, בין ‎-90 ל-90.
radius / --radius	מספר שלם; 0–100000	לא	50	רדיוס חיפוש במטרים; המימוש מקבל מספרים שלמים 0–100000.
returnErrorCode / --return-error-code	בוליאני	לא	true במימוש זה	עבור image: החזרת שגיאת HTTP במקום תמונה אפורה בהיעדר תמונות.
signature / --signature	מחרוזת; לפחות 1 תווים	לא	לא נשלח	חתימת URL אופציונלית המחושבת לבקשה המקודדת המדויקת; Google ממליצה עליה ולעיתים דורשת אותה. הכלי מעביר ואינו יוצר. בבקשות חתומות signature נוסף אחרון, אחרי מפתח ה־API. יש לחתום על הנתיב והמחרוזת המקודדים המדויקים, כולל ברירות המחדל שנוצרו. סדר תמונה: location, radius, source, pano, size, heading, fov, pitch, return_error_code, key; שדות אופציונליים חסרים מושמטים. בקשות מטא־נתונים משמיטות שדות תמונה. רווחים מקודדים כ־+. ברירות מחדל: size=640x400 ו־return_error_code=true.
source / --source	מחרוזת; ערכים: default, google, outdoor	לא	default	מקור החיפוש default, google או outdoor; הזמינות תלויה באוסף ובאזור.
width / --width	מספר שלם; 1–640	לא	640	רוחב תמונה 1–640 פיקסלים, ל-image בלבד. גדלים מיוחדים גדולים יותר אינם נתמכים.

התנהגות ומגבלות

• בוחרים location או panoId בלבד. ממדים, heading, fov, pitch ו-returnErrorCode לתמונות בלבד; שדות לא בשימוש נדחים. metadata חינמי כעת ואינו צורך מכסת תמונות; התמונות מחויבות.
• יש לשמור ייחוס מוטמע. אסור להשתמש ב-Street View להדפסה וחלות מגבלות אחסון מפות; הכלי אינו מעניק רישיון לשמירה, הפצה או ניתוח. חתימות מועברות בלבד ואינן נוצרות; גדלים מיוחדים אינם נתמכים. כיסוי ו-EEA משתנים, מזהים ותאריכים עשויים להשתנות או להיעדר.
• מקורות רשמיים ומגבלות: https://about.google/brand-resource-center/products-and-services/geo-guidelines/ ; https://developers.google.com/maps/documentation/streetview/metadata ; https://developers.google.com/maps/documentation/streetview/policies ; https://developers.google.com/maps/documentation/streetview/request-streetview

מקורות ראשוניים: https://developers.google.com/maps/documentation/streetview/metadata, https://developers.google.com/maps/documentation/streetview/policies, https://developers.google.com/maps/documentation/streetview/request-streetview

תוצאה

JSON metadata מקורי עם status, date, location, pano_id ו-copyright כאשר זמינים, או בתי JPEG עם MIME וכותרות מטמון בטוחות. תמונה חסרה היא שגיאה כברירת מחדל. CLI --output שומר בתים; MCP מציג תמונה ומטא-נתונים.

דוגמה

ארגומנטי MCP:

{
  "operation": "metadata",
  "location": "Eiffel Tower, Paris, France"
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_streetview --args '{"operation":"metadata","location":"Eiffel Tower, Paris, France"}'

maps_streetview_publish

ניהול ופרסום תמונות Street View של המשתמש.

ניהול תמונות ורצפי Google של המשתמש שנתן הסכמה. תומך בכל שיטות REST v1 המתועדות ובהעלאת בתים מוגבלת. פרסום ומחיקה מפורשים וללא ניסיונות חוזרים אוטומטיים.

פקודת CLI: streetview-publish. גישה ל-Google: OAuth למשתמש קצה בלבד בהסכמה להיקף https://www.googleapis.com/auth/streetviewpublish. משתמשים בפרטי authorized_user מפורשים ב-GOOGLE_APPLICATION_CREDENTIALS ובמצב OAuth. מפתח חשבון שירות, ADC משתמע או מפתח API לבדו נדחים. הסכמת OAuth מוגדרת חיצונית; התוכנית מרעננת פרטי אימות ואינה מארחת callback לדפדפן.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
dataBase64 / --data-base64	מחרוזת; לפחות 4 תווים	לא	לא נשלח; נדרש לפעולות המתוארות	בתי מדיה ב-base64 תקני עם ריפוד. הגודל לאחר פענוח מבית אחד עד 8 MiB; זוהי מגבלת המימוש ולא מגבלת Google.
filter / --filter	מחרוזת; לפחות 1 תווים	לא	לא נשלח; נדרש לפעולות המתוארות	ביטוי סינון מקורי של Google; התחביר תלוי בנקודת הקצה.
inputType / --input-type	מחרוזת; ערכים: VIDEO, XDM	לא	לא נשלח; נדרש לפעולות המתוארות	נדרש עבור create_sequence: ‏VIDEO או XDM.
languageCode / --language-code	מחרוזת; לפחות 1 תווים	לא	ברירת המחדל של Google	תג שפה IETF BCP-47 לטקסט הזמין; Google עשויה לבחור בשפה הנתמכת הקרובה.
mimeType / --mime-type	מחרוזת; ערכים: image/jpeg, application/octet-stream, video/mp4	לא	image/jpeg	סוג המדיה להעלאה: image/jpeg, video/mp4 או application/octet-stream.
operation / --operation	מחרוזת; ערכים: list, get, start_upload, upload, create, update, delete, batch_get, batch_update, batch_delete, list_sequences, get_sequence, start_sequence_upload, create_sequence, delete_sequence	כן	—	list/get/start_upload/upload/create/update/delete/batch_get/batch_update/batch_delete/list_sequences/get_sequence/start_sequence_upload/create_sequence/delete_sequence. פרסום, עדכון ומחיקה משנים תוכן ציבורי של המשתמש.
pageSize / --page-size	מספר שלם; 1–100	לא	ברירת המחדל של שירות Google	גודל עמוד 1–100 עבור list או list_sequences; Google עשויה להחזיר פחות.
pageToken / --page-token	מחרוזת; לפחות 1 תווים	לא	לא נשלח; נדרש לפעולות המתוארות	אסימון העמוד הבא מהתשובה הקודמת; יתר הפרמטרים נשארים ללא שינוי. אין דפדוף אוטומטי.
photo / --photo	אובייקט	לא	לא נשלח; נדרש לפעולות המתוארות	אובייקט Photo מקורי עבור create/update. יצירה דורשת uploadReference.uploadUrl לאחר העלאת הבתים; עדכון דורש photoId ו-updateMask. ראו סכמת Photo הרשמית.
photoId / --photo-id	מחרוזת; לפחות 1 תווים	לא	לא נשלח; נדרש לפעולות המתוארות	מזהה תמונת Google עבור get/update/delete, ללא נתיב או פרמטרי URL.
photoIds / --photo-ids	מערך מחרוזות; 1–100 פריטים; כל פריט לפחות 1 תווים	לא	לא נשלח; נדרש לפעולות המתוארות	אחד עד 100 מזהי תמונות עבור batch_get או batch_delete.
photoSequence / --photo-sequence	אובייקט	לא	לא נשלח; נדרש לפעולות המתוארות	אובייקט PhotoSequence מקורי עבור create_sequence; דורש uploadReference.uploadUrl ונתוני GPS/CAMM/IMU וצילום מתאימים.
sequenceId / --sequence-id	מחרוזת; לפחות 1 תווים	לא	לא נשלח; נדרש לפעולות המתוארות	מזהה הרצף עבור get_sequence/delete_sequence; מתקבל בשם הפעולה שנוצרה.
updateMask / --update-mask	מחרוזת; לפחות 1 תווים	לא	לא נשלח; נדרש לפעולות המתוארות	מסכת שדות Google נדרשת לעדכון ומופרדת בפסיקים, למשל pose.heading או pose.latLngPair.
updatePhotoRequests / --update-photo-requests	מערך אובייקטים; 1–100 פריטים	לא	לא נשלח; נדרש לפעולות המתוארות	1–100 אובייקטי UpdatePhotoRequest מקוריים עבור batch_update; בכל אחד נדרשים photo.photoId.id ו-updateMask.
uploadUrl / --upload-url	מחרוזת; לפחות 1 תווים	לא	לא נשלח; נדרש לפעולות המתוארות	כתובת UploadRef המדויקת מ-start_upload/start_sequence_upload ב-HTTPS ב-streetviewpublish.googleapis.com ובנתיב /media/user/{account}/photo/{reference} או photoSequence; ללא הפניות, מקור אחר, פרטי משתמש, מקטע או נתיב מקודד.
view / --view	מחרוזת; ערכים: BASIC, INCLUDE_DOWNLOAD_URL	לא	BASIC	BASIC או INCLUDE_DOWNLOAD_URL עבור list/get/batch_get/get_sequence. קישורי ההורדה רגישים והכלי אינו מוריד אותם.

התנהגות ומגבלות

• זרימת תמונה: start_upload ואז upload ממשי של בתים ואז create עם photo.uploadReference.uploadUrl ומטא-נתונים נדרשים. העלאת בתים לבדה אינה מפרסמת. נדרשות תמונות 360, מטא-נתוני Photo Sphere/XMP ועמידה בתנאי Google. עדכון משתמש ב-PUT וב-updateMask; Google אינה תומכת בשינוי פיקסלים. מחיקה מסירה תמונות שפורסמו. בדיקות doctor או live אינן כותבות.
• זרימת רצף: start_sequence_upload ואז upload, ‏create_sequence עם inputType ו-photoSequence, ואז get_sequence. מגבלת 8 MiB שייכת למימוש; וידאו גדול דורש העלאה חיצונית נתמכת Google, וניתן להשתמש ב-UploadRef שלה. אין העלאה בחלקים או ניתנת לחידוש.
• גופים מקוריים שומרים GPS, תנוחה, IMU, חיבורים ומקומות; Google מאמתת פרטים פנימיים. המעטפת דוחה פרמטרים לא מוכרים ובודקת שדות בסיס; כל עדכון אצווה דורש photo.photoId.id ו-updateMask. מימוש כל שיטות REST אינו אומר שכל שדה פנימי נבדק בשירות חי.
• העלאה ממקור קבוע, מוגבלת וב-POST ללא ניסיונות חוזרים; כל שינוי מבטל ניסיונות חוזרים כדי למנוע פרסום כפול בכשל עמום. יש לבדוק תוצאות. חלים בעלות, פרטיות, זכויות, קריטריוני 360, עיבוד ומכסות. חשבון שירות אינו מחליף הסכמת משתמש. פרסום לא נבדק חי עם מפתח חשבון השירות שסופק; נדרש משתמש מסכים וכתיבות ציבוריות מוחרגות מהבדיקות.
• מקורות רשמיים ומגבלות: https://developers.google.com/streetview/publish/authorizing ; https://developers.google.com/streetview/publish/first-app ; https://developers.google.com/streetview/publish/reference/rest ; https://developers.google.com/streetview/publish/reference/rest/v1/photo ; https://developers.google.com/streetview/publish/reference/rest/v1/photoSequence/create ; https://developers.google.com/streetview/publish/reference/rest/v1/photos/batchUpdate ; https://www.googleapis.com/auth/streetviewpublish

מקורות ראשוניים: https://developers.google.com/streetview/publish/authorizing, https://developers.google.com/streetview/publish/first-app, https://developers.google.com/streetview/publish/reference/rest, https://developers.google.com/streetview/publish/reference/rest/v1/photo, https://developers.google.com/streetview/publish/reference/rest/v1/photoSequence/create, https://developers.google.com/streetview/publish/reference/rest/v1/photos/batchUpdate

תוצאה

Photo, רשימות, UploadRef, תוצאות אצווה או Operation מקוריים. תשובה ריקה להעלאה או מחיקה הופכת ל-{}. מצבי פרסום ובעלות נשמרים. רצף עשוי להישאר בעיבוד; בודקים ב-get_sequence. אין תשאול או פרסום אוטומטי.

דוגמה

ארגומנטי MCP:

{
  "operation": "list",
  "pageSize": 10,
  "view": "BASIC"
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_streetview_publish --args '{"operation":"list","pageSize":10,"view":"BASIC"}'

maps_datasets

ניהול מערכי נתונים למפות.

ניהול מערכי נתונים גאוגרפיים לעיצוב Google Maps מבוסס נתונים, לרבות ייבוא אסינכרוני מאובייקט Cloud Storage קיים.

פקודת CLI: datasets. גישה ל-Google: OAuth2 בלבד בחשבון שירות או ADC ובהיקף https://www.googleapis.com/auth/cloud-platform; מפתחות API אינם מתקבלים. מגדירים בנפרד פרויקט משאב והרשאות פרויקט מכסה.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
dataset / --dataset	אובייקט	לא	נדרש עבור create/update	אובייקט Dataset מקורי עבור create/update. יצירה דורשת displayName ייחודי ו-usage:["USAGE_DATA_DRIVEN_STYLING"]. בעדכון מוזרק שם משאב תואם.
gcsSource / --gcs-source	אובייקט	לא	נדרש לייבוא	מקור Cloud Storage קיים לייבוא; נדרשת הרשאת גישה. קבצים מקומיים אינם נקראים.
gcsSource.fileFormat	מחרוזת; ערכים: FILE_FORMAT_GEOJSON, FILE_FORMAT_KML, FILE_FORMAT_CSV	כשהאובייקט ההורה מסופק	נדרש כאשר gcsSource נשלח	קידוד המקור FILE_FORMAT_GEOJSON, FILE_FORMAT_KML או FILE_FORMAT_CSV.
gcsSource.inputUri	מחרוזת; לפחות 1 תווים	כשהאובייקט ההורה מסופק	נדרש כאשר gcsSource נשלח	כתובת gs://bucket/object קיימת; נדרשת storage.objects.get, למשל דרך Storage Object Viewer.
name / --name	מחרוזת; תבנית: ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*/datasets/[A-Za-z0-9_-]+(@active)?$	לא	נדרש לפעולות משאב	projects/{project}/datasets/{dataset}; נדרש למעט list/create. רק get מקבל @active לגרסה האחרונה שהושלמה.
operation / --operation	מחרוזת; ערכים: list, get, create, update, delete, import, download, fetch_errors	כן	נדרש	בחירה ב-list/get/create/update/delete/import/download/fetch_errors; הפעולות create/update/delete/import משנות משאבי ענן.
pageSize / --page-size	מספר שלם; 1–500	לא	list: 100; fetch_errors: ברירת המחדל 50	מספר מרבי של מערכי נתונים או שגיאות בעמוד; המעטפת מקבלת 1–500.
pageToken / --page-token	מחרוזת; לפחות 1 תווים	לא	העמוד הראשון	אסימון העמוד הבא מהתשובה הקודמת; יתר הפרמטרים נשארים ללא שינוי. אין דפדוף אוטומטי.
parent / --parent	מחרוזת; תבנית: ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*$	לא	נדרש עבור list/create	projects/{project}; נדרש עבור list/create.
tag / --tag	מחרוזת; ערכים: active	לא	הגרסה האחרונה ללא תלות במצב העיבוד	עבור list: ‏active בוחר בגרסה האחרונה שהושלמה ומדלג על מערכים ללא גרסה שהושלמה.
updateMask / --update-mask	מחרוזת; לפחות 1 תווים	לא	ברירת המחדל של Google היא * (החלפת כל המטא-נתונים)	שדות מטא-נתונים מופרדים בפסיקים, למשל description,displayName; השמטה מחליפה את כל המטא-נתונים.
versionDescription / --version-description	מחרוזת; לפחות 1 תווים	לא	מושמט	תיאור גרסת הנתונים החדשה; לייבוא בלבד.

התנהגות ומגבלות

• נדרשות הרשאות mapsplatformdatasets.datasets.list/get/create/update/delete/import/export לפי הפעולה. ייבוא GCS יוצר גרסה אסינכרונית; בודקים מצב ב-get ושגיאות ב-fetch_errors. אין תשאול אוטומטי.
• ממשק v1 הציבורי אינו מתעד listVersions; משתמשים ב-get לגרסה אחרונה, @active למושלמת וב-versionId, ללא הבטחת היסטוריה מלאה. הורדה דורשת export ו-CLI --output כותב את הבתים.
• Maps Datasets API אינה גובה דמי שימוש, אך נדרש פרויקט מוגדר ול-Google Maps ול-Cloud Storage עשויים להיות חיובים ותנאים משלהם. השימוש הנתמך הוא עיצוב מבוסס נתונים; אין העלאה מקומית מרובת חלקים, משתמשים באובייקט GCS קיים.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/datasets/create ; https://developers.google.com/maps/documentation/datasets/overview ; https://developers.google.com/maps/documentation/datasets/reference/rest/v1/media/download ; https://developers.google.com/maps/documentation/datasets/reference/rest/v1/projects.datasets ; https://www.googleapis.com/auth/cloud-platform

מקורות ראשוניים: https://developers.google.com/maps/documentation/datasets/create, https://developers.google.com/maps/documentation/datasets/overview, https://developers.google.com/maps/documentation/datasets/reference/rest/v1/media/download, https://developers.google.com/maps/documentation/datasets/reference/rest/v1/projects.datasets

תוצאה

JSON מקורי של Dataset, רשימה או שגיאות, שם גרסת ייבוא, או בתי מקור עם MIME וכותרות מטמון. get שומר status.state, status.errorMessage ו-versionId; תחילת ייבוא אינה השלמת עיבוד.

דוגמה

ארגומנטי MCP:

{
  "operation": "list",
  "parent": "projects/my-project",
  "pageSize": 20
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_datasets --args '{"operation":"list","parent":"projects/my-project","pageSize":20}'

maps_route_optimization

מיטוב מסלולים לצי שלם.

מיטוב ציי משלוחים ושירות ב-Route Optimization API עם ShipmentModel מקורי מלא, לרבות קיבולות, חלונות זמן ועלויות.

פקודת CLI: route-optimization. גישה ל-Google: OAuth2 בלבד בחשבון שירות או ADC ובהיקף https://www.googleapis.com/auth/cloud-platform; מפתחות API אינם מתקבלים. מגדירים בנפרד פרויקט משאב והרשאות פרויקט מכסה.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
name / --name	מחרוזת; תבנית: ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*(/locations/[A-Za-z0-9_-]+)?/operations/[A-Za-z0-9_-]+$	לא	נדרש עבור get_operation	השם המדויק projects/{project}[/locations/{location}]/operations/{ID} מ-Google; עבור get_operation בלבד.
operation / --operation	מחרוזת; ערכים: optimize, validate, batch, optimize_long_running, optimize_uri, get_operation	כן	נדרש	optimize לפתרון סינכרוני; validate שולח VALIDATE_ONLY; ‏batch למשימת GCS; ‏optimize_long_running ו-optimize_uri ניסיוניים; get_operation למצב.
parent / --parent	מחרוזת; תבנית: ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*(/locations/[A-Za-z0-9_-]+)?$	לא	נדרש למעט get_operation	projects/{project}, עם /locations/- אופציונלי. פתרון סינכרוני וארוך דוחים מיקום אזורי; batch/URI מקבלים את הפורמט המקורי.
request / --request	אובייקט	לא	נדרש למעט get_operation	בקשת Google מלאה ללא parent. פתרון ואימות דורשים model עם משלוחים, כלי רכב ואילוצים. batch: ‏1–100 modelConfigs עם מקור ויעד GCS ו-JSON/PROTO_TEXT. ‏URI: ‏input.uri/output.uri ב-gs:// עם סיומת .json או .txtpb.

התנהגות ומגבלות

• validate קורא ל-Google עם VALIDATE_ONLY ואינו פותר את מודל הצי. יש להפעיל את השירות; roles/routeoptimization.viewer מאפשר פתרון וקריאת פעולות, editor מוסיף משימות אצווה. ההרשאות כוללות locations.use ו-operations.create/get.
• משימות batch קוראות וכותבות GCS עם הרשאות מפורשות ועשויות להמשיך לאחר סיום הבקשה. אין העלאת קבצים או תשאול אוטומטי. גרסאות long-running ו-URI ניסיוניות ועשויות להשתנות; נקודת URI רגישה לאותיות :OptimizeToursUri. Google אינה תומכת כעת בביטול, מחיקה או רשימת פעולות; רק get_operation זמין.
• החיוב תלוי במשלוחים וב-SKU ‏Single Vehicle Routing או Fleet Routing. זהו שירות נפרד ממיטוב נקודות ב-Routes API; פקיעת זמן תעבורה אינה מבטלת משימה.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/route-optimization/cloud-setup ; https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/operations ; https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/batchOptimizeTours ; https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/optimizeTours ; https://developers.google.com/maps/documentation/route-optimization/usage-and-billing ; https://github.com/googleapis/googleapis/blob/master/google/maps/routeoptimization/v1/route_optimization_service.proto ; https://www.googleapis.com/auth/cloud-platform

מקורות ראשוניים: https://developers.google.com/maps/documentation/route-optimization/cloud-setup, https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/operations, https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/batchOptimizeTours, https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/optimizeTours, https://developers.google.com/maps/documentation/route-optimization/usage-and-billing, https://github.com/googleapis/googleapis/blob/master/google/maps/routeoptimization/v1/route_optimization_service.proto

תוצאה

OptimizeToursResponse או Operation מקוריים; בדיקת מצב שומרת done:false, מטא-נתונים ו-response/error בסיום, ללא הסתרת כישלון.

דוגמה

ארגומנטי MCP:

{
  "operation": "validate",
  "parent": "projects/my-project",
  "request": {
    "model": {
      "shipments": [],
      "vehicles": [
        {
          "startLocation": {
            "latitude": 48.85,
            "longitude": 2.35
          }
        }
      ]
    },
    "maxValidationErrors": 10
  }
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_route_optimization --args '{"operation":"validate","parent":"projects/my-project","request":{"model":{"shipments":[],"vehicles":[{"startLocation":{"latitude":48.85,"longitude":2.35}}]},"maxValidationErrors":10}}'

maps_air_quality_forecast

תחזית איכות אוויר לפי שעה.

קבלת תחזית איכות אוויר לזמן או טווח מפורשים, עד 96 שעות קדימה.

פקודת CLI: air-quality-forecast. גישה ל-Google: מפתח API או אסימון OAuth2 בהיקף cloud-platform; יש להפעיל API וחיוב. למשתמש האימות בפרויקט המכסה נדרשת serviceusage.services.use.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
customLocalAqis / --custom-local-aqis	מערך אובייקטים; 1–250 פריטים	לא	Google בוחרת מדדים מקומיים	דריסת המדד המקומי למדינות או אזורים מסוימים.
customLocalAqis[].aqi	מחרוזת; לפחות 1 תווים	כשהאובייקט ההורה מסופק	נדרש לכל דריסה	קוד מדד מקומי נתמך, למשל us_epa; Google מאמתת את השילוב.
customLocalAqis[].regionCode	מחרוזת; תבנית: ^[A-Za-z]{2}$	כשהאובייקט ההורה מסופק	נדרש לכל דריסה	קוד מדינה או אזור בן שתי אותיות עבור הדריסה.
dateTime / --date-time	מחרוזת; לפחות 20 תווים	לא	יש לבחור בורר זמן	זמן UTC יחיד ב-RFC3339 המסתיים ב-Z; Google מעגלת לשעה הקודמת. אינו משתלב עם period או hours.
extraComputations / --extra-computations	מערך מחרוזות; 1–5 פריטים; ערכים: LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION	לא	ללא חישובים נוספים	חישובים נוספים: LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION ו-POLLUTANT_CONCENTRATION.
languageCode / --language-code	מחרוזת; לפחות 1 תווים	לא	Google: en	תג שפה IETF BCP-47 לטקסט הזמין; Google עשויה לבחור בשפה הנתמכת הקרובה.
location / --location	אובייקט	כן	נדרש	קואורדינטות המקום המבוקש; השדות הפנימיים נדרשים.
location.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש כאשר המיקום נשלח	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
location.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש כאשר המיקום נשלח	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
pageSize / --page-size	מספר שלם; 1–96	לא	Google: תחזית 24; היסטוריה 72	מספר רשומות שעה: עד 96 לתחזית ועד 168 להיסטוריה.
pageToken / --page-token	מחרוזת; לפחות 1 תווים	לא	העמוד הראשון	אסימון העמוד הבא מהתשובה הקודמת; יתר הפרמטרים נשארים ללא שינוי. אין דפדוף אוטומטי.
period / --period	אובייקט	לא	יש לבחור בורר זמן	טווח שעות כולל ומסודר: עד 96 שעות תחזית או 720 שעות היסטוריה. אינו משתלב עם dateTime או hours.
period.endTime	מחרוזת; לפחות 20 תווים	כשהאובייקט ההורה מסופק	נדרש כאשר התקופה נשלח	סיום הטווח הכולל ב-RFC3339 UTC המסתיים ב-Z.
period.startTime	מחרוזת; לפחות 20 תווים	כשהאובייקט ההורה מסופק	נדרש כאשר התקופה נשלח	תחילת הטווח ב-RFC3339 UTC המסתיימת ב-Z.
uaqiColorPalette / --uaqi-color-palette	מחרוזת; ערכים: RED_GREEN, INDIGO_PERSIAN_DARK, INDIGO_PERSIAN_LIGHT	לא	לוח הצבעים של Google	לוח UAQI: ‏RED_GREEN, ‏INDIGO_PERSIAN_DARK או INDIGO_PERSIAN_LIGHT. לוחות המדדים המקומיים קבועים.
universalAqi / --universal-aqi	בוליאני	לא	Google: true	כלילת מדד איכות האוויר האוניברסלי.

התנהגות ומגבלות

• יש לבחור בדיוק בורר זמן אחד; התחביר, סדר הטווח ואורכו נבדקים מקומית, ו-Google מאמתת זמינות וכיסוי. מוחזר עמוד יחיד; ממשיכים במפורש עם nextPageToken. המדדים, הריכוזים וההמלצות נשמרים. חלות מדיניות Air Quality ודרישות ייחוס, תצוגה ומטמון; הכיסוי משתנה לפי מדינה.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/air-quality/policies ; https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/forecast/lookup

מקורות ראשוניים: https://developers.google.com/maps/documentation/air-quality/policies, https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/forecast/lookup

תוצאה

hourlyForecasts, regionCode ו-nextPageToken מקוריים, עם מידע מזהמים ובריאות אופציונלי.

דוגמה

ארגומנטי MCP:

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "dateTime": "2026-11-01T12:00:00Z",
  "pageSize": 24
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_air_quality_forecast --args '{"location":{"latitude":48.85,"longitude":2.35},"dateTime":"2026-11-01T12:00:00Z","pageSize":24}'

maps_air_quality_history

היסטוריית איכות אוויר עד 30 יום.

קבלת נתוני איכות אוויר היסטוריים מ-30 הימים הקודמים.

פקודת CLI: air-quality-history. גישה ל-Google: מפתח API או אסימון OAuth2 בהיקף cloud-platform; יש להפעיל API וחיוב. למשתמש האימות בפרויקט המכסה נדרשת serviceusage.services.use.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
customLocalAqis / --custom-local-aqis	מערך אובייקטים; 1–250 פריטים	לא	Google בוחרת מדדים מקומיים	דריסת המדד המקומי למדינות או אזורים מסוימים.
customLocalAqis[].aqi	מחרוזת; לפחות 1 תווים	כשהאובייקט ההורה מסופק	נדרש לכל דריסה	קוד מדד מקומי נתמך, למשל us_epa; Google מאמתת את השילוב.
customLocalAqis[].regionCode	מחרוזת; תבנית: ^[A-Za-z]{2}$	כשהאובייקט ההורה מסופק	נדרש לכל דריסה	קוד מדינה או אזור בן שתי אותיות עבור הדריסה.
dateTime / --date-time	מחרוזת; לפחות 20 תווים	לא	יש לבחור בורר זמן	זמן UTC יחיד ב-RFC3339 המסתיים ב-Z; Google מעגלת לשעה הקודמת. אינו משתלב עם period או hours.
extraComputations / --extra-computations	מערך מחרוזות; 1–5 פריטים; ערכים: LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION	לא	ללא חישובים נוספים	חישובים נוספים: LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION ו-POLLUTANT_CONCENTRATION.
hours / --hours	מספר שלם; 1–720	לא	יש לבחור בדיוק אחד: hours/dateTime/period	מספר השעות הקודמות, 1–720 (30 יום); אינו משתלב עם dateTime או period.
languageCode / --language-code	מחרוזת; לפחות 1 תווים	לא	Google: en	תג שפה IETF BCP-47 לטקסט הזמין; Google עשויה לבחור בשפה הנתמכת הקרובה.
location / --location	אובייקט	כן	נדרש	קואורדינטות המקום המבוקש; השדות הפנימיים נדרשים.
location.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש כאשר המיקום נשלח	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
location.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש כאשר המיקום נשלח	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
pageSize / --page-size	מספר שלם; 1–168	לא	Google: תחזית 24; היסטוריה 72	מספר רשומות שעה: עד 96 לתחזית ועד 168 להיסטוריה.
pageToken / --page-token	מחרוזת; לפחות 1 תווים	לא	העמוד הראשון	אסימון העמוד הבא מהתשובה הקודמת; יתר הפרמטרים נשארים ללא שינוי. אין דפדוף אוטומטי.
period / --period	אובייקט	לא	יש לבחור בורר זמן	טווח שעות כולל ומסודר: עד 96 שעות תחזית או 720 שעות היסטוריה. אינו משתלב עם dateTime או hours.
period.endTime	מחרוזת; לפחות 20 תווים	כשהאובייקט ההורה מסופק	נדרש כאשר התקופה נשלח	סיום הטווח הכולל ב-RFC3339 UTC המסתיים ב-Z.
period.startTime	מחרוזת; לפחות 20 תווים	כשהאובייקט ההורה מסופק	נדרש כאשר התקופה נשלח	תחילת הטווח ב-RFC3339 UTC המסתיימת ב-Z.
uaqiColorPalette / --uaqi-color-palette	מחרוזת; ערכים: RED_GREEN, INDIGO_PERSIAN_DARK, INDIGO_PERSIAN_LIGHT	לא	לוח הצבעים של Google	לוח UAQI: ‏RED_GREEN, ‏INDIGO_PERSIAN_DARK או INDIGO_PERSIAN_LIGHT. לוחות המדדים המקומיים קבועים.
universalAqi / --universal-aqi	בוליאני	לא	Google: true	כלילת מדד איכות האוויר האוניברסלי.

התנהגות ומגבלות

• יש לבחור בדיוק בורר זמן אחד; התחביר, סדר הטווח ואורכו נבדקים מקומית, ו-Google מאמתת זמינות וכיסוי. מוחזר עמוד יחיד; ממשיכים במפורש עם nextPageToken. המדדים, הריכוזים וההמלצות נשמרים. חלות מדיניות Air Quality ודרישות ייחוס, תצוגה ומטמון; הכיסוי משתנה לפי מדינה.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/air-quality/policies ; https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/history/lookup

מקורות ראשוניים: https://developers.google.com/maps/documentation/air-quality/policies, https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/history/lookup

תוצאה

hoursInfo, regionCode ו-nextPageToken מקוריים, עם מידע מזהמים ובריאות אופציונלי.

דוגמה

ארגומנטי MCP:

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "hours": 24,
  "pageSize": 12
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_air_quality_history --args '{"location":{"latitude":48.85,"longitude":2.35},"hours":24,"pageSize":12}'

maps_air_quality_heatmap

אריחי מפת איכות אוויר.

הורדת אריח מפת חום אמיתי למדד איכות אוויר או מזהם.

פקודת CLI: air-quality-heatmap. גישה ל-Google: מפתח API או אסימון OAuth2 בהיקף cloud-platform; יש להפעיל API וחיוב. למשתמש האימות בפרויקט המכסה נדרשת serviceusage.services.use.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
mapType / --map-type	מחרוזת; ערכים: UAQI_RED_GREEN, UAQI_INDIGO_PERSIAN, PM25_INDIGO_PERSIAN, GBR_DEFRA, DEU_UBA, CAN_EC, FRA_ATMO, US_AQI	כן	נדרש	סוג המדד: UAQI_RED_GREEN, UAQI_INDIGO_PERSIAN, PM25_INDIGO_PERSIAN, GBR_DEFRA, DEU_UBA, CAN_EC, FRA_ATMO או US_AQI.
x / --x	מספר שלם; 0–65535	כן	נדרש	עמודת האריח בין 0 ל-‎2^zoom−1; הגבולות נבדקים לפני הפנייה.
y / --y	מספר שלם; 0–65535	כן	נדרש	שורת האריח בין 0 ל-‎2^zoom−1; הגבולות נבדקים לפני הפנייה.
zoom / --zoom	מספר שלם; 0–16	כן	נדרש	רמת זום Web Mercator בין 0 ל-16; ברמה אפס אריח אחד.

התנהגות ומגבלות

• הזמינות תלויה במדד ובכיסוי המדינה. מדיניות Air Quality דורשת ייחוס ומגבילה אחסון ותצוגה; יש לשמר כותרות מטמון. המעטפת אינה מעניקה רישיון תוכן.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/air-quality/policies ; https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

מקורות ראשוניים: https://developers.google.com/maps/documentation/air-quality/policies, https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

תוצאה

בתי אריח אמיתי עם MIME וכותרות מטמון מקוריות; MCP מציג תמונה ו-CLI --output יכול לשמור את הבתים.

דוגמה

ארגומנטי MCP:

{
  "mapType": "UAQI_RED_GREEN",
  "zoom": 2,
  "x": 2,
  "y": 1
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_air_quality_heatmap --args '{"mapType":"UAQI_RED_GREEN","zoom":2,"x":2,"y":1}'

maps_pollen_heatmap

אריחי מפות אבקה.

הורדת אריח PNG אמיתי למדד אבקת עצים, דשא או עשבים.

פקודת CLI: pollen-heatmap. גישה ל-Google: נדרש מפתח API במימוש זה, גם במצב OAuth; יש להפעיל שירות, חיוב והגבלות מתאימות.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
mapType / --map-type	מחרוזת; ערכים: TREE_UPI, GRASS_UPI, WEED_UPI	כן	נדרש	מדד אבקה TREE_UPI, GRASS_UPI או WEED_UPI.
x / --x	מספר שלם; 0–65535	כן	נדרש	עמודת האריח בין 0 ל-‎2^zoom−1; הגבולות נבדקים לפני הפנייה.
y / --y	מספר שלם; 0–65535	כן	נדרש	שורת האריח בין 0 ל-‎2^zoom−1; הגבולות נבדקים לפני הפנייה.
zoom / --zoom	מספר שלם; 0–16	כן	נדרש	רמת זום Web Mercator בין 0 ל-16; ברמה אפס אריח אחד.

התנהגות ומגבלות

• הזמינות משתנה לפי המדינות הנתמכות והעונה. מדיניות Pollen קובעת ייחוס, הצגה ב-Google Maps ומטמון; הפעלת API אינה מסירה מגבלות רישיון.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/pollen/policies ; https://developers.google.com/maps/documentation/pollen/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

מקורות ראשוניים: https://developers.google.com/maps/documentation/pollen/policies, https://developers.google.com/maps/documentation/pollen/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

תוצאה

בתי אריח אמיתי עם MIME וכותרות מטמון מקוריות; MCP מציג תמונה ו-CLI --output יכול לשמור את הבתים.

דוגמה

ארגומנטי MCP:

{
  "mapType": "TREE_UPI",
  "zoom": 2,
  "x": 2,
  "y": 1
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_pollen_heatmap --args '{"mapType":"TREE_UPI","zoom":2,"x":2,"y":1}'

maps_weather_history

היסטוריית מזג אוויר שעתית ליום האחרון.

קבלת עד 24 שעות מזג אוויר קודמות עם דפדוף מפורש.

פקודת CLI: weather-history. גישה ל-Google: מפתח API או אסימון OAuth2 בהיקף cloud-platform; יש להפעיל API וחיוב. למשתמש האימות בפרויקט המכסה נדרשת serviceusage.services.use.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
hours / --hours	מספר שלם; 1–24	לא	Google: 24	מספר שעות קודמות החל מהשעה האחרונה, בין 1 ל-24.
languageCode / --language-code	מחרוזת; לפחות 1 תווים	לא	Google: en	תג שפה IETF BCP-47 לטקסט הזמין; Google עשויה לבחור בשפה הנתמכת הקרובה.
location / --location	אובייקט	כן	נדרש	קואורדינטות המקום המבוקש; השדות הפנימיים נדרשים.
location.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש כאשר המיקום נשלח	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
location.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש כאשר המיקום נשלח	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
pageSize / --page-size	מספר שלם; 1–24	לא	היסטוריה: Google 24; אחרים: ברירת המחדל של Google	מספר רשומות מרבי בעמוד: 1–24 להיסטוריה, 1–1000 להתראות ולתחזית דקות.
pageToken / --page-token	מחרוזת; לפחות 1 תווים	לא	העמוד הראשון	אסימון העמוד הבא מהתשובה הקודמת; יתר הפרמטרים נשארים ללא שינוי. אין דפדוף אוטומטי.
unitsSystem / --units-system	מחרוזת; ערכים: METRIC, IMPERIAL	לא	Google: METRIC	מערכת יחידות METRIC או IMPERIAL.

התנהגות ומגבלות

• הנתיב מכסה רק את 24 השעות הקודמות, לא תאריכים היסטוריים שרירותיים. חלות מדיניות Weather ומגבלות כיסוי; אין הבאת עמודים אוטומטית.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/weather/policies ; https://developers.google.com/maps/documentation/weather/reference/rest/v1/history.hours/lookup

מקורות ראשוניים: https://developers.google.com/maps/documentation/weather/policies, https://developers.google.com/maps/documentation/weather/reference/rest/v1/history.hours/lookup

תוצאה

historyHours, timeZone ו-nextPageToken מקוריים וכל התנאים השעתיים.

דוגמה

ארגומנטי MCP:

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "hours": 12,
  "pageSize": 6
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_weather_history --args '{"location":{"latitude":48.85,"longitude":2.35},"hours":12,"pageSize":6}'

maps_weather_alerts

התראות מזג אוויר ציבוריות מקומיות.

קבלת התראות מזג אוויר החלות על מקום, עם חומרה ופרטי הרשות המפרסמת המקוריים.

פקודת CLI: weather-alerts. גישה ל-Google: מפתח API או אסימון OAuth2 בהיקף cloud-platform; יש להפעיל API וחיוב. למשתמש האימות בפרויקט המכסה נדרשת serviceusage.services.use.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
languageCode / --language-code	מחרוזת; לפחות 1 תווים	לא	Google: en	תג שפה IETF BCP-47 לטקסט הזמין; Google עשויה לבחור בשפה הנתמכת הקרובה.
location / --location	אובייקט	כן	נדרש	קואורדינטות המקום המבוקש; השדות הפנימיים נדרשים.
location.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש כאשר המיקום נשלח	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
location.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש כאשר המיקום נשלח	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
pageSize / --page-size	מספר שלם; 1–1000	לא	היסטוריה: Google 24; אחרים: ברירת המחדל של Google	מספר רשומות מרבי בעמוד: 1–24 להיסטוריה, 1–1000 להתראות ולתחזית דקות.
pageToken / --page-token	מחרוזת; לפחות 1 תווים	לא	העמוד הראשון	אסימון העמוד הבא מהתשובה הקודמת; יתר הפרמטרים נשארים ללא שינוי. אין דפדוף אוטומטי.

התנהגות ומגבלות

• הכיסוי, ההשהיה והשדות תלויים ברשות המפרסמת. יש לשמר את ייחוס הספק ולפעול לפי מדיניות Weather; היעדר התראה בתשובה אינו ערובה לבטיחות.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/weather/policies ; https://developers.google.com/maps/documentation/weather/reference/rest/v1/publicAlerts/lookup

מקורות ראשוניים: https://developers.google.com/maps/documentation/weather/policies, https://developers.google.com/maps/documentation/weather/reference/rest/v1/publicAlerts/lookup

תוצאה

אוסף weatherAlerts מקורי, פרטי רשות ואזור ו-nextPageToken כאשר זמין.

דוגמה

ארגומנטי MCP:

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "pageSize": 5
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_weather_alerts --args '{"location":{"latitude":48.85,"longitude":2.35},"pageSize":5}'

maps_weather_minute_forecast

תחזית משקעים לדקות, ניסיונית.

ניסיוני: תחזיות משקעים ברזולוציה גבוהה בטווח שש שעות.

פקודת CLI: weather-minute-forecast. גישה ל-Google: מפתח API או אסימון OAuth2 בהיקף cloud-platform; יש להפעיל API וחיוב. למשתמש האימות בפרויקט המכסה נדרשת serviceusage.services.use.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
location / --location	אובייקט	כן	נדרש	קואורדינטות המקום המבוקש; השדות הפנימיים נדרשים.
location.latitude	מספר; -90.0–90.0	כשהאובייקט ההורה מסופק	נדרש כאשר המיקום נשלח	קו רוחב WGS84 במעלות, בין ‎-90 ל-90.
location.longitude	מספר; -180.0–180.0	כשהאובייקט ההורה מסופק	נדרש כאשר המיקום נשלח	קו אורך WGS84 במעלות, בין ‎-180 ל-180.
pageSize / --page-size	מספר שלם; 1–1000	לא	היסטוריה: Google 24; אחרים: ברירת המחדל של Google	מספר רשומות מרבי בעמוד: 1–24 להיסטוריה, 1–1000 להתראות ולתחזית דקות.
pageToken / --page-token	מחרוזת; לפחות 1 תווים	לא	העמוד הראשון	אסימון העמוד הבא מהתשובה הקודמת; יתר הפרמטרים נשארים ללא שינוי. אין דפדוף אוטומטי.
unitsSystem / --units-system	מחרוזת; ערכים: METRIC, IMPERIAL	לא	Google: METRIC	מערכת יחידות METRIC או IMPERIAL.

התנהגות ומגבלות

• ניסיוני טרום זמינות כללית: תמיכה מוגבלת ושינויים לא תואמים אפשריים. נדרש ייחוס; מטמון תחזית דקות ואריחי מזג אוויר מוגבל לשעה אחת ולאחריה יש למחוק. Google אוסרת שימוש בתוכן לשחזור שירות או מוצר שלה, לרבות יישום או מודל שמטרתו הראשית מידע מזג אוויר. ההגבלות חלות גם על צרכנים בהמשך.
• תחזית הדקות והאריחים עשויים לא להיות מסונכרנים. עמוד יחיד בכל קריאה; הזמינות תלויה במיקום ובגישה לשירות.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/weather/minute-forecast ; https://developers.google.com/maps/documentation/weather/weather-map

מקורות ראשוניים: https://developers.google.com/maps/documentation/weather/minute-forecast, https://developers.google.com/maps/documentation/weather/weather-map

תוצאה

overallPredictionTimeframe, timeZone, segments ו-nextPageToken; המקטעים שומרים סוג, הסתברות, כמויות ועוצמה.

דוגמה

ארגומנטי MCP:

{
  "location": {
    "latitude": 37.60451,
    "longitude": -80.59044
  },
  "pageSize": 5
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_weather_minute_forecast --args '{"location":{"latitude":37.60451,"longitude":-80.59044},"pageSize":5}'

maps_weather_map

מפת משקעים מיידיים, ניסיונית.

ניסיוני: הורדת אריח משקעים מיידיים לארצות הברית או אירופה.

פקודת CLI: weather-map. גישה ל-Google: מפתח API או אסימון OAuth2 בהיקף cloud-platform; יש להפעיל API וחיוב. למשתמש האימות בפרויקט המכסה נדרשת serviceusage.services.use.

פרמטרים

פרמטר / אפשרות CLI	סוג וגבולות הסכמה	נדרש	ערך כשמושמט	תיאור
mapType / --map-type	מחרוזת; ערכים: US_PRECIPITATION_CURRENT, EU_PRECIPITATION_CURRENT	כן	נדרש	US_PRECIPITATION_CURRENT או EU_PRECIPITATION_CURRENT; כיסוי מיידי מוגבל גאוגרפית.
x / --x	מספר שלם; 0–65535	כן	נדרש	עמודת האריח בין 0 ל-‎2^zoom−1; הגבולות נבדקים לפני הפנייה.
y / --y	מספר שלם; 0–65535	כן	נדרש	שורת האריח בין 0 ל-‎2^zoom−1; הגבולות נבדקים לפני הפנייה.
zoom / --zoom	מספר שלם; 0–16	כן	נדרש	רמת זום Web Mercator בין 0 ל-16; ברמה אפס אריח אחד.

התנהגות ומגבלות

• ניסיוני טרום זמינות כללית: תמיכה מוגבלת ושינויים לא תואמים אפשריים. נדרש ייחוס; מטמון תחזית דקות ואריחי מזג אוויר מוגבל לשעה אחת ולאחריה יש למחוק. Google אוסרת שימוש בתוכן לשחזור שירות או מוצר שלה, לרבות יישום או מודל שמטרתו הראשית מידע מזג אוויר. ההגבלות חלות גם על צרכנים בהמשך.
• הכיסוי מוגבל לאזורי ארה״ב ואירופה המוצגים במדריך Google. קואורדינטות אריח תקינות אינן מבטיחות נתונים למיקום.
• מקורות רשמיים ומגבלות: https://developers.google.com/maps/documentation/weather/minute-forecast ; https://developers.google.com/maps/documentation/weather/weather-map

מקורות ראשוניים: https://developers.google.com/maps/documentation/weather/minute-forecast, https://developers.google.com/maps/documentation/weather/weather-map

תוצאה

בתי אריח אמיתי עם MIME וכותרות מטמון מקוריות; MCP מציג תמונה ו-CLI --output יכול לשמור את הבתים.

דוגמה

ארגומנטי MCP:

{
  "mapType": "US_PRECIPITATION_CURRENT",
  "zoom": 12,
  "x": 1025,
  "y": 1688
}

קריאת CLI מקבילה:

mcp-gmap-rs call maps_weather_map --args '{"mapType":"US_PRECIPITATION_CURRENT","zoom":12,"x":1025,"y":1688}'