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. השימוש הוא לבקשות כלליות לגבי היום (למשל, "weather for tomorrow" [מזג האוויר מחר], "weather on Friday" [מזג האוויר ביום שישי], "weather on 12/25" [מזג האוויר ב-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 
{
  "DEPRECATEDAddress": string,
  "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.
}
שדות
DEPRECATEDAddress
(deprecated)

string

הוצא משימוש: במקום זאת, צריך להשתמש במיקום.
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].

סכימת פלט

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

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

LookupWeatherResponse

ייצוג JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "DEPRECATEDGeocodedAddress": string,
  "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)

תנאי הרוח
DEPRECATEDGeocodedAddress
(deprecated)

string

המאפיין הזה יצא משימוש. במקומו צריך להשתמש במאפיין returned_location.
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 לקישור לצורך שיוך.

הערות על כלי

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