Method: lookupWeather

위치의 기상 상황을 검색합니다.

HTTP 요청

POST https://mapstools.googleapis.com/v1:lookupWeather

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

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
필드
unitsSystem

enum (UnitsSystem)

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

object (Location)

필수 항목입니다. 기상 조건을 가져올 위치입니다.
capabilities[]

enum (Capability)

선택사항입니다. 응답에 포함할 환경 기능입니다.
date

object (Date)

선택사항입니다. location 필드에 지정된 위치의 현지 시간대를 기준으로 요청된 환경 정보의 날짜를 지정합니다. 지원되는 기간은 요청된 기능에 따라 다릅니다. - WEATHER: 과거 최대 24시간(hour도 설정된 경우) 및 미래 최대 10일(240시간)(일일 예측의 경우 오늘부터 +9일) - AIR_QUALITY: 과거 최대 30일(720시간) 및 미래 최대 4일(96시간) - POLLEN: 오늘부터 +4일(오늘을 포함하여 최대 5일, 이전 날짜는 지원되지 않음)
hour

integer

선택사항입니다. 요청된 환경 정보의 시간을 location 필드에 지정된 위치의 현지 시간대를 기준으로 24시간 형식(0~23)으로 지정합니다. date을 지정해야 합니다. 지원되는 시간별 범위는 요청된 기능에 따라 다릅니다. - WEATHER: 과거 최대 24시간, 미래 최대 240시간(10일) - AIR_QUALITY: 과거 최대 30일(720시간) 및 미래 최대 4일(96시간) POLLEN: 일일 예측만 반환합니다. 꽃가루의 경우 hour가 무시됩니다.
languageCode

string

선택사항입니다. 응답에서 현지화된 텍스트의 BCP-47 언어 코드입니다(예: 'en', 'ja', 'fr-CA'). 지정하지 않을 경우 기본값은 'en'입니다.
weatherOptions

object (WeatherOptions)

선택사항입니다. 날씨 요청과 관련된 옵션입니다. weatherOptions.units_system는 기존 호출자의 이전 버전과의 호환성을 유지하기 위해 최상위 unitsSystem(태그 4)과 함께 지원됩니다. 둘 다 충돌하는 단위 시스템을 지정하면 INVALID_ARGUMENT를 반환합니다. WEATHER가 capabilities에서 요청되지 않으면 무시됩니다.
airQualityOptions

object (AirQualityOptions)

선택사항입니다. 공기질 요청과 관련된 옵션입니다. AIR_QUALITY가 capabilities에서 요청되지 않으면 무시됩니다.

응답 본문

성공한 경우 응답 본문에 LookupWeatherResponse의 인스턴스가 포함됩니다.

승인 범위

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

  • https://www.googleapis.com/auth/maps-platform.mapstools