Method: currentConditions.lookup

현재 상태 엔드포인트는 100개가 넘는 국가의 시간별 공기질 정보를 최대 500x500m 해상도로 제공합니다. 70개가 넘는 지역 지수와 전 세계 공기질 지수 및 카테고리가 포함됩니다.

HTTP 요청

POST https://airquality.googleapis.com/v1/currentConditions:lookup

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

요청 본문

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

JSON 표현 
{
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "universalAqi": boolean,
  "languageCode": string
}
필드
location

object (LatLng)

필수 항목입니다. API에서 현재 공기질 상태 데이터를 찾는 경도 및 위도입니다.
extraComputations[]

enum (ExtraComputation)

선택사항입니다. 선택적으로 사용 설정할 수 있는 추가 기능입니다. 추가 계산을 지정하면 관련 요소와 필드가 응답에 반환됩니다.
uaqiColorPalette

enum (ColorPalette)

선택사항입니다. '세계 공기질 지수' (UAQI)에서 제공하는 데이터에 사용되는 색상 팔레트를 결정합니다. 이 색상 팔레트는 UAQI에만 적용되며 다른 AQI에는 제어할 수 없는 사전 정의된 색상 팔레트가 있습니다.
customLocalAqis[]

object (CustomLocalAqi)

선택사항입니다. '국가/지역과 AQI 간의' 관계를 표현합니다. 선택한 AQI에 따라 해당 국가/지역에 필요한 공기질 데이터가 표시되도록 국가/지역을 원하는 AQI와 연결합니다. 이 매개변수는 특정 국가의 기본이 아닌 AQI를 지정하는 데 사용할 수 있습니다. 예를 들어 캐나다의 기본 지수가 아닌 캐나다에 대한 미국 EPA 지수를 가져올 수 있습니다.
universalAqi

boolean

선택사항입니다. true로 설정하면 Universal AQI가 응답의 'indexes' 필드에 포함됩니다. 기본값은 true입니다.
languageCode

string

선택사항입니다. 클라이언트가 응답의 언어를 선택하도록 허용합니다. 해당 언어에 대한 데이터가 제공되지 않는 경우 API는 가장 근접한 일치를 사용합니다. 허용되는 값은 IETF 표준을 따릅니다. 기본값은 en입니다.

응답 본문

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

JSON 표현 
{
  "dateTime": string,
  "regionCode": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
필드
dateTime

string (Timestamp format)

RFC3339 UTC 'Zulu' 형식의 내림된 타임스탬프로 나노초 단위의 분해이며 최대 9자리의 소수 자리까지 가능합니다. 예: '2014-10-02T15:00:00Z'
regionCode

string

요청에서 제공된 위치에 해당하는 국가/지역의 ISO_3166-1 alpha-2 코드입니다. 요청에 제공된 위치가 분쟁 지역 내에 있는 경우 응답에서 이 필드가 생략될 수 있습니다.
indexes[]

object (AirQualityIndex)

요청 매개변수에 따라 이 목록에는 최대 2개의 공기질 지수가 포함됩니다.

  • 범용 AQI. UniversalAqi 부울이 true로 설정된 경우 반환됩니다.
  • 지역 AQI. LOCAL_AQI 추가 계산이 지정되면 반환됩니다.
pollutants[]

object (Pollutant)

요청에 지정된 위치에 영향을 미치는 오염 물질 목록입니다. 참고: 이 필드는 POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION 추가 계산 중 하나 이상을 지정한 요청에만 반환됩니다.
healthRecommendations

object (HealthRecommendations)

보고된 공기질 상태와 관련된 건강 자문 및 권장 조치입니다. 추천은 위험군, 오염 물질에 민감한 그룹, 일반 대중에 따라 다르게 맞춤화됩니다.

승인 범위

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

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.