색인
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 |
응답에 각 오염 물질의 추가 정보를 포함할지 여부를 결정합니다. 지정된 경우 'indexes' 필드 응답에 포함된 각 공기질 지수 객체에는 데이터를 사용할 수 있는 경우 |
DOMINANT_POLLUTANT_CONCENTRATION |
응답에 글로벌 또는 지역 색인에 따라 측정된 주요 오염 물질의 농도가 포함되는지 여부를 결정합니다. 요청에 전 세계 AQI와 현지 AQI가 모두 지정된 경우 최대 2개의 오염 물질 코드가 반환될 수 있습니다. 지정된 경우 'pollutants' 목록에 포함된 주요 오염 물질 객체에는 데이터를 사용할 수 있는 경우 |
POLLUTANT_CONCENTRATION |
응답에 전 세계 또는 지역 색인에 따라 측정 가능한 모든 오염 물질의 농도가 포함되는지 확인합니다. 지정된 경우 데이터를 사용할 수 있는 경우 응답의 'pollutants' 필드에 포함된 각 오염 물질 객체에 |
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를 지정할 수 있습니다. 예를 들어 캐나다의 기본 지수가 아닌 미국 EPA 지수를 가져올 수 있습니다. |
universal_aqi |
선택사항입니다. true로 설정하면 범용 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를 지정할 수 있습니다. 예를 들어 캐나다의 기본 지수가 아닌 미국 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로 설정하면 범용 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를 지정할 수 있습니다. 예를 들어 캐나다의 기본 지수가 아닌 미국 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로 설정하면 범용 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 |
보고된 공기질 상태와 관련된 건강 조언 및 권장 조치 추천은 위험에 처한 인구, 오염 물질에 더 민감한 그룹, 일반 인구에 따라 다르게 조정됩니다. |
지도 유형
공기질 히트맵의 유형입니다. 지도에 그래픽으로 표시할 오염 물질을 정의합니다.
열거형 | |
---|---|
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' (미터당 마이크로그램) 농도 단위입니다. |