Method: forecast.days.lookup

현재 날짜부터 지정된 위치의 일일 예측을 최대 10일 동안 반환합니다.

HTTP 요청

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

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

쿼리 매개변수

매개변수
location

object (LatLng)

필수 항목입니다. 일일 일기예보를 가져올 위치입니다.
unitsSystem

enum (UnitsSystem)

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

integer

선택사항입니다. 페이지당 반환할 일일 예측 레코드의 최대 개수입니다. 1~10 (양 끝값 포함)의 값입니다. 기본값은 5입니다.
pageToken

string

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

integer

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

string

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

요청 본문

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

응답 본문

days.lookup RPC의 응답입니다.

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

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

object (ForecastDay)

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

object (TimeZone)

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

string

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

승인 범위

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

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

ForecastDay

지정된 위치의 일일 예측 레코드를 나타냅니다.

JSON 표현 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
필드
interval

object (Interval)

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

object (Date)

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

object (ForecastDayPart)

낮 시간 (현지 시간으로 오전 7시~오후 7시)의 예상 일기입니다.
nighttimeForecast

object (ForecastDayPart)

야간 (현지 시간으로 오후 7시~다음날 오전 7시)에 예상되는 날씨입니다.
maxTemperature

object (Temperature)

하루 중 최고 (높은) 기온입니다.
minTemperature

object (Temperature)

하루 중 최저 (낮은) 온도입니다.
feelsLikeMaxTemperature

object (Temperature)

하루 중 체감 온도가 가장 높은 (최고) 시간입니다.
feelsLikeMinTemperature

object (Temperature)

하루 중 최저 (낮은) 체감 온도입니다.
maxHeatIndex

object (Temperature)

하루 동안의 최대 열지수 온도입니다.
sunEvents

object (SunEvents)

태양과 관련된 이벤트 (예: 일출, 일몰)
moonEvents

object (MoonEvents)

달과 관련된 이벤트 (예: 달이 뜨는 시간, 달이 지는 시간)
iceThickness

object (IceThickness)

하루 동안 쌓인 얼음의 양입니다.

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 월과 일, 연도는 0(예: 기념일)
  • 연도만, 월과 일은 0
  • 연도와 월, 일은 0(예: 신용카드 만료일)

관련 유형:

JSON 표현 
{
  "year": integer,
  "month": integer,
  "day": integer
}
필드
year

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.
month

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.
day

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

ForecastDayPart

하루 중 특정 시간의 예측 기록을 나타냅니다.

JSON 표현 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
필드
interval

object (Interval)

이 시간대가 시작 (양 끝값 포함) 및 종료 (양 끝값 제외)되는 UTC 날짜 및 시간입니다. 참고: 하루의 일부는 현지 시간을 기준으로 오전 7시에 시작하여 같은 날 오후 7시에 종료됩니다. 예를 들어 현지 시간대가 UTC-7인 경우 주간 간격은 14:00:00.000Z 시간에 시작하여 다음 날 02:00:00.000Z에 종료되고 야간 간격은 다음 날 02:00:00.000Z에 시작하여 같은 날 14:00:00.000Z에 종료됩니다.
weatherCondition

object (WeatherCondition)

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

object (Precipitation)

예상 강수량입니다.
wind

object (Wind)

평균 풍향, 최대 속도, 돌풍입니다.
relativeHumidity

integer

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

integer

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

integer

평균적인 뇌우 발생 확률입니다.
cloudCover

integer

평균적인 구름 덮인 비율입니다.

SunEvents

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

JSON 표현 
{
  "sunriseTime": string,
  "sunsetTime": string
}
필드
sunriseTime

string (Timestamp format)

해가 뜨는 시간입니다.

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

생성된 출력은 항상 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"입니다.
sunsetTime

string (Timestamp format)

해가 지는 시간입니다.

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

생성된 출력은 항상 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"입니다.

MoonEvents

달과 관련된 이벤트 (예: 달이 뜨는 시간, 달이 지는 시간)를 나타냅니다.

JSON 표현 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
필드
moonriseTimes[]

string (Timestamp format)

달의 상단이 지평선 위로 나타나는 시간입니다 (https://en.wikipedia.org/wiki/Moonrise_and_moonset).

참고: 대부분의 경우 하루에 달이 뜨는 시간은 한 번입니다. 또는 목록이 비어 있을 수도 있습니다 (예: 달이 다음날 자정 후에 떠오르는 경우). 그러나 극지 지역과 같은 특수한 경우에는 목록에 두 개 이상의 값이 포함될 수 있습니다. 이 경우 값은 오름차순으로 정렬됩니다.

생성된 출력은 항상 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"입니다.
moonsetTimes[]

string (Timestamp format)

달의 상단이 지평선 아래로 사라지는 시간입니다 (https://en.wikipedia.org/wiki/Moonrise_and_moonset).

참고: 대부분의 경우 하루에 달이 지는 시간이 한 번입니다. 또는 목록이 비어 있을 수도 있습니다 (예: 달이 다음날 자정 후에 지평선 아래로 떨어지는 경우). 그러나 극지 지역과 같은 특수한 경우에는 목록에 두 개 이상의 값이 포함될 수 있습니다. 이 경우 값은 오름차순으로 정렬됩니다.

생성된 출력은 항상 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"입니다.
moonPhase

enum (MoonPhase)

달의 위상 (일명 달의 위상)

MoonPhase

달의 위상 (다른 이름: 음력)을 표시합니다.

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