MCP Tools Reference: mapstools.googleapis.com

כלי: lookup_weather

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

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

מיקום וכללי מיקום (קריטי):

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

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

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

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

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

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

    • מחרוזת חופשית שדורשת ספציפיות לגיאו-קידוד.
    • עיר ואזור: תמיד צריך לכלול את האזור או המדינה (למשל, 'לונדון, בריטניה' ולא רק 'לונדון').
    • כתובת: מציינים את הכתובת המלאה (לדוגמה, "1600 Pennsylvania Ave NW, Washington, DC").
    • מיקודים: חובה לציין את שם המדינה (לדוגמה, '90210, USA', ולא '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 כדי להפעיל את הכלי lookup_weather MCP.

בקשת 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 – מייצגת את תנאי מזג האוויר במיקום המבוקש.

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 ל-9,999, או 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

כתובת קריאה או קוד פלוס. פרטים נוספים זמינים בכתובת 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 מערכת היחידות המטרית (למשל, צלזיוס, קילומטרים וכו').

סכימת הפלט

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

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

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)

חובה. המיקום שבו מוצג מידע על מזג האוויר. המיקום הזה זהה למיקום שצוין בבקשה, אבל יכול להיות שונה ממנו אם המיקום המבוקש הוא כתובת בטקסט חופשי שמתייחסת למיקום גס (לדוגמה, 'מאונטיין ויו, קליפורניה').
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

כתובת קריאה או קוד פלוס. פרטים נוספים זמינים בכתובת 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

השם שיוצג לשיוך.
url

string

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

TemperatureUnit

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

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

MoonPhase

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

טיפוסים בני מנייה (enum)
MOON_PHASE_UNSPECIFIED לא צוין מופע ירח.
NEW_MOON הירח לא מואר על ידי השמש.
WAXING_CRESCENT בחצי הכדור הצפוני, הירח מואר ב-0% עד 50% בצד ימין שלו 🌒, ובחצי הכדור הדרומי הוא מואר ב-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, הכלי יכול ליצור אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי לחיפוש באינטרנט יהיה עולם פתוח, אבל כלי לזיכרון לא יהיה עולם פתוח.

רמז הרסני: ❌ | רמז אידמפוטנטי: ❌ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌