Package google.maps.weather.v1

אינדקס

מזג אוויר

הגדרת השירות של Weather API.

LookupCurrentConditions

rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)

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

היקפי הרשאה

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
LookupForecastDays

rpc LookupForecastDays(LookupForecastDaysRequest) returns (LookupForecastDaysResponse)

הפונקציה מחזירה תחזיות יומיות ל-10 ימים לכל היותר במיקום נתון, החל מהיום הנוכחי.

היקפי הרשאה

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
LookupForecastHours

rpc LookupForecastHours(LookupForecastHoursRequest) returns (LookupForecastHoursResponse)

הפונקציה מחזירה תחזיות שעתיות למיקום נתון למשך עד 240 שעות, החל מהשעה הנוכחית.

היקפי הרשאה

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
LookupHistoryHours

rpc LookupHistoryHours(LookupHistoryHoursRequest) returns (LookupHistoryHoursResponse)

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

היקפי הרשאה

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
LookupPublicAlerts

rpc LookupPublicAlerts(LookupPublicAlertsRequest) returns (LookupPublicAlertsResponse)

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

היקפי הרשאה

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

AirPressure

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

שדות
mean_sea_level_millibars

float

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

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 הכיוון המשני צפון-צפון-מערב.

ודאות

הקוד שמציין את רמת הוודאות של אירוע הנושא בהודעת ההתראה.

טיפוסים בני מנייה (enum)
CERTAINTY_UNKNOWN רמת הוודאות לא ידועה.
OBSERVED נקבע שהאירוע התרחש או שהוא מתרחש כרגע.
VERY_LIKELY סביר מאוד.
LIKELY סביר (p > ~50%).
POSSIBLE אפשרי אבל לא סביר (p <= ~50%).
UNLIKELY סביר להניח שלא (p ~ 0%).

DataSource

מייצג קישור למקור נתונים.

שדות
publisher

Publisher

המוציא לאור של ההתראה.
name

string

השם הרשמי של המוציא לאור. שימו לב: השדה הזה אמור להיות מתורגם לשפה המקומית, אבל אין ערובה לכך.
authority_uri

string

כתובת האתר של הרשות.

ForecastDay

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

שדות
interval

Interval

מרווח הזמן ב-UTC שבו מתחיל (כולל) ומסתיים (לא כולל) היום הזה בתחזית. הערה: יום מתחיל בשעה 7:00 בבוקר ומסתיים בשעה 7:00 בבוקר של היום הבא, לפי הזמן המקומי. לדוגמה: אם אזור הזמן המקומי הוא UTC-7, המרווח יתחיל בשעה 14:00:00.000Z ויסתיים באותה שעה ביום שלמחרת.
display_date

Date

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

ForecastDayPart

תחזית תנאי מזג האוויר לחלק היום שבין 7:00 בבוקר ל-7:00 בערב (לפי השעה המקומית).
nighttime_forecast

ForecastDayPart

תחזית תנאי מזג האוויר לחלק הלילי של היום (19:00 עד 7:00 ביום הבא, זמן מקומי).
max_temperature

Temperature

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

Temperature

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

Temperature

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

Temperature

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

Temperature

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

SunEvents

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

MoonEvents

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

ForecastDayPart

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

שדות
interval

Interval

התאריך והשעה ב-UTC שבהם מתחיל (כולל) ומסתיים (לא כולל) החלק הזה של היום. הערה: חלק מהיום מתחיל בשעה 7:00 ומסתיים בשעה 19:00 באותו יום, לפי הזמן המקומי. לדוגמה: אם אזור הזמן המקומי הוא UTC-7, אז מרווח הזמן של שעות היום יתחיל בשעה 14:00:00.000Z ויסתיים בשעה 02:00:00.000Z ביום שלמחרת, ומרווח הזמן של שעות הלילה יתחיל בשעה 02:00:00.000Z ביום שלמחרת ויסתיים בשעה 14:00:00.000Z באותו יום.
weather_condition

WeatherCondition

תחזית מזג האוויר.
precipitation

Precipitation

התחזית למשקעים.
wind

Wind

הכיוון הממוצע של הרוח והמהירות המקסימלית של הרוח והמשבים.
ice_thickness

IceThickness

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

int32

התחזית של אחוז הלחות היחסית (ערכים מ-0 עד 100).
uv_index

int32

מדד קרינת ה-UV החזוי המקסימלי.
thunderstorm_probability

int32

הסבירות הממוצעת לסופת רעמים.
cloud_cover

int32

אחוז הכיסוי הממוצע של העננים.

ForecastHour

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

שדות
interval

Interval

המרווח של שעה אחת (בשעון UTC) שבו נתוני התחזית האלה תקפים (חותמות הזמן מעוגלות כלפי מטה לשעה הקרובה ביותר).
display_date_time

DateTime

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

WeatherCondition

תחזית מזג האוויר.
temperature

Temperature

הטמפרטורה החזויה.
feels_like_temperature

Temperature

מדד של תחושת הטמפרטורה במיקום המבוקש.
dew_point

Temperature

הטמפרטורה החזויה של נקודת הטל.
heat_index

Temperature

הטמפרטורה החזויה של מדד החום.
wind_chill

Temperature

תחזית של טמפרטורת הרוח, טמפרטורת האוויר שנמדדת על העור.
wet_bulb_temperature

Temperature

טמפרטורת התרמומטר הרטוב הצפויה, הטמפרטורה הכי נמוכה שאפשר להגיע אליה באמצעות אידוי מים.
precipitation

Precipitation

הסבירות למשקעים והכמות המצטברת של משקעים בשעה האחרונה.
air_pressure

AirPressure

תנאי לחץ האוויר הצפויים.
wind

Wind

תחזית תנאי הרוחות.
visibility

Visibility

הניראות החזויה.
ice_thickness

IceThickness

עובי הקרח החזוי.
is_daytime

bool

הערך True אם השעה הזו היא בין שעת הזריחה המקומית (כולל) לבין שעת השקיעה (לא כולל). אחרת, השעה היא בלילה (בין השקיעה לזריחה הבאה). הערה: השעה הזו תיחשב כשעה ביום או בלילה אם היא חופפת לשעות הזריחה והשקיעה המקומיות (לדוגמה: אם השעה היא 5:00 עד 6:00 והזריחה היא ב-5:59, הערך של is_daytime יהיה true).
relative_humidity

int32

התחזית של אחוז הלחות היחסית (ערכים מ-0 עד 100).
uv_index

int32

מדד קרינת UV לפי התחזית.
thunderstorm_probability

int32

ההסתברות לתחזית של סופת רעמים (ערכים מ-0 עד 100).
cloud_cover

int32

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

HistoryHour

מייצג רשומה של היסטוריה לפי שעה במיקום נתון.

שדות
interval

Interval

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

DateTime

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

WeatherCondition

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

Temperature

הטמפרטורה ההיסטורית.
feels_like_temperature

Temperature

מדד של תחושת הטמפרטורה במיקום המבוקש.
dew_point

Temperature

הטמפרטורה ההיסטורית של נקודת הטל.
heat_index

Temperature

הטמפרטורה ההיסטורית של מדד החום.
wind_chill

Temperature

היסטוריית הטמפרטורות שמרגישים ברוח, טמפרטורת האוויר שחשופה לעור.
wet_bulb_temperature

Temperature

טמפרטורת התרמומטר הרטוב ההיסטורית, הטמפרטורה הנמוכה ביותר שאפשר להשיג באמצעות אידוי מים.
precipitation

Precipitation

הסבירות ההיסטורית למשקעים וכמות המשקעים שהצטברה בשעה האחרונה.
air_pressure

AirPressure

תנאי לחץ האוויר ההיסטוריים.
wind

Wind

תנאי הרוח ההיסטוריים.
visibility

Visibility

היסטוריית החשיפה.
ice_thickness

IceThickness

עובי הקרח ההיסטורי.
is_daytime

bool

הערך True אם השעה הזו היא בין שעת הזריחה המקומית (כולל) לבין שעת השקיעה (לא כולל). אחרת, מדובר בשעות הלילה (בין השקיעה לזריחה של היום הבא). הערה: השעה הזו תיחשב כיום או כלילה אם המרווח מצטלב עם זמני הזריחה והשקיעה המקומיים בהתאמה (לדוגמה: אם המרווח הוא מ-5:00 עד 6:00 והזריחה היא ב-5:59, אז is_daytime יהיה true).
relative_humidity

int32

האחוז ההיסטורי של הלחות היחסית (ערכים מ-0 עד 100).
uv_index

int32

מדד היסטורי של קרינת UV.
thunderstorm_probability

int32

ההסתברות ההיסטורית לסופת רעמים (ערכים מ-0 עד 100).
cloud_cover

int32

האחוז ההיסטורי של השמיים שמכוסה בעננים (ערכים מ-0 עד 100).

IceThickness

מייצג את תנאי עובי הקרח.

שדות
unit

Unit

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

float

ערך עובי הקרח.

יחידה

יחידת המידה שמשמשת למדידת עובי הקרח.

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

LookupCurrentConditionsRequest

בקשה לקריאה לשירות מרוחק (RPC) לאחזור נתונים של התנאים הנוכחיים.

שדות
location

LatLng

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

UnitsSystem

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

string

אופציונלי. מאפשר ללקוח לבחור את השפה של התשובה. אם אי אפשר לספק נתונים בשפה הזו, ה-API ישתמש בהתאמה הקרובה ביותר. הערכים המותרים מבוססים על התקן IETF BCP-47. ערך ברירת המחדל הוא en.

LookupCurrentConditionsResponse

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

שדות
current_time

Timestamp

השעה הנוכחית (UTC) שמשויכת לנתונים שהוחזרו.
time_zone

TimeZone

אזור הזמן במיקום המבוקש.
weather_condition

WeatherCondition

תנאי מזג האוויר הנוכחיים.
temperature

Temperature

הטמפרטורה הנוכחית
feels_like_temperature

Temperature

מדד של תחושת הטמפרטורה הנוכחית במיקום המבוקש.
dew_point

Temperature

הטמפרטורה הנוכחית של נקודת הטל.
heat_index

Temperature

טמפרטורת מדד החום הנוכחית.
wind_chill

Temperature

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

Precipitation

הסבירות הנוכחית למשקעים וכמות המשקעים שהצטברה בשעה האחרונה.
air_pressure

AirPressure

תנאי לחץ האוויר הנוכחיים.
wind

Wind

תנאי הרוח הנוכחיים.
visibility

Visibility

הרשאות הגישה הנוכחיות.
current_conditions_history

CurrentConditionsHistory

השינויים בתנאים הנוכחיים ב-24 השעות האחרונות.
is_daytime

bool

הערך הוא True אם השעה הנוכחית במיקום המבוקש היא בין שעת הזריחה המקומית (כולל) לבין שעת השקיעה (לא כולל). אחרת, מדובר בשעות הלילה (בין השקיעה לזריחה של היום הבא).
relative_humidity

int32

האחוז הנוכחי של הלחות היחסית (ערכים מ-0 עד 100).
uv_index

int32

מדד קרינת ה-UV הנוכחי.
thunderstorm_probability

int32

הסבירות הנוכחית לסופת רעמים (ערכים מ-0 עד 100).
cloud_cover

int32

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

CurrentConditionsHistory

מייצג קבוצה של שינויים בתנאים הנוכחיים ב-24 השעות האחרונות.

שדות
temperature_change

Temperature

הטמפרטורה הנוכחית פחות הטמפרטורה לפני 24 שעות.
max_temperature

Temperature

הטמפרטורה המקסימלית (הגבוהה) ב-24 השעות האחרונות.
min_temperature

Temperature

הטמפרטורה המינימלית (הנמוכה) ב-24 השעות האחרונות.
snow_qpf

QuantitativePrecipitationForecast

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

QuantitativePrecipitationForecast

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

LookupForecastDaysRequest

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

שדות
location

LatLng

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

UnitsSystem

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

int32

אופציונלי. מספר הרשומות המקסימלי של תחזיות יומיות שיוחזרו בכל דף – ערך בין 1 ל-10 (כולל). ערך ברירת המחדל הוא 5.
page_token

string

אופציונלי. טוקן של דף שהתקבל מבקשה קודמת. הוא משמש לאחזור הדף הבא.
days

int32

אופציונלי. מגביל את מספר הימים הכולל לאחזור החל מהיום הנוכחי – ערך מ-1 עד 10 (כולל). ערך ברירת המחדל הוא הערך המקסימלי המותר, 10.
language_code

string

אופציונלי. מאפשר ללקוח לבחור את השפה של התשובה. אם אי אפשר לספק נתונים בשפה הזו, ה-API ישתמש בהתאמה הקרובה ביותר. הערכים המותרים מבוססים על התקן IETF BCP-47. ערך ברירת המחדל הוא en.

LookupForecastDaysResponse

תשובה לקריאה לשירות מרוחק (RPC) לאחזור תחזית של מספר ימים.

שדות
forecast_days[]

ForecastDay

התחזית היומית מתועדת לפי מספר הימים וגודל הדף שצוינו בבקשה.
time_zone

TimeZone

אזור הזמן במיקום המבוקש.
next_page_token

string

הטוקן לאחזור הדף הבא.

LookupForecastHoursRequest

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

שדות
location

LatLng

חובה. המיקום שרוצים לקבל לגביו תחזית לפי שעות.
units_system

UnitsSystem

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

int32

אופציונלי. מספר הרשומות המקסימלי של תחזיות שעתיות שיוחזרו בכל דף – ערך מ-1 עד 24 (כולל). ברירת המחדל היא הערך המקסימלי המותר, 24.
page_token

string

אופציונלי. טוקן של דף שהתקבל מבקשה קודמת. הוא משמש לאחזור הדף הבא.
hours

int32

אופציונלי. מגביל את מספר השעות הכולל לאחזור החל מהשעה הנוכחית – ערך מ-1 עד 240 (כולל). ברירת המחדל היא הערך המקסימלי המותר של 240.
language_code

string

אופציונלי. מאפשר ללקוח לבחור את השפה של התשובה. אם אי אפשר לספק נתונים בשפה הזו, ה-API ישתמש בהתאמה הקרובה ביותר. הערכים המותרים מבוססים על התקן IETF BCP-47. ערך ברירת המחדל הוא en.

LookupForecastHoursResponse

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

שדות
forecast_hours[]

ForecastHour

התחזית השעתית מתעדת את מספר השעות ואת גודל הדף שצוינו בבקשה.
time_zone

TimeZone

אזור הזמן במיקום המבוקש.
next_page_token

string

הטוקן לאחזור הדף הבא.

LookupHistoryHoursRequest

בקשה לקריאה לשירות מרוחק (RPC) לאחזור נתונים של LookupHistoryHours.

שדות
location

LatLng

חובה. המיקום שאליו רוצים לקבל את הנתונים ההיסטוריים השעתיים.
units_system

UnitsSystem

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

int32

אופציונלי. מספר הרשומות המקסימלי של נתונים היסטוריים לפי שעה שיוחזרו בכל דף – ערך מ-1 עד 24 (כולל). ברירת המחדל היא הערך המקסימלי המותר, 24.
page_token

string

אופציונלי. טוקן של דף שהתקבל מבקשה קודמת. הוא משמש לאחזור הדף הבא.
hours

int32

אופציונלי. מגביל את מספר השעות הכולל לאחזור החל מהשעה האחרונה – מספר בין 1 ל-24 (כולל). ברירת המחדל היא הערך המקסימלי המותר, 24.
language_code

string

אופציונלי. מאפשר ללקוח לבחור את השפה של התשובה. אם אי אפשר לספק נתונים בשפה הזו, ה-API ישתמש בהתאמה הקרובה ביותר. הערכים המותרים מבוססים על התקן IETF BCP-47. ערך ברירת המחדל הוא en.

LookupHistoryHoursResponse

תשובה לקריאה לשירות מרוחק (RPC) של LookupHistoryHours.

שדות
history_hours[]

HistoryHour

הרשומות ההיסטוריות השעתיות, בהתאם למספר השעות ולגודל הדף שצוינו בבקשה.
time_zone

TimeZone

אזור הזמן במיקום המבוקש.
next_page_token

string

הטוקן לאחזור הדף הבא.

LookupPublicAlertsRequest

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

שדות
location

LatLng

חובה. המיקום שעבורו רוצים לקבל התראות ציבוריות על מזג האוויר. השירות יחזיר התראות שהאזור המושפע שלהן מצטלב עם המיקום הזה.
page_size

int32

אופציונלי. המספר המקסימלי של רשומות של התראות מזג אוויר ציבוריות שיוחזרו בכל דף.
page_token

string

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

string

אופציונלי. מאפשר ללקוח לבחור את השפה של התשובה. אם אי אפשר לספק נתונים בשפה הזו, ה-API ישתמש בהתאמה הקרובה ביותר. הערכים המותרים מבוססים על התקן IETF BCP-47. ערך ברירת המחדל הוא en.

LookupPublicAlertsResponse

תשובה לקריאה לשירות מרוחק (RPC) של LookupPublicAlerts.

שדות
weather_alerts[]

PublicAlerts

רשומות ההתראות הציבוריות על מזג האוויר, בהתאם למספר ההתראות ולגודל הדף שצוינו בבקשה.
region_code

string

קוד ISO_3166-1 alpha-2 של האזור שתואם למיקום שצוין בבקשה. האזור מצוין באמצעות קוד ISO_3166-1_alpha-2.
next_page_token

string

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

MoonEvents

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

שדות
moonrise_times[]

Timestamp

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

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

Timestamp

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

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

MoonPhase

מופע הירח (נקרא גם שלב הירח).

MoonPhase

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

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

משקעים

מייצג קבוצה של ערכי משקעים במיקום נתון.

שדות
probability

PrecipitationProbability

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

QuantitativePrecipitationForecast

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

QuantitativePrecipitationForecast

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

PrecipitationProbability

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

שדות
type

PrecipitationType

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

int32

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

PrecipitationType

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

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

PublicAlerts

מייצג את ההתרעות הציבוריות על מזג האוויר.

שדות
alert_id

string

המזהה הייחודי של ההתראה.
alert_title

LocalizedText

הכותרת של ההתראה שמותאמת לשוק המקומי.
event_type

WeatherEventType

סוג אירוע מזג האוויר.
area_name

string

שם האזור שבו ההתראה הונפקה.
instruction[]

string

הוראות מומלצות של בעל התוכן הדיגיטלי. שימו לב: השדה הזה אמור להיות מתורגם לשפה המקומית, אבל אין ערובה לכך.
safety_recommendations[]

SafetyRecommendation

הנחיה למשתמש בנוגע לבטיחות, שיכולה להינתן על ידי בעל התוכן הדיגיטלי או גורמים מוסמכים אחרים.
timezone_offset

string

ההפרש בין אזור הזמן של המיקום שבו התקבלה ההתראה לבין UTC. הערך הוא מחרוזת שמסתיימת ב-s, למשל, ‫‎"-14400s" לציון 4 שעות אחרי שעון UTC.
start_time

Timestamp

שעת ההתחלה של האירוע.
expiration_time

Timestamp

תאריך התפוגה של האירוע.
data_source

DataSource

פרטים של המו"ל ששלח את ההתראה.
polygon

string

ייצוג GeoJSON של האזורים שבהם ההתראה מתפרסמת.

נתוני ה-GeoJSON צריכים להיות בפורמט RFC 7946 ולייצג פוליגון (לאזור רציף יחיד) או MultiPolygon (למספר אזורים נפרדים).

דוגמה:

‪{ "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }

מחרוזת לדוגמה של MultiPolygon GeoJson נראית כך:

‪{ "type": "MultiPolygon", "coordinates": [ [ [0, 0], [-1, 0], [-1, 1], [0, 0] ], [ [0, 0], [-2, 0], [-2, 2], [0, 0] ] ]
description

string

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

Severity

רמת החומרה של ההתראה.
certainty

Certainty

רמת הוודאות של ההתראה.
urgency

Urgency

דחיפות ההתראה.

בעל תוכן דיגיטלי

המוציא לאור של ההתראה.

טיפוסים בני מנייה (enum)
PUBLISHER_UNSPECIFIED לא צוין בעל תוכן דיגיטלי.
AUSTRALIA_ACT_ESA אוסטרליה טריטוריית הבירה האוסטרלית
AUSTRALIA_NSW_RFS ניו סאות' ויילס
AUSTRALIA_QLD_QFES Queensland
AUSTRALIA_SA_CFS דרום אוסטרליה
METEO_ALARM_AT Meteoalarm / EUMETNET Austria
METEO_ALARM_BS בוסניה
BRAZIL_CENAD Brazil Disaster Agency בברזיל
BRAZIL_INMET הסוכנות המטאורולוגית בברזיל
UK_ENV_AGENCY בריטניה
METEO_ALARM_BG Meteoalarm / EUMETNET Bulgaria
METEO_ALARM_CR קרואטיה
METEO_ALARM_CY קפריסין
METEO_ALARM_CS צ'כיה
METEO_ALARM_DK דנמרק
EC_INAMHI אקוודור
METEO_ALARM_FI Meteoalarm / EUMETNET Finland
METEO_ALARM_FR צרפת
DE_DWD גרמניה
METEO_ALARM_GB Meteoalarm / EUMETNET Great Britain
METEO_ALARM_GR יוון
METEO_ALARM_HU הונגריה
METEO_ALARM_IS איסלנד
METEO_ALARM_IE אירלנד
METEO_ALARM_IT איטליה
JM_JMS ג'מייקה
JMA יפן
METEO_ALARM_NL Meteoalarm / EUMETNET Netherlands
METEO_ALARM_LV לטביה
METEO_ALARM_LT ליטא
METEO_ALARM_LU לוקסמבורג
MEXICO_CIRES מקסיקו מקסיקו CIRES
NZ_GEONET ניו זילנד New Zealand GeoNet
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET North Macedonia
METEO_ALARM_NO נורווגיה
PHILIPPINES_PAGASA הפיליפינים
METEO_ALARM_PL Meteoalarm / EUMETNET Poland
METEO_ALARM_PT פורטוגל
METEO_ALARM_RO רומניה
METEO_ALARM_RS סרביה
SG_MSS סינגפור
METEO_ALARM_SK Meteoalarm / EUMETNET Slovakia
METEO_ALARM_SI סלובניה
SB_MET איי שלמה
METEO_ALARM_ES Meteoalarm / EUMETNET Spain
METEO_ALARM_SE שוודיה
METEO_ALARM_CH שווייץ
TAIWAN_NCDR טאיוואן
NOAA ‫NOAA בארצות הברית
WCATWC National Tsunami Warning Center

QuantitativePrecipitationForecast

מייצג את כמות המשקעים המומסים הצפויה שהצטברה במהלך תקופת זמן מסוימת באזור מסוים (מקור: https://en.wikipedia.org/wiki/Quantitative_precipitation_forecast) – בדרך כלל מקוצר ל-QPF.

שדות
unit

Unit

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

float

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

יחידה

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

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

SafetyRecommendation

מייצג המלצה בנושא בטיחות.

שדות
directive

string

הוראה למשתמש. שימו לב: השדה הזה אמור להיות מתורגם לשפה המקומית, אבל אין ערובה לכך.
subtext

string

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

מידת החומרה

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

טיפוסים בני מנייה (enum)
SEVERITY_UNKNOWN דרגת החומרה לא ידועה.
EXTREME סכנה יוצאת דופן לנפש או לרכוש.
SEVERE סכנה משמעותית לחיים או לרכוש.
MODERATE סכנה אפשרית לחיים או לרכוש.
MINOR סכנה קלה לנפש או לרכוש.

SpeedUnit

יחידת המידה שמשמשת למדידת המהירות.

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

SunEvents

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

שדות
sunrise_time

Timestamp

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

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

Timestamp

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

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

טמפרטורה

מייצג ערך טמפרטורה.

שדות
unit

TemperatureUnit

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

float

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

TemperatureUnit

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

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

UnitsSystem

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

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

דחיפות

הקוד שמציין את הדחיפות של אירוע הנושא בהודעת ההתראה.

טיפוסים בני מנייה (enum)
URGENCY_UNKNOWN רמת הדחיפות לא ידועה.
IMMEDIATE צריך לפעול באופן מיידי.
EXPECTED מומלץ לנקוט פעולה בהקדם (במהלך השעה הקרובה).
FUTURE צריך לנקוט פעולה בתגובה בעתיד הקרוב.
PAST אין יותר צורך בפעולה מצידכם.

חשיפה

מייצג את תנאי הראות, המרחק שבו אפשר להבחין באובייקטים.

שדות
unit

Unit

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

float

מרחק הראייה ביחידה שצוינה.

יחידה

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

טיפוסים בני מנייה (enum)
UNIT_UNSPECIFIED יחידת החשיפה לא צוינה.
KILOMETERS החשיפה נמדדת בקילומטרים.
MILES החשיפה נמדדת בקילומטרים.

WeatherCondition

מייצג את תנאי מזג האוויר במיקום מסוים בתקופה מסוימת.

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

שדות
icon_base_uri

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

LocalizedText

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

Type

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

סוג

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

טיפוסים בני מנייה (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 סופת רעמים כבדה.

WeatherEventType

סוג אירוע מזג האוויר.

טיפוסים בני מנייה (enum)
WEATHER_EVENT_TYPE_UNSPECIFIED סוג אירוע מזג אוויר לא מוגדר.
ACID_RAIN אירוע של גשם חומצי.
AFTERSHOCK אירוע של רעידת משנה.
AVALANCHE אירוע של מפולת שלגים.
BLIZZARD אירוע סופת שלגים.
BLOWING_SNOW אירוע של משבי שלגים.
BUSHFIRE אירוע שריפת חורש.
COASTAL_FLOOD שיטפון באזור החוף.
COASTAL_HAZARD אירוע של סכנה בחופים.
COLD אירוע קר.
CYCLONE אירוע של ציקלון.
DROUGHT אירוע בצורת.
DUST_STORM אירוע של סופת אבק.
EARTHQUAKE אירוע רעידת אדמה.
EXTRATROPICAL_CYCLONE אירוע של סופת ציקלון טרופית.
FIRE הפעלת אירוע.
FIRE_WEATHER אירוע של מזג אוויר שגורם לשריפות.
FLASH_FLOOD אירוע של שיטפון בזק.
FLOOD אירוע שיטפון.
FOG אירוע ערפל.
FREEZING אירוע קפיאה.
FREEZING_AIR_TEMPERATURE אירוע של טמפרטורת אוויר קפואה.
FREEZING_DRIZZLE אירוע של טפטוף מקפיא.
FREEZING_RAIN_EVENT אירוע של גשם קפוא.
FROST אירוע קרה.
GALE אירוע של רוחות חזקות מאוד.
GLAZE אירוע של ציפוי.
HAIL אירוע של ברד.
HAZARDOUS_SEAS אירוע של ים סוער.
HEAT אירוע שקשור לחום.
HUMIDITY אירוע לחות.
HURRICANE אירוע הוריקן.
ICE_STORM אירוע של סופת קרח.
INDUSTRIAL_FIRE אירוע שריפה באזור תעשייה.
LAKE_EFFECT_SNOW אירוע של שלג כבד.
LANDSLIDE אירוע של מפולת.
MONSOON אירוע מונסון.
MUDDY_FLOOD שיטפון בוצי.
OUTFLOW אירוע יציאה.
RADIATION אירוע קרינה.
RAIN_EVENT אירוע גשם.
RIVER_FLOODING אירוע שיטפון בנהר.
SEVERE_THUNDERSTORM_WARNING אירוע של אזהרה על סופת רעמים חמורה.
SNOWSQUALL אירוע של סופת שלג פתאומית.
SNOW_EVENT אירוע שלג.
STORM אירוע סערה.
STORM_SURGE אירוע של גל סערה.
THUNDER אירוע רעם.
THUNDERSTORM אירוע של סופת רעמים.
TORNADO אירוע טורנדו.
TORNADO_WARNING אירוע של אזהרת טורנדו.
TROPICAL_CYCLONE אירוע של סופת ציקלון טרופית.
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES אירוע של אזהרות והתראות על סופות ציקלון טרופיות.
TROPICAL_DISTURBANCE אירוע של הפרעה טרופית.
TROPICAL_STORM אירוע של סופה טרופית.
TSUNAMI אירוע צונאמי.
TYPHOON אירוע של טייפון.
VOLCANIC_ASH אירוע של אפר וולקני.
VOLCANIC_ERUPTION אירוע התפרצות הר געש.
WILDFIRE אירוע שריפת יער.
WIND אירוע רוח.
WIND_CHILL אירוע של צינת רוח.
WIND_WAVE אירוע של גלי רוח.
WINTER_STORM אירוע של סופת חורף.

רוח

מייצג קבוצה של מאפייני רוח.

שדות
direction

WindDirection

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

WindSpeed

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

WindSpeed

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

WindDirection

מייצג את הכיוון שממנו הרוח מגיעה.

שדות
cardinal

CardinalDirection

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

int32

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

WindSpeed

מייצג את מהירות הרוח.

שדות
unit

SpeedUnit

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

float

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