Method: currentConditions.lookup

특정 위치의 현재 기상 조건을 반환합니다.

HTTP 요청

GET https://weather.googleapis.com/v1/currentConditions:lookup

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

쿼리 매개변수

매개변수
location

object (LatLng)

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

enum (UnitsSystem)

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

string

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

요청 본문

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

응답 본문

currentConditions.lookup RPC에 대한 응답 - 요청된 위치의 현재 기상 조건을 나타냅니다.

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

JSON 표현 
{
  "currentTime": string,
  "timeZone": {
    object (TimeZone)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "currentConditionsHistory": {
    object (CurrentConditionsHistory)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
필드
currentTime

string (Timestamp format)

반환된 데이터와 연결된 현재 시간(UTC)입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
timeZone

object (TimeZone)

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

object (WeatherCondition)

현재 날씨 상태입니다.
temperature

object (Temperature)

현재 온도
feelsLikeTemperature

object (Temperature)

요청된 위치에서 현재 체감 온도를 측정한 값입니다.
dewPoint

object (Temperature)

현재 이슬점 온도입니다.
heatIndex

object (Temperature)

현재 열 지수 온도입니다.
windChill

object (Temperature)

현재 체감 온도, 피부에 노출되는 기온입니다.

참고: 이 필드는 대한민국과 일본의 위치에 대해 빈 객체를 반환합니다.
precipitation

object (Precipitation)

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

object (AirPressure)

현재 기압 상태입니다.
wind

object (Wind)

현재 풍속입니다.
visibility

object (Visibility)

현재 공개 상태입니다.

참고: 이 필드는 대한민국과 일본의 위치에 대해 빈 객체를 반환합니다.
currentConditionsHistory

object (CurrentConditionsHistory)

지난 24시간 동안의 현재 상태 변화입니다.
isDaytime

boolean

요청된 위치의 현재 시간이 현지 일출(포함)과 일몰(제외) 시간 사이인 경우 true입니다. 그렇지 않으면 밤(일몰과 다음 일출 사이)입니다.
relativeHumidity

integer

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

integer

현재 자외선(UV) 지수입니다.
thunderstormProbability

integer

현재 뇌우 확률입니다(0~100 사이의 값).

참고: 이 필드는 대한민국 및 일본의 위치에 대한 응답에서 생략됩니다.
cloudCover

integer

현재 구름으로 덮인 하늘의 비율(0~100)입니다.

참고: 이 필드는 대한민국 및 일본의 위치에 대한 응답에서 생략됩니다.

승인 범위

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

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

CurrentConditionsHistory

지난 24시간 동안의 현재 상태 변경사항 집합을 나타냅니다.

JSON 표현 
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
필드
temperatureChange

object (Temperature)

현재 온도에서 24시간 전 온도를 뺀 값입니다.
maxTemperature

object (Temperature)

지난 24시간 동안의 최고 온도입니다.
minTemperature

object (Temperature)

지난 24시간 동안의 최저 온도입니다.
snowQpf

object (QuantitativePrecipitationForecast)

녹거나 압축되지 않는다고 가정할 때 일정 기간 동안 내릴 것으로 예상되는 눈의 양입니다. 참고: 이는 실제 강설량이며 액체 상태의 물로 환산한 값이 아닙니다. QPF는 정량적 강수량 예측의 약어입니다(자세한 내용은 QuantitativePrecipitationForecast 정의 참고).
qpf

object (QuantitativePrecipitationForecast)

일정 기간 동안 내릴 것으로 예상되는 모든 강수량(비, 눈, 얼음 등)의 총 액체 수량입니다. 참고: QPF는 정량적 강수량 예측의 약어입니다. 자세한 내용은 QuantitativePrecipitationForecast 정의를 참고하세요.