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