지정된 위치의 지난 1시간부터 최대 24시간 동안의 시간별 과거 날씨 데이터를 반환합니다.
HTTP 요청
GET https://weather.googleapis.com/v1/history/hours:lookup
URL은 gRPC 트랜스코딩 구문을 사용합니다.
쿼리 매개변수
매개변수 | |
---|---|
location |
필수 항목입니다. 시간별 이전 데이터를 가져올 위치입니다. |
units |
선택사항입니다. 반환된 날씨 조건에 사용할 단위 시스템입니다. 제공하지 않으면 반환된 날씨 상태가 미터법 (기본값 = METRIC)으로 표시됩니다. |
page |
선택사항입니다. 페이지당 반환할 최대 시간별 과거 기록 수입니다. 1~24 (양 끝값 포함) 사이의 값입니다. 기본값은 허용되는 최대값인 24입니다. |
page |
선택사항입니다. 이전 요청에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하는 데 사용됩니다. |
hours |
선택사항입니다. 마지막 시간부터 가져올 총 시간의 양을 제한합니다 (1~24시간, 양 끝값 포함). 기본값은 허용되는 최대값인 24입니다. |
language |
선택사항입니다. 클라이언트가 응답의 언어를 선택할 수 있습니다. 해당 언어에 데이터를 제공할 수 없는 경우 API는 가장 근접한 언어를 사용합니다. 허용되는 값은 IETF BCP-47 표준을 따릅니다. 기본값은 'en'입니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
hours.lookup RPC의 응답입니다.
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
JSON 표현 |
---|
{ "historyHours": [ { object ( |
필드 | |
---|---|
history |
요청에 지정된 시간 수 및 페이지 크기에 따른 시간별 과거 기록입니다. |
time |
요청된 위치의 시간대입니다. |
next |
다음 페이지를 가져오는 토큰입니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/cloud-platform
HistoryHour
지정된 위치의 시간별 기록을 나타냅니다.
JSON 표현 |
---|
{ "interval": { object ( |
필드 | |
---|---|
interval |
이 이전 데이터가 유효한 1시간 간격 (UTC 시간)입니다 (타임스탬프는 가장 가까운 시간으로 내림). |
display |
이 시간별 기록이 계산된 위치의 시간대 (민간 시간)의 현지 날짜 및 시간입니다. 이 필드는 클라이언트에서 표시 목적으로 사용될 수 있습니다. 참고: 이 날짜는 연도, 월, 일, 시간, UTC 오프셋으로 구성됩니다. |
weather |
이전 날씨 상태입니다. |
temperature |
이전 온도입니다. |
feels |
요청된 위치의 체감 온도입니다. |
dew |
이전 이슬점 온도입니다. |
heat |
이전 체감 온도입니다. |
wind |
피부에 노출된 기온인 과거 체감온도입니다. |
wet |
습구 온도(과거)는 물을 증발시켜 얻을 수 있는 최저 온도입니다. |
precipitation |
과거 강수 확률 및 지난 1시간 동안 누적된 강수량입니다. |
air |
이전 기압 조건입니다. |
wind |
과거 풍속 상태 |
visibility |
이전 공개 상태입니다. |
ice |
이전의 얼음 두께입니다. |
is |
이 시간이 현지 일출 시간 (양 끝값 포함)과 일몰 시간 (양 끝값 제외) 사이인 경우 true입니다. 그렇지 않으면 야간 (일몰과 다음 일출 사이)입니다. 참고: 간격이 각각 현지 일출 시간과 일몰 시간과 교차하는 경우 이 시간은 낮 또는 밤으로 간주됩니다 (예: 간격이 오전 5시에서 오전 6시이고 일출 시간이 오전 5시 59분인 경우 isDaytime은 true). |
relative |
상대 습도의 과거 비율 (0~100)입니다. |
uv |
이전 자외선 (UV) 지수입니다. |
thunderstorm |
이전의 뇌우 발생 확률 (0~100 사이의 값)입니다. |
cloud |
구름으로 덮인 하늘의 과거 비율 (0~100)입니다. |