Method: forecast.hours.lookup

현재 시간부터 시작하여 지정된 위치의 시간별 예측을 최대 240시간까지 반환합니다.

HTTP 요청

GET https://weather.googleapis.com/v1/forecast/hours:lookup

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
location

object (LatLng)

필수 항목입니다. 시간별 예보를 가져올 위치입니다.
unitsSystem

enum (UnitsSystem)

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

integer

선택사항입니다. 페이지당 반환할 최대 시간별 예측 레코드 수입니다. 1~24 (양 끝값 포함) 사이의 값입니다. 기본값은 허용되는 최대값인 24입니다.
pageToken

string

선택사항입니다. 이전 요청에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하는 데 사용됩니다.
hours

integer

선택사항입니다. 현재 시간부터 가져올 총 시간의 양을 제한합니다. 1~240 (양 끝값 포함) 사이의 값입니다. 기본값은 허용되는 최대값인 240입니다.
languageCode

string

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

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

hours.lookup RPC의 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
필드
forecastHours[]

object (ForecastHour)

요청에 지정된 시간 수 및 페이지 크기에 따른 시간별 예측 레코드입니다.
timeZone

object (TimeZone)

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

string

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

승인 범위

다음 OAuth 범위가 필요합니다.

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

ForecastHour

지정된 위치의 시간별 예보 레코드를 나타냅니다.

JSON 표현 
{
  "interval": {
    object (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
필드
interval

object (Interval)

이 예측 데이터가 유효한 1시간 간격 (UTC 시간)입니다 (타임스탬프는 가장 가까운 시간으로 반올림됨).
displayDateTime

object (DateTime)

이 시간별 예보가 계산되는 위치의 시간대 (민간 시간)의 현지 날짜 및 시간입니다. 이 필드는 클라이언트에서 표시 목적으로 사용될 수 있습니다. 참고: 이 날짜는 연도, 월, 일, 시간, UTC 오프셋으로 구성됩니다.
weatherCondition

object (WeatherCondition)

예측된 날씨 조건입니다.
temperature

object (Temperature)

예측된 온도입니다.
feelsLikeTemperature

object (Temperature)

요청된 위치의 체감 온도입니다.
dewPoint

object (Temperature)

예측된 이슬점 온도입니다.
heatIndex

object (Temperature)

예측된 체감 온도입니다.
windChill

object (Temperature)

피부에 노출되는 예측된 체감온도입니다.
wetBulbTemperature

object (Temperature)

예측된 습구 온도입니다. 물을 증발시켜 얻을 수 있는 최저 온도입니다.
precipitation

object (Precipitation)

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

object (AirPressure)

예측된 기압 조건입니다.
wind

object (Wind)

예측된 풍속입니다.
visibility

object (Visibility)

예상 노출 가능성입니다.
iceThickness

object (IceThickness)

예측된 얼음 두께입니다.
isDaytime

boolean

이 시간이 현지 일출 시간 (양 끝값 포함)과 일몰 시간 (양 끝값 제외) 사이인 경우 true입니다. 그렇지 않으면 야간 (일몰과 다음 일출 사이)입니다. 참고: 간격이 각각 현지 일출 시간과 일몰 시간과 교차하는 경우 이 시간은 낮 또는 밤으로 간주됩니다 (예: 간격이 오전 5시에서 오전 6시이고 일출 시간이 오전 5시 59분인 경우 isDaytime은 true).
relativeHumidity

integer

예측된 상대 습도 비율 (0~100 사이의 값)입니다.
uvIndex

integer

예측된 자외선 (UV) 지수입니다.
thunderstormProbability

integer

예측된 뇌우 확률 (0~100)입니다.
cloudCover

integer

구름으로 덮일 것으로 예측되는 하늘의 비율 (0~100)입니다.