MCP Tools Reference: mapstools.googleapis.com

כלי: lookup_weather

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

נתונים ספציפיים שזמינים: טמפרטורה (נוכחית, טמפרטורה מורגשת, מקסימום/מינימום, אינדקס חום), רוח (מהירות, משבים, כיוון), אירועים שמימיים (זריחה/שקיעה, מופע הירח), משקעים (סוג, סבירות, כמות/QPF), תנאים אטמוספריים (מדד קרינת UV, לחות, כיסוי עננים, סבירות לסופת רעמים) וכתובת מיקום שהומרה לקואורדינטות.

מיקום וכללים שמתייחסים למיקום (קריטי):

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

  1. קואורדינטות גיאוגרפיות (lat_lng)

    • כדאי להשתמש בו כשמקבלים קואורדינטות מדויקות של קו רוחב/אורך.
    • לדוגמה: ‎{"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}}‎ // לוס אנג'לס

  2. מזהה מקום (place_id)

    • מזהה מחרוזת חד-משמעי (מזהה מקום במפות Google).
    • אפשר לאחזר את ה-place_id מהכלי search_places.
    • דוגמה: ‎{"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}}‎ // מגדל אייפל

  3. מחרוזת כתובת (address)

    • מחרוזת בפורמט חופשי שצריכה להיות ספציפית כדי שאפשר יהיה להמיר אותה לקואורדינטות.
    • עיר ואזור: תמיד צריך לכלול את האזור או המדינה (למשל, "לונדון, בריטניה" ולא "לונדון").
    • כתובת: הכתובת המלאה (לדוגמה, "רחוב בן יהודה 1, תל אביב").
    • מיקוד: חובה לצרף שם מדינה (למשל, "90210, ארה"ב", ולא "90210").
    • דוגמה: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

מצבי שימוש:

  • מזג האוויר הנוכחי: צריך לספק רק את location. אל תציינו את date ו-hour.

  • תחזית שעתית: צריך לציין את location, date ו-hour (0-23). אפשר להשתמש בשעות ספציפיות (למשל, "ב-17:00") או במונחים כמו "בשעות הקרובות" או "מאוחר יותר היום". אם המשתמש מציין דקה, מעגלים כלפי מטה לשעה הקרובה. אין תמיכה בתחזית לפי שעה מעבר ל-120 שעות מעכשיו. אפשר לקבל נתונים היסטוריים של מזג אוויר שעתי עד 24 שעות אחורה.

  • תחזית יומית: צריך לספק את location ו-date. אל תציינו את hour. משתמשים בפורמט הזה לבקשות כלליות לגבי ימים (למשל, "מזג האוויר מחר", "מזג האוויר ביום שישי", "מזג האוויר ב-25 בדצמבר"). אם התאריך של היום לא מופיע בהקשר, צריך לבקש מהמשתמש להבהיר אותו. אין תמיכה בתחזית יומית של יותר מ-10 ימים, כולל היום. אין תמיכה בנתוני מזג אוויר היסטוריים.

אילוצי פרמטרים:

  • אזורי זמן: כל הערכים של date ו-hour צריכים להיות ביחס לאזור הזמן המקומי של המיקום, ולא לאזור הזמן של המשתמש.
  • פורמט התאריך: צריך להפריד את הקלט ל-{year, month, day} מספרים שלמים.
  • יחידות: ברירת המחדל היא METRIC. מגדירים את units_system לערך IMPERIAL עבור פרנהייט/מיילים אם המשתמש רומז לתקנים בארה"ב או מבקש זאת במפורש.

  • הפלט המבוסס חייב להיות משויך למקור באמצעות המידע מהשדה attribution, אם הוא זמין.

בדוגמת הקוד הבאה מוסבר איך להשתמש ב-curl כדי להפעיל את כלי ה-MCP‏ lookup_weather.

בקשת Curl 
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "lookup_weather",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

בקשה ל-LookupWeather method – מייצגת את תנאי מזג האוויר במיקום המבוקש.

LookupWeatherRequest

ייצוג ב-JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _hour can be only one of the following:
  "hour": integer
  // End of list of possible types for union field _hour.
}
שדות
unitsSystem

enum (UnitsSystem)

אופציונלי. מערכת היחידות שבה משתמשים לתנאי מזג האוויר שמוחזרים. אם לא תציינו מערכת, תנאי מזג האוויר שיוחזרו יהיו במערכת המטרית (ברירת המחדל = METRIC).
location

object (Location)

חובה. המיקום שרוצים לקבל את תנאי מזג האוויר שלו.

שדה של איחוד _date.

הערך _date יכול להיות רק אחד מהבאים:
date

object (Date)

אופציונלי. התאריך של נתוני מזג האוויר הנדרשים. הערה: התאריך הזה יחסי לאזור הזמן המקומי של המיקום שצוין בשדה המיקום. התאריך צריך להיות בין 24 שעות בעבר ל-10 הימים הבאים.

שדה של איחוד _hour.

הערך _hour יכול להיות רק אחד מהבאים:
hour

integer

אופציונלי. השעה של מידע מזג האוויר המבוקש, בפורמט של 24 שעות (0-23). הערך הזה הוא יחסי לאזור הזמן המקומי של המיקום שצוין בשדה המיקום. אין תמיכה בתחזית לפי שעה מעבר ל-120 שעות מעכשיו. אפשר לקבל נתונים היסטוריים של מזג אוויר שעתי עד 24 שעות אחורה.

תאריך

ייצוג ב-JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
שדות
year

integer

השנה של התאריך. הערך חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך בלי שנה.
month

integer

חודש בשנה. הערך חייב להיות בין 1 ל-12, או 0 כדי לציין שנה בלי חודש ויום.
day

integer

יום בחודש. הערך חייב להיות בין 1 ל-31, ותקף לשנה ולחודש, או 0 כדי לציין שנה בלבד או שנה וחודש שבהם היום לא משמעותי.

מיקום

ייצוג ב-JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
שדות
שדה של איחוד location_type. דרכים שונות לייצג מיקום. הערך location_type יכול להיות רק אחד מהבאים:
latLng

object (LatLng)

נקודה שצוינה באמצעות קואורדינטות גיאוגרפיות.
placeId

string

מזהה המקום שמשויך למיקום .
address

string

כתובת קריאה לאנשים או Plus Code. פרטים נוספים זמינים בכתובת https://plus.codes.

LatLng

ייצוג ב-JSON 
{
  "latitude": number,
  "longitude": number
}
שדות
latitude

number

קו הרוחב במעלות. הוא חייב להיות בטווח [‎-90.0, +90.0].
longitude

number

קו האורך במעלות. הוא חייב להיות בטווח [‎-180.0, +180.0].

UnitsSystem

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

טיפוסים בני מנייה (enum)
UNITS_SYSTEM_UNSPECIFIED מערכת היחידות לא צוינה.
IMPERIAL מערכת היחידות האימפריאלית (למשל פרנהייט, מיילים וכו').
METRIC מערכת היחידות המטרית (למשל, צלזיוס, קילומטרים וכו').

סכימת הפלט

תשובה ל-LookupWeather RPC – מייצגת את תנאי מזג האוויר במיקום המבוקש.

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

LookupWeatherResponse

ייצוג ב-JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "returnedLocation": {
    object (Location)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.
}
שדות
weatherCondition

object (WeatherCondition)

תנאי מזג האוויר
precipitation

object (Precipitation)

הסבירות למשקעים וכמות המשקעים שהצטברה
wind

object (Wind)

תנאי הרוח
returnedLocation

object (Location)

חובה. המיקום שבו מוצג המידע על מזג האוויר. המיקום הזה זהה למיקום בבקשה, אבל יכול להיות שונה ממנו אם המיקום המבוקש הוא כתובת בטקסט חופשי שמתייחסת למיקום כללי (למשל, "Mountain View, CA").
attribution

object (Attribution)

השיוך הנדרש שיוצג עם מזג האוויר.

שדה של איחוד _temperature.

הערך _temperature יכול להיות רק אחד מהבאים:
temperature

object (Temperature)

הטמפרטורה לפי שעה

שדה של איחוד _feels_like_temperature.

הערך _feels_like_temperature יכול להיות רק אחד מהבאים:
feelsLikeTemperature

object (Temperature)

הטמפרטורה המורגשת בכל שעה.

שדה של איחוד _heat_index.

הערך _heat_index יכול להיות רק אחד מהבאים:
heatIndex

object (Temperature)

הטמפרטורה של עומס החום לפי שעה.

שדה של איחוד _air_pressure.

הערך _air_pressure יכול להיות רק אחד מהבאים:
airPressure

object (AirPressure)

תנאי הלחץ האטמוספרי בכל שעה.

שדה של איחוד _max_temperature.

הערך _max_temperature יכול להיות רק אחד מהבאים:
maxTemperature

object (Temperature)

הטמפרטורה המקסימלית (הגבוהה) במהלך היום.

שדה של איחוד _min_temperature.

הערך _min_temperature יכול להיות רק אחד מהבאים:
minTemperature

object (Temperature)

הטמפרטורה המינימלית (הנמוכה) במהלך היום.

שדה של איחוד _feels_like_max_temperature.

הערך _feels_like_max_temperature יכול להיות רק אחד מהבאים:
feelsLikeMaxTemperature

object (Temperature)

הטמפרטורה המורגשת המקסימלית (הגבוהה) במהלך היום.

שדה של איחוד _feels_like_min_temperature.

הערך _feels_like_min_temperature יכול להיות רק אחד מהבאים:
feelsLikeMinTemperature

object (Temperature)

הטמפרטורה המורגשת המינימלית (הנמוכה) במהלך היום.

שדה של איחוד _max_heat_index.

הערך _max_heat_index יכול להיות רק אחד מהבאים:
maxHeatIndex

object (Temperature)

הטמפרטורה המקסימלית של עומס החום במהלך היום.

שדה של איחוד _sun_events.

הערך _sun_events יכול להיות רק אחד מהבאים:
sunEvents

object (SunEvents)

אירועים שקשורים לשמש (למשל, זריחה, שקיעה).

שדה של איחוד _moon_events.

הערך _moon_events יכול להיות רק אחד מהבאים:
moonEvents

object (MoonEvents)

אירועים שקשורים לירח (למשל, זריחת הירח, שקיעת הירח).

שדה של איחוד _relative_humidity.

הערך _relative_humidity יכול להיות רק אחד מהבאים:
relativeHumidity

integer

אחוז הלחות היחסית (ערכים מ-0 עד 100). מוגדר כאופציונלי כי הוא לא תמיד זמין

שדה של איחוד _uv_index.

הערך _uv_index יכול להיות רק אחד מהבאים:
uvIndex

integer

מדד קרינת ה-UV המקסימלי. מוגדר כאופציונלי כי הוא לא תמיד זמין

שדה של איחוד _thunderstorm_probability.

הערך _thunderstorm_probability יכול להיות רק אחד מהבאים:
thunderstormProbability

integer

ההסתברות לסופת רעמים (ערכים מ-0 עד 100). מוגדר כאופציונלי כי הוא לא תמיד זמין

שדה של איחוד _cloud_cover.

הערך _cloud_cover יכול להיות רק אחד מהבאים:
cloudCover

integer

אחוז השמיים שמכוסים בעננים (ערכים מ-0 עד 100). מוגדר כאופציונלי כי הוא לא תמיד זמין

טמפרטורה

ייצוג ב-JSON 
{
  "unit": enum (TemperatureUnit),

  // Union field _degrees can be only one of the following:
  "degrees": number
  // End of list of possible types for union field _degrees.
}
שדות
unit

enum (TemperatureUnit)

הקוד של היחידה שמשמשת למדידת ערך הטמפרטורה.

שדה של איחוד _degrees.

הערך _degrees יכול להיות רק אחד מהבאים:
degrees

number

ערך הטמפרטורה (במעלות) ביחידה שצוינה.

AirPressure

ייצוג ב-JSON 
{

  // Union field _mean_sea_level_millibars can be only one of the following:
  "meanSeaLevelMillibars": number
  // End of list of possible types for union field _mean_sea_level_millibars.
}
שדות

שדה של איחוד _mean_sea_level_millibars.

הערך _mean_sea_level_millibars יכול להיות רק אחד מהבאים:
meanSeaLevelMillibars

number

הלחץ האטמוספרי הממוצע בגובה פני הים במיליבארים.

SunEvents

ייצוג ב-JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
שדות
sunriseTime

string (Timestamp format)

השעה שבה השמש זורחת.

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

השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

השעה שבה השמש שוקעת.

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

השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

חותמת זמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג שניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ‏1970-01-01T00:00:00Z. הערך חייב להיות בין ‎-62135596800 ל-253402300799, כולל (טווח שמתאים ל-‎0001-01-01T00:00:00Z עד ‎9999-12-31T23:59:59Z).
nanos

integer

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

MoonEvents

ייצוג ב-JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
שדות
moonriseTimes[]

string (Timestamp format)

השעה שבה החלק העליון של הירח מופיע מעל האופק (ראו https://en.wikipedia.org/wiki/Moonrise_and_moonset).

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

השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

השעה שבה החלק העליון של הירח נעלם מתחת לאופק (ראו https://en.wikipedia.org/wiki/Moonrise_and_moonset).

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

השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

מופע הירח.

WeatherCondition

ייצוג ב-JSON 
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
שדות
iconBaseUri

string

ה-URI הבסיסי של הסמל, לא כולל הסיומת של סוג הקובץ. כדי להציג את הסמל, מוסיפים ל-URI הזה עיצוב (אם רוצים) ואת סיומת סוג הקובץ (.png או .svg). כברירת מחדל, הסמל הוא בעיצוב בהיר, אבל אפשר להוסיף את _dark למצב כהה. לדוגמה: "https://maps.gstatic.com/weather/v1/dust.svg" או "https://maps.gstatic.com/weather/v1/dust_dark.svg", כאשר icon_base_uri הוא "https://maps.gstatic.com/weather/v1/dust".
description

object (LocalizedText)

התיאור הטקסטואלי של תנאי מזג האוויר האלה (מותאם לשוק המקומי).
type

enum (Type)

סוג תנאי מזג האוויר.

LocalizedText

ייצוג ב-JSON 
{
  "text": string,
  "languageCode": string
}
שדות
text

string

מחרוזת מקומית בשפה שתואמת ל-google.type.LocalizedText.language_code שבהמשך.
languageCode

string

קוד השפה של הטקסט בתקן BCP-47, למשל "en-US" או "sr-Latn".

מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

משקעים

ייצוג ב-JSON 
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
שדות
probability

object (PrecipitationProbability)

הסיכוי למשקעים (ערכים מ-0 עד 100).
snowQpf

object (QuantitativePrecipitationForecast)

כמות השלג, שנמדדת ככמות שוות ערך של מים נוזליים, שהצטברה בתקופת זמן מסוימת. הערה: QPF הוא קיצור של Quantitative Precipitation Forecast (תחזית כמותית של משקעים). פרטים נוספים זמינים בהגדרה של QuantitativePrecipitationForecast.
qpf

object (QuantitativePrecipitationForecast)

כמות המשקעים (גשם) שנמדדת ככמות שוות ערך של מים נוזליים, שהצטברה במהלך תקופה מסוימת. הערה: QPF הוא קיצור של Quantitative Precipitation Forecast (תחזית כמותית של משקעים). פרטים נוספים זמינים בהגדרה של QuantitativePrecipitationForecast.

PrecipitationProbability

ייצוג ב-JSON 
{
  "type": enum (PrecipitationType),

  // Union field _percent can be only one of the following:
  "percent": integer
  // End of list of possible types for union field _percent.
}
שדות
type

enum (PrecipitationType)

קוד שמציין את סוג המשקעים.

שדה של איחוד _percent.

הערך _percent יכול להיות רק אחד מהבאים:
percent

integer

אחוז מ-0 עד 100 שמציין את הסיכוי למשקעים.

QuantitativePrecipitationForecast

ייצוג ב-JSON 
{
  "unit": enum (Unit),

  // Union field _quantity can be only one of the following:
  "quantity": number
  // End of list of possible types for union field _quantity.
}
שדות
unit

enum (Unit)

הקוד של היחידה שמשמשת למדידת כמות המשקעים המצטברת.

שדה של איחוד _quantity.

הערך _quantity יכול להיות רק אחד מהבאים:
quantity

number

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

רוח

ייצוג ב-JSON 
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
שדות
direction

object (WindDirection)

כיוון הרוח, הזווית שממנה היא מגיעה.
speed

object (WindSpeed)

מהירות הרוח.
gust

object (WindSpeed)

משב הרוח (עלייה פתאומית במהירות הרוח).

WindDirection

ייצוג ב-JSON 
{
  "cardinal": enum (CardinalDirection),

  // Union field _degrees can be only one of the following:
  "degrees": integer
  // End of list of possible types for union field _degrees.
}
שדות
cardinal

enum (CardinalDirection)

הקוד שמייצג את הכיוון הראשי שממנו נושבת הרוח.

שדה של איחוד _degrees.

הערך _degrees יכול להיות רק אחד מהבאים:
degrees

integer

כיוון הרוח במעלות (ערכים מ-0 עד 360).

WindSpeed

ייצוג ב-JSON 
{
  "unit": enum (SpeedUnit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
שדות
unit

enum (SpeedUnit)

הקוד שמייצג את היחידה שמשמשת למדידת מהירות הרוח.

שדה של איחוד _value.

הערך _value יכול להיות רק אחד מהבאים:
value

number

הערך של מהירות הרוח.

מיקום

ייצוג ב-JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
שדות
שדה של איחוד location_type. דרכים שונות לייצג מיקום. הערך location_type יכול להיות רק אחד מהבאים:
latLng

object (LatLng)

נקודה שצוינה באמצעות קואורדינטות גיאוגרפיות.
placeId

string

מזהה המקום שמשויך למיקום .
address

string

כתובת קריאה לאנשים או Plus Code. פרטים נוספים זמינים בכתובת https://plus.codes.

LatLng

ייצוג ב-JSON 
{
  "latitude": number,
  "longitude": number
}
שדות
latitude

number

קו הרוחב במעלות. הוא חייב להיות בטווח [‎-90.0, +90.0].
longitude

number

קו האורך במעלות. הוא חייב להיות בטווח [‎-180.0, +180.0].

שיוך (Attribution)

ייצוג ב-JSON 
{
  "title": string,
  "url": string
}
שדות
title

string

הכותרת שתוצג בשיוך (Attribution).
url

string

כתובת ה-URL של הקישור לשיוך.

TemperatureUnit

מייצג יחידה למדידת טמפרטורות.

טיפוסים בני מנייה (enum)
TEMPERATURE_UNIT_UNSPECIFIED לא צוינה יחידת מידה לטמפרטורה.
CELSIUS הטמפרטורה נמדדת במעלות צלזיוס.
FAHRENHEIT הטמפרטורה נמדדת בפרנהייט.

MoonPhase

מציין את מופע הירח.

טיפוסים בני מנייה (enum)
MOON_PHASE_UNSPECIFIED לא צוין מופע ירח.
NEW_MOON הירח לא מואר על ידי השמש.
WAXING_CRESCENT הירח מואר ב-0%-50% בצד ימין שלו בחצי הכדור הצפוני 🌒 ובצד שמאל שלו בחצי הכדור הדרומי 🌘.
FIRST_QUARTER הירח מואר ב-50.1% בצד ימין שלו בחצי הכדור הצפוני 🌓 ובצד שמאל שלו בחצי הכדור הדרומי 🌗.
WAXING_GIBBOUS הירח מואר ב-50%-100% בצד ימין שלו בחצי הכדור הצפוני 🌔 ובצד שמאל שלו בחצי הכדור הדרומי 🌖.
FULL_MOON הירח מואר במלואו.
WANING_GIBBOUS הירח מואר ב-50%-100% בצד שמאל שלו בחצי הכדור הצפוני 🌖 ובצד ימין שלו בחצי הכדור הדרומי 🌔.
LAST_QUARTER הירח מואר ב-50.1% בצד שמאל שלו בחצי הכדור הצפוני 🌗 ובצד ימין שלו בחצי הכדור הדרומי 🌓.
WANING_CRESCENT הירח מואר ב-0% עד 50% בצד שמאל שלו בחצי הכדור הצפוני 🌘 ובצד ימין שלו בחצי הכדור הדרומי 🌒.

סוג

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

טיפוסים בני מנייה (enum)
TYPE_UNSPECIFIED לא צוין מצב מזג האוויר.
CLEAR אין עננים.
MOSTLY_CLEAR מעונן חלקית.
PARTLY_CLOUDY מעונן חלקית (מעט עננים).
MOSTLY_CLOUDY מעונן ברוב שעות היום (יותר עננים משמש).
CLOUDY מעונן (רק עננים, בלי שמש).
WINDY רוח חזקה.
WIND_AND_RAIN רוח חזקה עם משקעים.
LIGHT_RAIN_SHOWERS גשם קל לסירוגין.
CHANCE_OF_SHOWERS סיכוי לגשם לסירוגין.
SCATTERED_SHOWERS גשם לסירוגין.
RAIN_SHOWERS ממטרים הם גשמים שנמשכים פחות זמן מגשם רגיל, ומתאפיינים בהתחלה ובהפסקה פתאומיות ובשינויים מהירים בעוצמה.
HEAVY_RAIN_SHOWERS ממטרים עזים.
LIGHT_TO_MODERATE_RAIN גשם (קל עד בינוני).
MODERATE_TO_HEAVY_RAIN גשם (כמות בינונית עד כבדה).
RAIN גשם בינוני.
LIGHT_RAIN גשם קל.
HEAVY_RAIN גשם כבד.
RAIN_PERIODICALLY_HEAVY גשם, כבד לפרקים.
LIGHT_SNOW_SHOWERS שלג קל שיורד בעוצמות משתנות לפרקי זמן קצרים.
CHANCE_OF_SNOW_SHOWERS סיכוי לממטרי שלג.
SCATTERED_SNOW_SHOWERS שלג שיורד בעוצמות משתנות לפרקי זמן קצרים.
SNOW_SHOWERS ממטרי שלג.
HEAVY_SNOW_SHOWERS ממטרי שלג כבדים.
LIGHT_TO_MODERATE_SNOW שלג קל עד בינוני.
MODERATE_TO_HEAVY_SNOW שלג בינוני עד כבד.
SNOW שלג בינוני.
LIGHT_SNOW שלג קל.
HEAVY_SNOW שלג כבד.
SNOWSTORM שלג עם אפשרות לרעמים וברקים.
SNOW_PERIODICALLY_HEAVY שלג, כבד לפרקים.
HEAVY_SNOW_STORM שלג כבד עם אפשרות לרעמים וברקים.
BLOWING_SNOW שלג עם רוח חזקה.
RAIN_AND_SNOW גשם ושלג מעורבים.
HAIL ברד.
HAIL_SHOWERS ברד שיורד בעוצמות שונות לפרקי זמן קצרים.
THUNDERSTORM סופת רעמים.
THUNDERSHOWER ממטרים מלווים ברעמים וברקים.
LIGHT_THUNDERSTORM_RAIN סופת גשם קלה.
SCATTERED_THUNDERSTORMS סופות רעמים עם גשם בעוצמות שונות לפרקי זמן קצרים.
HEAVY_THUNDERSTORM סופת רעמים כבדה.

PrecipitationType

מייצג את סוג המשקעים במיקום נתון.

טיפוסים בני מנייה (enum)
PRECIPITATION_TYPE_UNSPECIFIED סוג המשקעים לא צוין.
NONE אין משקעים.
SNOW משקעי שלג.
RAIN משקעי גשם.
LIGHT_RAIN גשם קל.
HEAVY_RAIN גשם כבד.
RAIN_AND_SNOW משקעים של גשם ושלג.
SLEET גשם מעורב בשלג.
FREEZING_RAIN משקעים של גשם קפוא.

יחידה

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

טיפוסים בני מנייה (enum)
UNIT_UNSPECIFIED יחידת המידה למשקעים לא צוינה.
MILLIMETERS כמות המשקעים נמדדת במילימטרים.
INCHES כמות המשקעים נמדדת באינצ'ים.

CardinalDirection

מייצג כיוון ראשי (כולל כיווני ביניים).

טיפוסים בני מנייה (enum)
CARDINAL_DIRECTION_UNSPECIFIED לא צוין כיוון.
NORTH כיוון צפון.
NORTH_NORTHEAST כיוון הביניים המשני צפון-צפון-מזרח.
NORTHEAST כיוון הביניים צפון-מזרח.
EAST_NORTHEAST כיוון הביניים המשני מזרח-צפון-מזרח.
EAST כיוון מזרח.
EAST_SOUTHEAST כיוון הביניים המשני מזרח-דרום-מזרח.
SOUTHEAST כיוון הביניים דרום-מזרח.
SOUTH_SOUTHEAST כיוון הביניים המשני דרום-דרום-מזרח.
SOUTH כיוון דרום.
SOUTH_SOUTHWEST כיוון הביניים המשני דרום-דרום-מערב.
SOUTHWEST כיוון הביניים דרום-מערב.
WEST_SOUTHWEST כיוון הביניים המשני מערב-דרום-מערב.
WEST כיוון מערב.
WEST_NORTHWEST כיוון הביניים המשני מערב-צפון-מערב.
NORTHWEST הכיוון המשני צפון-מערב.
NORTH_NORTHWEST כיוון הביניים המשני צפון-צפון-מערב.

SpeedUnit

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

טיפוסים בני מנייה (enum)
SPEED_UNIT_UNSPECIFIED יחידת המהירות לא צוינה.
KILOMETERS_PER_HOUR המהירות נמדדת בקילומטרים לשעה.
MILES_PER_HOUR המהירות נמדדת במיילים לשעה.

הערות לגבי הכלים

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

בנוסף למחרוזת הכותרת, הרמזים הבוליאניים הבאים מוגדרים כך:

  • ‫readOnlyHint: אם הערך הוא True, הכלי לא משנה את הסביבה שלו. ברירת המחדל: false.
  • ‫destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא False, הכלי יכול לבצע רק פעולות הוספה. ברירת המחדל: true.
  • ‫idempotentHint: אם הערך הוא True, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת המחדל: false.
  • ‫openWorldHint: אם הערך הוא True, הכלי יכול לקיים אינטראקציה עם "עולם פתוח" של ישויות חיצוניות. אם הערך הוא false, הכלי יכול לקיים אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי חיפוש באינטרנט הוא כלי בעולם פתוח, אבל כלי זיכרון הוא לא כלי בעולם פתוח.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌