Package google.maps.weather.v1

색인

날씨

날씨 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

기본 방향 (서수 방향 포함)을 나타냅니다.

열거형
CARDINAL_DIRECTION_UNSPECIFIED 방위가 지정되지 않았습니다.
NORTH 북쪽 기본 방향입니다.
NORTH_NORTHEAST 북북동쪽 2차 중간 방향입니다.
NORTHEAST 북동쪽 방위입니다.
EAST_NORTHEAST 동북동 2차 방위입니다.
EAST 동쪽 기본 방향입니다.
EAST_SOUTHEAST 동남쪽 2차 방위입니다.
SOUTHEAST 남동쪽 간방향입니다.
SOUTH_SOUTHEAST 남남동 2차 방위입니다.
SOUTH 남쪽 기본 방향입니다.
SOUTH_SOUTHWEST 남남서쪽 2차 방위입니다.
SOUTHWEST 남서쪽 간방향입니다.
WEST_SOUTHWEST 서남서 2차 방위입니다.
WEST 서쪽 기본 방향입니다.
WEST_NORTHWEST 서북서 보조 방위입니다.
NORTHWEST 북서쪽 중간 방향입니다.
NORTH_NORTHWEST 북북서쪽 보조 방위입니다.

확실성

알림 메시지의 주제 이벤트의 확실성을 나타내는 코드입니다.

열거형
CERTAINTY_UNKNOWN 확실성을 알 수 없습니다.
OBSERVED 발생했거나 진행 중인 것으로 확인되었습니다.
VERY_LIKELY 그럴 가능성이 매우 높습니다.
LIKELY 가능성 높음 (p > ~50%)
POSSIBLE 가능하지만 가능성이 낮습니다 (p <= ~50%).
UNLIKELY 가능성이 낮음 (p ~ 0%).

DataSource

데이터 소스 링크를 나타냅니다.

필드
publisher

Publisher

알림의 게시자입니다.

name

string

공식 게시자 이름입니다. 이 필드는 현지화되어야 하지만 현지화가 보장되지는 않습니다.

authority_uri

string

기관 웹사이트의 URL입니다.

ForecastDay

특정 위치의 일일 예측 기록을 나타냅니다.

필드
interval

Interval

이 예측된 날짜가 시작 (포함)되고 종료 (제외)되는 UTC 시간 간격입니다. 참고: 하루는 현지 시간으로 오전 7시에 시작하여 다음 날 오전 7시에 종료됩니다. 예를 들어 현지 시간대가 UTC-7인 경우 간격은 14:00:00.000Z 시간에 시작되고 다음 날 같은 시간에 종료됩니다.

display_date

Date

이 일일 예보가 계산된 위치의 시간대 (시민 시간)에 해당하는 현지 날짜입니다. 이 필드는 클라이언트에서 표시 목적으로 사용될 수 있습니다.

daytime_forecast

ForecastDayPart

하루 중 낮 시간대 (현지 시간 오전 7시~오후 7시)의 예상 날씨입니다.

nighttime_forecast

ForecastDayPart

하루 중 야간 시간대 (오후 7시~다음 날 오전 7시, 현지 시간)의 예상 날씨입니다.

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시에 시작하여 당일 오후 7시에 종료됩니다. 예를 들어 현지 시간대가 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

이 예측 데이터가 유효한 1시간 간격 (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

예측된 강수 확률과 지난 1시간 동안 누적된 강수량입니다.

air_pressure

AirPressure

예상 기압 조건입니다.

wind

Wind

예상되는 바람 상태입니다.

visibility

Visibility

예상 공개 상태입니다.

ice_thickness

IceThickness

예상되는 얼음 두께입니다.

is_daytime

bool

이 시간이 현지 일출 (포함)과 일몰 (제외) 시간 사이에 있으면 True입니다. 그렇지 않으면 밤입니다 (일몰과 다음 일출 사이). 참고: 이 시간은 간격이 각각 현지 일출 및 일몰 시간과 교차하는 경우 낮 또는 밤으로 간주됩니다 (예: 간격이 오전 5시부터 오전 6시까지이고 일출이 오전 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

이 이전 데이터가 유효한 1시간 간격 (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

지난 1시간 동안 누적된 강수량과 과거 강수 확률입니다.

air_pressure

AirPressure

이전 기압 조건입니다.

wind

Wind

이전 바람 상태입니다.

visibility

Visibility

이전 공개 상태입니다.

ice_thickness

IceThickness

이전 얼음 두께입니다.

is_daytime

bool

이 시간이 현지 일출 (포함)과 일몰 (제외) 시간 사이에 있으면 True입니다. 그렇지 않으면 밤입니다 (일몰과 다음 일출 사이). 참고: 이 시간은 간격이 각각 현지 일출 및 일몰 시간과 교차하는 경우 낮 또는 밤으로 간주됩니다 (예: 간격이 오전 5시부터 오전 6시까지이고 일출이 오전 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

얼음 두께 값입니다.

단위

얼음 두께를 측정하는 데 사용되는 단위를 나타냅니다.

열거형
UNIT_UNSPECIFIED 단위가 지정되지 않았습니다.
MILLIMETERS 두께는 밀리미터 단위로 측정됩니다.
INCHES 두께는 인치 단위로 측정됩니다.

LookupCurrentConditionsRequest

LookupCurrentConditions RPC 요청입니다.

필드
location

LatLng

필수 항목입니다. 현재 날씨를 가져올 위치입니다.

units_system

UnitsSystem

선택사항입니다. 반환된 날씨 조건에 사용할 단위 시스템입니다. 제공되지 않으면 반환된 날씨 조건이 미터법으로 표시됩니다 (기본값 = METRIC).

language_code

string

선택사항입니다. 클라이언트가 대답의 언어를 선택할 수 있습니다. 해당 언어의 데이터를 제공할 수 없는 경우 API는 가장 근접한 일치 항목을 사용합니다. 허용되는 값은 IETF BCP-47 표준을 따릅니다. 기본값은 'en'입니다.

LookupCurrentConditionsResponse

LookupCurrentConditions RPC의 응답입니다. 요청된 위치의 현재 날씨를 나타냅니다.

필드
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

현재 강수 확률과 지난 1시간 동안 누적된 강수량입니다.

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

LookupForecastDays 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

LookupForecastDays RPC의 응답입니다.

필드
forecast_days[]

ForecastDay

요청에 지정된 일수와 페이지 크기에 따른 일일 예측 기록입니다.

time_zone

TimeZone

요청된 위치의 시간대입니다.

next_page_token

string

다음 페이지를 가져오는 토큰입니다.

LookupForecastHoursRequest

LookupForecastHours 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

LookupForecastHours RPC의 응답입니다.

필드
forecast_hours[]

ForecastHour

요청에 지정된 시간 수와 페이지 크기에 따른 시간별 예측 기록입니다.

time_zone

TimeZone

요청된 위치의 시간대입니다.

next_page_token

string

다음 페이지를 가져오는 토큰입니다.

LookupHistoryHoursRequest

LookupHistoryHours RPC 요청입니다.

필드
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

LookupHistoryHours RPC의 응답입니다.

필드
history_hours[]

HistoryHour

요청에 지정된 시간 수와 페이지 크기에 따른 시간별 기록입니다.

time_zone

TimeZone

요청된 위치의 시간대입니다.

next_page_token

string

다음 페이지를 가져오는 토큰입니다.

LookupPublicAlertsRequest

LookupPublicAlerts RPC 요청입니다.

필드
location

LatLng

필수 항목입니다. 공공 날씨 알림을 가져올 위치입니다. 서비스는 영향을 받는 지역이 이 위치와 교차하는 알림을 반환합니다.

page_size

int32

선택사항입니다. 페이지당 반환할 최대 공개 날씨 알림 레코드 수입니다.

page_token

string

선택사항입니다. 이전 LookupPublicAlerts 호출에서 수신한 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나누는 경우, LookupPublicAlerts에 제공하는 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다.

language_code

string

선택사항입니다. 클라이언트가 대답의 언어를 선택할 수 있습니다. 해당 언어의 데이터를 제공할 수 없는 경우 API는 가장 근접한 일치 항목을 사용합니다. 허용되는 값은 IETF BCP-47 표준을 따릅니다. 기본값은 'en'입니다.

LookupPublicAlertsResponse

LookupPublicAlerts RPC의 응답입니다.

필드
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

달의 위상 (즉, 달의 단계)을 표시합니다.

열거형
MOON_PHASE_UNSPECIFIED 지정되지 않은 달의 위상입니다.
NEW_MOON 달은 태양에 의해 조명되지 않습니다.
WAXING_CRESCENT 북반구에서는 오른쪽이 0~50% 밝고(🌒), 남반구에서는 왼쪽이 0~50% 밝습니다(🌘).
FIRST_QUARTER 북반구에서는 오른쪽이 50.1% 밝고(🌓), 남반구에서는 왼쪽이 50.1% 밝습니다(🌗).
WAXING_GIBBOUS 북반구에서는 오른쪽이 50~100% 조명되고(🌔), 남반구에서는 왼쪽이 50~100% 조명됩니다(🌖).
FULL_MOON 달이 완전히 빛을 받습니다.
WANING_GIBBOUS 북반구에서는 왼쪽이 50~100% 밝게 빛나고(🌖) 남반구에서는 오른쪽이 50~100% 밝게 빛납니다(🌔).
LAST_QUARTER 북반구에서는 왼쪽이 50.1% 밝고(🌗), 남반구에서는 오른쪽이 50.1% 밝습니다(🌓).
WANING_CRESCENT 북반구에서는 왼쪽이 0~50% 밝고(🌘), 남반구에서는 오른쪽이 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

특정 위치의 강수 유형을 나타냅니다.

열거형
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'로 끝나는 문자열로 형식이 지정됩니다(예: UTC보다 4시간 늦은 경우 '-14400s'

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

알림의 긴급성입니다.

게시자

알림의 게시자입니다.

열거형
PUBLISHER_UNSPECIFIED 게시자가 지정되지 않았습니다.
AUSTRALIA_ACT_ESA 오스트레일리아 오스트레일리아 수도 준주
AUSTRALIA_NSW_RFS 뉴사우스웨일스
AUSTRALIA_QLD_QFES 퀸즐랜드
AUSTRALIA_SA_CFS 사우스오스트레일리아
METEO_ALARM_AT Meteoalarm / EUMETNET 오스트리아
METEO_ALARM_BS 보스니아
BRAZIL_CENAD 브라질 재난 기관(브라질)
BRAZIL_INMET 브라질 기상청
UK_ENV_AGENCY 영국
METEO_ALARM_BG Meteoalarm / EUMETNET 불가리아
METEO_ALARM_CR 크로아티아
METEO_ALARM_CY 키프로스
METEO_ALARM_CS 체코
METEO_ALARM_DK 덴마크
EC_INAMHI 에콰도르
METEO_ALARM_FI Meteoalarm / EUMETNET 핀란드
METEO_ALARM_FR 프랑스
DE_DWD 독일
METEO_ALARM_GB Meteoalarm / EUMETNET 영국
METEO_ALARM_GR 그리스
METEO_ALARM_HU 헝가리
METEO_ALARM_IS 아이슬란드
METEO_ALARM_IE 아일랜드
METEO_ALARM_IT 이탈리아
JM_JMS 자메이카
JMA 일본
METEO_ALARM_NL Meteoalarm / EUMETNET 네덜란드
METEO_ALARM_LV 라트비아
METEO_ALARM_LT 리투아니아
METEO_ALARM_LU 룩셈부르크
MEXICO_CIRES 멕시코 멕시코 CIRES
NZ_GEONET 뉴질랜드 뉴질랜드 GeoNet
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET 북마케도니아
METEO_ALARM_NO 노르웨이
PHILIPPINES_PAGASA 필리핀
METEO_ALARM_PL Meteoalarm / EUMETNET 폴란드
METEO_ALARM_PT 포르투갈
METEO_ALARM_RO 루마니아
METEO_ALARM_RS 세르비아
SG_MSS 싱가포르
METEO_ALARM_SK Meteoalarm / EUMETNET 슬로바키아
METEO_ALARM_SI 슬로베니아
SB_MET 솔로몬 군도
METEO_ALARM_ES Meteoalarm / EUMETNET 스페인
METEO_ALARM_SE 스웨덴
METEO_ALARM_CH 스위스
TAIWAN_NCDR 대만
NOAA 미국 NOAA
WCATWC 국가 지진 해일 경보 센터

QuantitativePrecipitationForecast

특정 기간 동안 특정 지역에 누적된 예상 강수량을 나타냅니다 (참조: https://en.wikipedia.org/wiki/Quantitative_precipitation_forecast). 일반적으로 QPF로 줄여서 사용합니다.

필드
unit

Unit

누적 강수량을 측정하는 데 사용되는 단위의 코드입니다.

quantity

float

일정 기간 동안 누적된 강수량으로, 액체 물의 양으로 측정됩니다.

단위

누적 강수량을 측정하는 데 사용되는 단위를 나타냅니다.

열거형
UNIT_UNSPECIFIED 지정되지 않은 강수량 단위입니다.
MILLIMETERS 강수량은 밀리미터 단위로 측정됩니다.
INCHES 강수량은 인치 단위로 측정됩니다.

SafetyRecommendation

안전 권장사항을 나타냅니다.

필드
directive

string

사용자에게 지시합니다. 이 필드는 현지화되어야 하지만 현지화가 보장되지는 않습니다.

subtext

string

명령어의 선택적 부텍스트로, 사용자에게 추가 컨텍스트를 제공할 수 있습니다. 이 필드는 현지화되어야 하지만 현지화가 보장되지는 않습니다.

심각도

알림 메시지의 주제 이벤트의 심각도를 나타내는 코드입니다.

열거형
SEVERITY_UNKNOWN 심각도를 알 수 없습니다.
EXTREME 생명 또는 재산에 대한 심각한 위협
SEVERE 생명 또는 재산에 대한 심각한 위협
MODERATE 생명 또는 재산이 위태로울 수 있습니다.
MINOR 생명 또는 재산에 대한 경미한 위협

SpeedUnit

속도를 측정하는 데 사용되는 단위를 나타냅니다.

열거형
SPEED_UNIT_UNSPECIFIED 속도 단위가 지정되지 않았습니다.
KILOMETERS_PER_HOUR 속도는 시간당 킬로미터로 측정됩니다.
MILES_PER_HOUR 속도는 시간당 마일 단위로 측정됩니다.

SunEvents

태양과 관련된 이벤트 (예: 일출, 일몰)를 나타냅니다.

필드
sunrise_time

Timestamp

해가 뜨는 시간입니다.

참고: 일부 특수한 경우 (예: 북극권 북쪽)에는 하루 동안 일출 시간이 없을 수 있습니다. 이 경우 이 필드는 설정되지 않습니다.

sunset_time

Timestamp

해가 지는 시간입니다.

참고: 북극권과 같은 일부 특수한 경우에는 하루 종일 일몰 시간이 없을 수도 있습니다. 이 경우 이 필드는 설정되지 않습니다.

온도

온도 값을 나타냅니다.

필드
unit

TemperatureUnit

온도 값을 측정하는 데 사용되는 단위의 코드입니다.

degrees

float

지정된 단위의 온도 값 (도)입니다.

TemperatureUnit

온도를 측정하는 데 사용되는 단위를 나타냅니다.

열거형
TEMPERATURE_UNIT_UNSPECIFIED 온도 단위가 지정되지 않았습니다.
CELSIUS 온도는 섭씨로 측정됩니다.
FAHRENHEIT 온도는 화씨로 측정됩니다.

UnitsSystem

값을 측정하는 데 사용되는 단위 시스템을 나타냅니다.

열거형
UNITS_SYSTEM_UNSPECIFIED 단위 시스템이 지정되지 않았습니다.
IMPERIAL 영국식 단위 시스템 (예: 화씨, 마일 등)
METRIC 미터법 단위 시스템 (예: 섭씨, 킬로미터 등)

긴급

알림 메시지의 주제 이벤트의 긴급성을 나타내는 코드입니다.

열거형
URGENCY_UNKNOWN 긴급성을 알 수 없습니다.
IMMEDIATE 대응 조치를 즉시 취해야 합니다(SHOULD).
EXPECTED 대응 조치를 곧(다음 시간 내) 취해야 합니다(SHOULD).
FUTURE 조치를 취해야 합니다(SHOULD).
PAST 대응 조치가 더 이상 필요하지 않습니다.

공개 상태

가시성 조건, 즉 물체를 식별할 수 있는 거리를 나타냅니다.

필드
unit

Unit

거리를 측정하는 데 사용되는 단위를 나타내는 코드입니다.

distance

float

지정된 단위의 가시성 거리입니다.

단위

가시성 거리를 측정하는 데 사용되는 단위를 나타냅니다.

열거형
UNIT_UNSPECIFIED 공개 상태 단위가 지정되지 않았습니다.
KILOMETERS 가시성은 킬로미터 단위로 측정됩니다.
MILES 가시거리는 마일 단위로 측정됩니다.

WeatherCondition

특정 기간의 특정 위치에 대한 날씨 상태를 나타냅니다.

면책 조항: 날씨 아이콘과 조건 코드는 변경될 수 있습니다. Google은 필요에 따라 새 코드와 아이콘을 도입하거나 기존 코드를 업데이트할 수 있습니다. 최신 정보를 확인하려면 이 문서를 정기적으로 참고하시기 바랍니다.

필드
icon_base_uri

string

파일 형식 확장자를 포함하지 않는 아이콘의 기본 URI입니다. 아이콘을 표시하려면 원하는 경우 테마와 파일 형식 확장자 (.png 또는 .svg)를 이 URI에 추가합니다. 기본적으로 아이콘은 밝은 테마이지만 어두운 모드의 경우 _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

날씨 조건의 유형입니다.

유형

예보 요소의 컨텍스트에서 날씨 조건 유형을 표시합니다.

열거형
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

날씨 이벤트의 유형입니다.

열거형
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

풍속 값입니다.