MCP Tools Reference: mapstools.googleapis.com

כלי: lookup_weather

שליפת נתוני מזג אוויר מקיפים, כולל התנאים הנוכחיים, תחזיות לפי שעה ותחזיות יומיות. נתונים ספציפיים שזמינים: טמפרטורה (נוכחית, מה הטמפרטורה בפועל, מקסימלית/מינימלית, מדד החום), רוח (מהירות, משבי רוח, כיוון), אירועים אסטרונומיים (זריחה/שקיעה, מופע הירח), משקעים (סוג, הסתברות, כמות), תנאים אטמוספריים (מדד קרינת UV, לחות, כיסוי עננים, הסתברות לסופת רעמים) וכתובת מיקום עם קידוד גיאוגרפי. מיקום וכללי מיקום (קריטי): המיקום שעבורו מתבקשים נתוני מזג האוויר מצוין בשדה 'מיקום'. השדה הזה הוא מבנה מסוג 'oneof', כלומר אתם חייבים לספק ערך רק לאחד משלושת שדות המשנה של המיקום שבהמשך כדי להבטיח חיפוש מדויק של נתוני מזג האוויר. 1. קואורדינטות גיאוגרפיות (lat_lng) * משתמשים בהן כשמספקים לכם קואורדינטות מדויקות של קו רוחב/אורך. * דוגמה: ‎"lat_lng": { "latitude": 34.0522, "longitude": -118.2437 } // Los Angeles 2. מזהה מקום (place_id) * מזהה מחרוזת חד-משמעי (מזהה מקום במפות Google). * אפשר לאחזר את מזהה המקום באמצעות הכלי search_places. * דוגמה: "place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0" // Eiffel Tower 3. מחרוזת כתובת (address) * מחרוזת חופשית שצריך לציין בה פרטים ספציפיים כדי להמיר את הכתובת לקואורדינטות. * עיר ואזור: תמיד צריך לכלול אזור או מדינה (למשל, ‫"London, UK" ולא "London"). * כתובת: יש לציין את הכתובת המלאה (לדוגמה, ‪1600 Pennsylvania Ave NW, Washington, DC). * מיקודים: חובה לציין את שם המדינה (לדוגמה, ‫"90210, USA", ולא "90210"). מצבי שימוש: 1. מזג אוויר נוכחי: צריך לספק רק את address. אל תציינו את date ואת hour. 2. תחזית שעתית: תן לי את address, date ו-hour (0-23). אפשר להשתמש בהן לזמנים ספציפיים (למשל, ‫"at 5 PM" (בשעה 17:00) או מונחים כמו 'next few hours' (במהלך השעות הקרובות) או 'later today' (בהמשך היום). אם המשתמש מציין דקה, מעגלים כלפי מטה לשעה הקרובה ביותר. אין תמיכה בתחזית לפי שעה מעבר ל-48 שעות מהרגע הזה. 3. תחזית יומית: מספקים את address וdate. אל תציינו את הערך hour. שימוש לבקשות כלליות ליום מסוים (למשל, ‫"weather for tomorrow" (מזג האוויר מחר), ‏"weather on Friday" (מזג האוויר ביום שישי), ‏"weather on 12/25" (מזג האוויר ב-25 בדצמבר). אם התאריך של היום לא מופיע בהקשר, צריך לברר אותו עם המשתמש. אין תמיכה בתחזית יומית מעבר ל-7 ימים, כולל היום. אין תמיכה בנתוני מזג אוויר היסטוריים. אילוצים של פרמטרים: * אזורי זמן: כל הערכים של date ו-hour צריכים להיות יחסיים לאזור הזמן המקומי של המיקום, ולא לאזור הזמן של המשתמש. * פורמט התאריך: צריך להזין {year, month, day} מספרים שלמים מופרדים. * יחידות: ברירת המחדל היא METRIC. מגדירים את units_system לערך IMPERIAL עבור פרנהייט/מיילים אם המשתמש מרמז על תקנים אמריקאיים או מבקש זאת במפורש.

בדוגמה הבאה מוצג איך להשתמש ב-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 (google.type.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 (google.type.Date)

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

שדה איחוד _hour.

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

hour

integer

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

תאריך

ייצוג ב-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 (google.type.LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
שדות
שדה איחוד location_type. דרכים שונות לייצוג מיקום. הערך location_type יכול להיות רק אחד מהבאים:
latLng

object (google.type.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)
  },

  // 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)

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

שדה איחוד _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 (google.type.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 (google.type.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 (google.type.LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
שדות
שדה איחוד location_type. דרכים שונות לייצוג מיקום. הערך location_type יכול להיות רק אחד מהבאים:
latLng

object (google.type.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].

הערות על כלים

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