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로 설정하면 범용 AQI가 '색인'에 포함됩니다. 필드에 포함되어야 합니다. 기본값은 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 개요를 참고하세요.