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).
    • אפשר לאחזר את מזהה המקום באמצעות הכלי search_places.
    • דוגמה: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // מגדל אייפל

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

    • מחרוזת חופשית שנדרשת ספציפיות לגיאו-קידוד.
    • עיר ואזור: תמיד צריך לכלול אזור או מדינה (לדוגמה, London, UK ולא London).
    • כתובת: מציינים את הכתובת המלאה (לדוגמה, "בן גוריון 35, רמת גן, ישראל").
    • מיקודים: חובה לציין את שם המדינה (לדוגמה, '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 כדי להפעיל את כלי ה-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 tool's MCP 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 ל-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

כתובת קריאה או קוד פלוס. פרטים נוספים זמינים בכתובת 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% בצד ימין שלו בחצי הכדור הצפוני 🌒 ובצד שמאל שלו בחצי הכדור הדרומי 🌘.
FIRST_QUARTER בצד ימין של הירח בחצי הכדור הצפוני מואר 50.1% 🌓, ובצד שמאל שלו בחצי הכדור הדרומי מואר 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 המהירות נמדדת במיילים לשעה.

הערות על כלי

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