색인
AirQuality
(인터페이스)AirQualityIndex
(메시지)ColorPalette
(열거형)CustomLocalAqi
(메시지)ExtraComputation
(열거형)HealthRecommendations
(메시지)LookupCurrentConditionsRequest
(메시지)LookupCurrentConditionsResponse
(메시지)LookupForecastRequest
(메시지)LookupForecastResponse
(메시지)LookupForecastResponse.HourlyForecast
(메시지)LookupHeatmapTileRequest
(메시지)LookupHistoryRequest
(메시지)LookupHistoryResponse
(메시지)LookupHistoryResponse.HourInfo
(메시지)MapType
(열거형)Pollutant
(메시지)Pollutant.AdditionalInfo
(메시지)Pollutant.Concentration
(메시지)Pollutant.Concentration.Unit
(열거형)
AirQuality
공기질 서비스.
LookupCurrentConditions |
---|
현재 조건 엔드포인트는 100개가 넘는 국가에서 최대 500x500m 해상도로 시간당 공기질 정보를 제공합니다. 70개 이상의 지역 지수와 전 세계 공기질 지수 및 카테고리를 포함합니다.
|
LookupForecast |
---|
지정된 기간 동안 특정 위치의 공기질 예보를 반환합니다.
|
LookupHeatmapTile |
---|
타일 PNG 이미지의 데이터를 포함하는 바이트 배열을 반환합니다.
|
LookupHistory |
---|
지정된 기간 동안 특정 위치의 공기질 기록을 반환합니다.
|
AirQualityIndex
다양한 공기질 측정항목을 나타내는 기본 객체입니다. 이러한 측정항목을 모두 종합하면 현재 공기질 상태에 대한 개요를 얻을 수 있습니다. 전 세계적으로 다양한 목적과 공기질의 다양한 측면을 측정하는 데 관심이 있는 여러 지수가 존재합니다.
입력란 | |
---|---|
code |
색인의 코드 이 필드는 프로그래밍 목적의 색인을 나타내며 공백 대신 스네이크 표기법을 사용합니다. 예: 'uaqi', 'fra_atmo' |
display_name |
사람이 읽을 수 있는 색인 이름입니다. 예: 'AQI (US)' |
aqi_display |
색인 숫자 점수의 텍스트 표현으로, 일반적으로 최악의 색인 점수를 나타내는 접두사 또는 접미사 기호를 포함할 수 있습니다. 예: >100 또는 10+. 참고: 이 필드는 색인 점수를 표시할 때 사용해야 합니다. 숫자가 아닌 색인의 경우 이 필드는 비어 있습니다. |
color |
AQI 숫자 점수를 나타내는 데 사용되는 색상입니다. |
category |
색인 숫자 점수 해석의 텍스트 분류입니다. 예: '매우 좋음' |
dominant_pollutant |
주요 오염 물질의 화학 기호입니다. 예: 'CO'. |
aqi |
색인의 숫자 점수입니다. 예: 10, 100 이 값은 정규화되지 않으며 관련 공기질 지수의 맥락에서만 해석되어야 합니다. 숫자가 아닌 색인의 경우 이 필드는 반환되지 않습니다. 참고: 이 필드는 계산, 그래프 표시 등에 사용해야 합니다. 색인 점수를 표시하려면 AQI 디스플레이 필드를 사용해야 합니다. |
ColorPalette
'세계 공기질 지수' (UAQI)에서 제공하는 데이터에 사용되는 색상 팔레트를 결정합니다. 이 색상 팔레트는 UAQI에만 적용되며 다른 AQI에는 제어할 수 없는 사전 정의된 색상 팔레트가 있습니다.
열거형 | |
---|---|
COLOR_PALETTE_UNSPECIFIED |
기본값입니다. 매개변수로 전달되는 경우 무시됩니다. |
RED_GREEN |
빨간색/초록색 팔레트를 사용할지 결정합니다. |
INDIGO_PERSIAN_DARK |
남색/페르시아 팔레트 (어두운 테마) 사용 여부를 결정합니다. |
INDIGO_PERSIAN_LIGHT |
남색/페르시아 팔레트 (밝은 테마) 사용 여부를 결정합니다. |
CustomLocalAqi
'국가/지역과 AQI' 관계를 표현합니다. 선택한 AQI에 따라 해당 국가/지역에 필요한 공기질 데이터가 표시되도록 국가/지역을 원하는 AQI와 페어링합니다.
입력란 | |
---|---|
region_code |
맞춤 AQI가 필요한 국가/지역입니다. 값은 ISO 3166-1 alpha-2 코드를 사용하여 제공해야 합니다. |
aqi |
국가/지역과 연결할 AQI입니다. 값은 유효한 색인 코드여야 합니다. |
ExtraComputation
선택적으로 사용 설정할 수 있는 추가 기능입니다. 추가 계산을 지정하면 관련 요소와 필드가 응답에 반환됩니다.
열거형 | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
기본값입니다. 매개변수로 전달되는 경우 서버에서 이를 무시합니다. |
LOCAL_AQI |
요청된 위치 (국가)의 지역 (국가) AQI를 응답에 포함할지 여부를 결정합니다. 지정된 경우 응답에 해당 위치의 현지 AQI에 관한 모든 관련 데이터가 포함된 'air_quality_index' 데이터 구조가 포함됩니다. |
HEALTH_RECOMMENDATIONS |
응답에 현재 AQI 상태에 대한 건강 관련 조언 및 권장 조치를 포함할지 여부를 결정합니다. 이 권장 사항은 일반 대중보다 오염에 더 민감한 일반 대중과 위험 그룹 6개를 대상으로 합니다. 지정된 경우 관련 데이터를 사용할 수 있을 때 응답에 |
POLLUTANT_ADDITIONAL_INFO |
각 오염 물질의 추가 정보를 응답에 포함할지 여부를 결정합니다. 지정된 경우 데이터를 사용할 수 있을 때 '색인' 필드 응답에 포함된 각 공기질 지수 객체에 |
DOMINANT_POLLUTANT_CONCENTRATION |
전 세계 또는 지역 지수에 따라 측정된 주요 오염 물질의 농도를 응답에 포함할지 결정합니다. 요청이 글로벌 AQI와 로컬 AQI를 모두 지정한 경우 최대 2개의 오염 코드가 반환될 수 있습니다. 지정된 경우 데이터를 사용할 수 있을 때 '오염 물질' 목록에 포함된 주요 오염 물질 객체에는 |
POLLUTANT_CONCENTRATION |
글로벌 또는 지역 지수에 따라 사용 가능한 측정값과 함께 모든 오염 물질의 농도를 응답에 포함할지 결정합니다. 지정된 경우 응답의 '오염 물질' 필드에 포함된 각 오염 물질 객체는 데이터를 사용할 수 있을 때 |
HealthRecommendations
다양한 인구 집단에 대한 무료 텍스트 형식의 보건 권장사항 권장값은 관련 공기질 상태를 토대로 산출됩니다.
입력란 | |
---|---|
general_population |
특정 민감도는 없습니다. |
elderly |
은퇴자 및 일반 대중보다 높은 노인 |
lung_disease_population |
호흡기 관련 문제 및 천식이 있습니다. |
heart_disease_population |
심장 및 순환계 질환입니다. |
athletes |
스포츠 및 기타 격렬한 야외 활동. |
pregnant_women |
모든 임신 단계의 여성입니다. |
children |
아동, 유아, 영아를 포함한 저학년 아동 |
LookupCurrentConditionsRequest
공기질 현재 상태의 요청 정의입니다.
입력란 | |
---|---|
location |
필수 항목입니다. API가 공기질 현재 상태 데이터를 찾는 경도 및 위도입니다. |
extra_computations[] |
선택사항입니다. 선택적으로 사용 설정할 수 있는 추가 기능입니다. 추가 계산을 지정하면 관련 요소와 필드가 응답에 반환됩니다. |
uaqi_color_palette |
선택사항입니다. '세계 공기질 지수' (UAQI)에서 제공하는 데이터에 사용되는 색상 팔레트를 결정합니다. 이 색상 팔레트는 UAQI에만 적용되며 다른 AQI에는 제어할 수 없는 사전 정의된 색상 팔레트가 있습니다. |
custom_local_aqis[] |
선택사항입니다. '국가/지역과 AQI' 관계를 표현합니다. 선택한 AQI에 따라 해당 국가/지역에 필요한 공기질 데이터가 표시되도록 국가/지역을 원하는 AQI와 페어링합니다. 이 매개변수는 특정 국가의 기본 AQI가 아닌 AQI를 지정하는 데 사용할 수 있습니다. 예를 들어 캐나다의 기본 지수가 아닌 캐나다의 미국 EPA 지수를 가져올 수 있습니다. |
universal_aqi |
선택사항입니다. true로 설정하면 Universal AQI가 응답의 'indexes' 필드에 포함됩니다. 기본값은 true입니다. |
language_code |
선택사항입니다. 클라이언트가 응답의 언어를 선택할 수 있도록 합니다. 해당 언어에 대한 데이터를 제공할 수 없는 경우 API는 가장 근접한 일치 항목을 사용합니다. 허용되는 값은 IETF 표준을 따릅니다. 기본값은 en입니다. |
LookupCurrentConditionsResponse
입력란 | |
---|---|
date_time |
RFC3339 UTC 'Zulu' 형식으로 내림된 타임스탬프로, 나노초 단위의 분해 최대 9자리 소수입니다. 예: '2014-10-02T15:00:00Z' |
region_code |
요청에서 제공한 위치에 해당하는 국가/지역의 ISO_3166-1 alpha-2 코드입니다. 요청에 제공된 위치가 분쟁 지역 내에 있는 경우 응답에서 이 필드가 생략될 수 있습니다. |
indexes[] |
요청 매개변수에 따라 이 목록에는 최대 2개의 공기질 지수가 포함됩니다.
|
pollutants[] |
요청에 지정된 위치에 영향을 미치는 오염 물질 목록입니다. 참고: 이 필드는 POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION 중 하나 이상을 지정한 요청에만 반환됩니다. |
health_recommendations |
보고된 공기질 상태와 관련된 건강을 위한 조언 및 권장 조치입니다. 권장값은 오염원에 민감한 집단, 일반 대중에 따라 다르게 조정됩니다. |
LookupForecastRequest
공기질 예보 API의 요청 객체입니다.
입력란 | |
---|---|
location |
필수 항목입니다. API가 공기질 데이터를 찾는 위도와 경도입니다. |
extra_computations[] |
선택사항입니다. 선택적으로 사용 설정할 수 있는 추가 기능입니다. 추가 계산을 지정하면 관련 요소와 필드가 응답에 반환됩니다. |
uaqi_color_palette |
선택사항입니다. '세계 공기질 지수' (UAQI)에서 제공하는 데이터에 사용되는 색상 팔레트를 결정합니다. 이 색상 팔레트는 UAQI에만 적용되며 다른 AQI에는 제어할 수 없는 사전 정의된 색상 팔레트가 있습니다. |
custom_local_aqis[] |
선택사항입니다. '국가/지역과 AQI' 관계를 표현합니다. 선택한 AQI에 따라 해당 국가/지역에 필요한 공기질 데이터가 표시되도록 국가/지역을 원하는 AQI와 페어링합니다. 이 매개변수는 특정 국가의 기본 AQI가 아닌 AQI를 지정하는 데 사용할 수 있습니다. 예를 들어 캐나다의 기본 지수가 아닌 캐나다의 미국 EPA 지수를 가져올 수 있습니다. |
page_size |
선택사항입니다. 페이지당 반환할 시간별 정보 레코드의 최대 개수입니다 (기본값 = 24). |
page_token |
선택사항입니다. 이전 예측 호출에서 수신된 페이지 토큰입니다. 이후 페이지를 검색하는 데 사용됩니다. |
통합 필드 time_range . 필수 공기질 예보 데이터의 기간입니다. 범위는 앞으로 1시간 이상 반올림되어야 합니다. 이 필드를 지정하지 않으면 INVALID_ARGUMENT 오류가 발생합니다. time_range 은 다음 중 하나여야 합니다. |
|
date_time |
특정 시점의 데이터를 반환할 타임스탬프입니다. 타임스탬프는 정확한 이전 시간으로 반올림됩니다. 참고: 요청된 타임스탬프에 대해서만 시간별 데이터 (즉, 단일 시간별 정보 요소)를 반환합니다. 예를 들어 date_time 매개변수가 2023-01-03T11:05:49Z로 설정된 상태로 전송된 요청은 2023-01-03T11:00:00Z로 반내림됩니다. |
period |
예측 데이터를 가져올 시작 기간과 종료 기간을 나타냅니다. 타임스탬프는 정확한 이전 시간으로 반올림됩니다. |
universal_aqi |
선택사항입니다. true로 설정하면 Universal AQI가 응답의 'indexes' 필드에 포함됩니다 (기본값 = true). |
language_code |
선택사항입니다. 클라이언트가 응답의 언어를 선택할 수 있도록 합니다. 해당 언어에 대한 데이터를 제공할 수 없는 경우 API는 가장 근접한 일치 항목을 사용합니다. 허용되는 값은 IETF 표준 (기본값 = 'en')을 따릅니다. |
LookupForecastResponse
공기질 예보 API의 응답 객체입니다.
입력란 | |
---|---|
hourly_forecasts[] |
선택사항입니다. 요청한 범위의 시간별 공기질 정보가 포함됩니다. 예를 들어 48시간 동안의 예측에 대한 요청인 경우 48개의 시간별 예측 요소가 있습니다. |
region_code |
선택사항입니다. 요청에서 제공한 위치에 해당하는 국가/지역의 ISO_3166-1 alpha-2 코드입니다. 요청에 제공된 위치가 분쟁 지역 내에 있는 경우 응답에서 이 필드가 생략될 수 있습니다. |
next_page_token |
선택사항입니다. 다음 페이지를 검색하는 토큰입니다. |
HourlyForecast
요청한 범위의 시간별 공기질 정보가 포함됩니다. 예를 들어 48시간 동안의 예측에 대한 요청인 경우 48개의 시간별 예측 요소가 있습니다.
입력란 | |
---|---|
date_time |
데이터가 참조하는 시간 (시간)을 RFC3339 UTC 'Zulu' 형식으로 나타내는 내림된 타임스탬프입니다. 예: '2014-10-02T15:00:00Z' |
indexes[] |
요청 매개변수에 따라 이 목록에는 최대 2개의 공기질 지수가 포함됩니다.
|
pollutants[] |
요청에 지정된 위치에 영향을 미치는 오염 물질 목록입니다. 참고: 이 필드는 POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION 중 하나 이상을 지정한 요청에만 반환됩니다. |
health_recommendations |
보고된 공기질 상태와 관련된 건강을 위한 조언 및 권장 조치입니다. 권장값은 오염원에 민감한 집단, 일반 대중에 따라 다르게 조정됩니다. |
LookupHeatmapTileRequest
히트맵 타일 요청입니다.
구조는 표준 타일 서버 GET 호출(예: https://airquality.googleapis.com/v1/mapTypes/{map_type}/heatmapTiles/{zoom}/{x}/{y})을 준수합니다.
예: https://airquality.googleapis.com/v1/mapTypes/BAQI_INDIGO_PERSIAN/heatmapTiles/1/1/1
입력란 | |
---|---|
map_type |
필수 항목입니다. 공기질 히트맵의 유형입니다. 지도에 그래픽으로 나타낼 오염 물질을 정의합니다.
|
zoom |
필수 항목입니다. 지도의 확대/축소 수준입니다. 지도 콘텐츠에 지도 콘텐츠가 표시되는 정도를 정의합니다. 확대/축소 수준 0은 타일 하나에 전 세계를 표시합니다. 확대/축소 수준 1은 전 세계를 타일 4개로 나눈 것입니다. 확대/축소 수준 2는 전 세계를 16개 타일로 표시한 것입니다. 확대/축소 수준 16은 전 세계를 나타내는 타일 65,536개입니다. 허용되는 값: 0~16 |
x |
필수 항목입니다. 요청된 타일의 동서 지점을 정의합니다. |
y |
필수 항목입니다. 요청된 타일의 북남점을 정의합니다. |
LookupHistoryRequest
공기질 기록 API의 요청 객체입니다.
입력란 | |
---|---|
page_size |
선택사항입니다. 페이지당 반환할 시간별 정보 레코드의 최대 개수입니다. 기본값은 72이고 최댓값은 168입니다 (7일간의 데이터). |
page_token |
선택사항입니다. 이전 기록 호출에서 수신된 페이지 토큰입니다. 이후 페이지를 검색하는 데 사용됩니다. 이 매개변수의 값을 제공할 때 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출 (이전 호출)과 일치해야 합니다. |
location |
필수 항목입니다. API가 공기질 기록 데이터를 찾는 위도와 경도입니다. |
extra_computations[] |
선택사항입니다. 선택적으로 사용 설정할 수 있는 추가 기능입니다. 추가 계산을 지정하면 관련 요소와 필드가 응답에 반환됩니다. |
uaqi_color_palette |
선택사항입니다. '세계 공기질 지수' (UAQI)에서 제공하는 데이터에 사용되는 색상 팔레트를 결정합니다. 이 색상 팔레트는 UAQI에만 적용되며 다른 AQI에는 제어할 수 없는 사전 정의된 색상 팔레트가 있습니다. |
custom_local_aqis[] |
선택사항입니다. '국가/지역과 AQI' 관계를 표현합니다. 선택한 AQI에 따라 해당 국가/지역에 필요한 공기질 데이터가 표시되도록 국가/지역을 원하는 AQI와 페어링합니다. 이 매개변수는 특정 국가의 기본 AQI가 아닌 AQI를 지정하는 데 사용할 수 있습니다. 예를 들어 캐나다의 기본 지수가 아닌 캐나다의 미국 EPA 지수를 가져올 수 있습니다. |
통합 필드 time_range . 필요한 공기질 데이터의 기간입니다. 기간 관련 필드를 지정하지 않으면 INVALID_ARGUMENT 오류가 발생합니다. time_range는 다음 중 하나여야 합니다. time_range 는 다음 중 하나여야 합니다. |
|
date_time |
이전 데이터를 반환할 타임스탬프입니다. 타임스탬프는 정확한 이전 시간으로 반올림됩니다. 참고: 요청된 타임스탬프에 대해서만 시간별 데이터 (즉, 단일 시간별 정보 요소)를 반환합니다. 예를 들어 dateTime 매개변수가 2023-01-03T11:05:49Z로 설정된 상태로 전송된 요청은 2023-01-03T11:00:00Z로 반내림됩니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예: '2014-10-02T15:01:23Z' 및 '2014-10-02T15:01:23.045123456Z' |
hours |
요청의 시간 범위를 나타내는 1에서 720 사이의 숫자입니다. 예를 들어 값 48은 지난 48시간 동안의 데이터를 생성합니다. |
period |
이전 데이터를 가져올 시작 및 종료 기간을 나타냅니다. 타임스탬프는 정확한 이전 시간으로 반올림됩니다. |
universal_aqi |
선택사항입니다. true로 설정하면 Universal AQI가 응답의 'indexes' 필드에 포함됩니다. 기본값은 true입니다. |
language_code |
선택사항입니다. 클라이언트가 응답의 언어를 선택할 수 있도록 합니다. 해당 언어에 대한 데이터를 제공할 수 없는 경우 API는 가장 근접한 일치 항목을 사용합니다. 허용되는 값은 IETF 표준을 따릅니다. 기본값은 en입니다. |
LookupHistoryResponse
입력란 | |
---|---|
hours_info[] |
선택사항입니다. 요청한 범위의 시간별 공기질 정보가 포함됩니다. 예를 들어 48시간 동안의 기록에 대한 요청인 경우 시간별 정보 요소는 48개입니다. |
region_code |
선택사항입니다. 요청에서 제공한 위치에 해당하는 국가/지역의 ISO_3166-1 alpha-2 코드입니다. 요청에 제공된 위치가 분쟁 지역 내에 있는 경우 응답에서 이 필드가 생략될 수 있습니다. |
next_page_token |
선택사항입니다. 다음 페이지를 검색하는 토큰입니다. |
HourInfo
요청한 범위의 시간별 공기질 정보가 포함됩니다. 예를 들어 48시간 동안의 기록에 대한 요청인 경우 시간별 정보 요소는 48개입니다.
입력란 | |
---|---|
date_time |
데이터가 참조하는 시간을 RFC3339 UTC 'Zulu' 형식으로 나타내는 내림된 타임스탬프로 나노초 분해이며 최대 9자리 소수입니다. 예: '2014-10-02T15:00:00Z' |
indexes[] |
요청 매개변수에 따라 이 목록에는 최대 2개의 공기질 지수가 포함됩니다.
|
pollutants[] |
요청에 지정된 위치에 영향을 미치는 오염 물질 목록입니다. 참고: 이 필드는 POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION 중 하나 이상을 지정한 요청에만 반환됩니다. |
health_recommendations |
보고된 공기질 상태와 관련된 건강을 위한 조언 및 권장 조치입니다. 권장값은 오염원에 민감한 집단, 일반 대중에 따라 다르게 조정됩니다. |
MapType
공기질 히트맵의 유형입니다. 지도에 그래픽으로 나타낼 오염 물질을 정의합니다.
열거형 | |
---|---|
MAP_TYPE_UNSPECIFIED |
기본값입니다. 매개변수로 전달되는 경우 서버에서 이를 무시합니다. |
UAQI_RED_GREEN |
세계 공기질 지수 붉은색과 초록색 팔레트입니다. |
UAQI_INDIGO_PERSIAN |
국제 공기질 지수(검은색 페르시아) 팔레트입니다. |
PM25_INDIGO_PERSIAN |
초미세먼지(PM2.5) 지수 팔레트. |
GBR_DEFRA |
일일 공기질 지수 (영국) 색상 팔레트입니다. |
DEU_UBA |
독일 지역 공기질 지수 색상 팔레트입니다. |
CAN_EC |
캐나다 공기질 건강 지수 색상 팔레트입니다. |
FRA_ATMO |
프랑스 공기질 지수 색상 팔레트입니다. |
US_AQI |
미국 공기질 지수 색상 팔레트입니다. |
오염 물질
공기질 오염 물질 관련 데이터입니다.
입력란 | |
---|---|
code |
오염 물질의 코드 이름입니다. 예: 'so2'. 사용 가능한 모든 코드의 목록은 여기에서 확인할 수 있습니다. |
display_name |
오염 물질의 표시 이름입니다. 예: 'NOx' |
full_name |
오염 물질의 전체 이름입니다. 화합물의 경우에는 IUPAC 이름입니다. 예: '이산화황'. IUPAC 이름 표에 대한 자세한 내용은 https://iupac.org/what-we-do/periodic-table-of-elements/를 참고하세요. |
concentration |
표준 대기 오염 측정 단위 중 하나로 측정한 오염 물질 농도 수준입니다. |
additional_info |
오염 물질에 관한 추가 정보입니다. |
AdditionalInfo
특정 오염 물질이 배출원 및 건강에 미치는 영향입니다.
입력란 | |
---|---|
sources |
오염 물질의 주요 배출원을 나타내는 텍스트입니다. |
effects |
오염 물질이 건강에 미치는 주요 영향을 나타내는 텍스트입니다. |
농도
공기 중 특정 오염 물질의 농도입니다.
입력란 | |
---|---|
units |
이 오염 농도를 측정하는 단위입니다. |
value |
오염 농도 값 |
단위
오염 물질 농도를 측정하는 데 사용되는 단위를 정의합니다.
열거형 | |
---|---|
UNIT_UNSPECIFIED |
농도 단위가 지정되지 않았습니다. |
PARTS_PER_BILLION |
ppb (10억분율) 농도 단위입니다. |
MICROGRAMS_PER_CUBIC_METER |
'μg/m^3' (세제곱미터당 마이크로그램) 농도 단위입니다. |