Air Quality API 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Air Quality API를 사용하면 70개가 넘는 공기질 지수 (AQI), 오염 물질, 건강 권장사항을 비롯한 특정 위치의 공기질 데이터를 요청할 수 있습니다. 해상도가 500x500미터인 100개 이상의 국가를 포함합니다.
Air Quality API를 사용해야 하는 이유
이 API는 다음을 쿼리할 수 있는 엔드포인트를 제공합니다.
- 현재 상황: 시간별 실시간 공기질 정보입니다.
- 시간별 기록: 특정 위치의 공기질 기록으로, 지정된 기간(최대 30일)에 대한 정보입니다.
- 히트맵: 다양한 지수와 오염 물질을 색상으로 구분한 타일입니다.
- 시간별 예보: 최대 96시간 (4일) 후 특정 위치의 미래 공기질 상태입니다.
Air Quality API의 기능
- 실시간 공기질 지수 및 카테고리: Air Quality API는 500x500미터 해상도로 다양한 공기질 지수 값을 지속적으로 계산합니다.
- 건강 추천: 아동, 노인, 임산부, 운동선수, 천식 또는 심장 질환 환자 등 일반 대중 및 민감군을 위한 수백 건의 연구 기반 건강 추천을 제공합니다.
- 오염물질 세부정보: 다양한 오염물질에 관한 자세한 정보로, 주요 오염물질, 농도, 출처, 영향을 강조합니다.
- 시간별 기록: 특정 기간의 특정 위치에 대한 공기질 기록입니다. 각 응답에는 최대 720시간 (30일)의 시간별 대기질 지수, 오염물질 데이터, 건강 권장사항이 포함될 수 있습니다.
- 히트맵: 히트맵은 Google 지도 위에 표시할 수 있는 AQ 지수 및 오염물질 이미지 타일 모음입니다.
청구서 수신 주소가 유럽 경제 지역 (EEA)인 경우 모든 지도 위에 히트맵을 표시할 수 있습니다.
자세히 알아보기
- 시간별 예보: 특정 위치의 미래 공기질 상태를 지정된 기간 또는 미래의 특정 시간(최대 96시간(4일))에 대해 표시합니다. 각 응답에는 시간별 대기질 예측 지수, 오염물질 데이터, 실행 가능한 추천이 포함될 수 있습니다.
Air Quality API 작동 방식
Air Quality API에는 다음과 같은 메서드가 있습니다.
currentConditions: currentConditions 엔드포인트는 현재 시간별 공기질 정보를 제공합니다.
history: history 엔드포인트는 특정 위치의 시간별 과거 공기질 정보를 지정된 기간 동안 최대 30일까지 제공합니다.
heatmapTiles: heatmapTiles 엔드포인트는 타일 오버레이를 통해 공기질 관련 히트맵을 제공합니다.
forecast: forecast 엔드포인트는 최대 96시간 (4일) 동안 특정 위치의 시간별 미래 공기질 정보를 제공합니다.
Air Quality API 국가 및 지역 지원 범위
공기질 정보 (AQI) 및 지역 공기질 정보 (LAQI)를 사용할 수 있는 국가별 최신 사용 범위에 관한 자세한 내용은 Air Quality API 지원 국가 및 사용 가능한 AQI를 참고하세요.
Air Quality API 사용 방법
| 1 |
설정하기 |
Google Cloud 프로젝트 설정하기부터 시작하여 이어지는 안내를 완료합니다. |
| 2 |
현재 시간별 공기질 정보 가져오기 |
현재 조건을 참고하세요. |
| 3 |
시간별 공기질 기록 가져오기 |
기록을 참고하세요. |
| 4 |
타일 오버레이를 통해 공기질 관련 히트맵 가져오기 |
히트맵을 참고하세요. |
| 5 |
시간별 공기질 예보 정보 확인하기 |
예측을 참고하세요. |
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eThe Air Quality API provides access to real-time, historical, and forecasted air quality data for over 100 countries with a resolution of 500 x 500 meters.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve current conditions, hourly history (up to 30 days), heatmaps, and hourly forecasts (up to 96 hours) using the API.\u003c/p\u003e\n"],["\u003cp\u003eThe API includes various air quality indexes, health recommendations, pollutant details, and heatmap tile overlays.\u003c/p\u003e\n"],["\u003cp\u003eCoverage details and available air quality indexes vary by country and region, so refer to the provided resources for specific information.\u003c/p\u003e\n"],["\u003cp\u003eTo use the Air Quality API, you need to set up a Google Cloud project and then utilize the provided endpoints and documentation to retrieve air quality data.\u003c/p\u003e\n"]]],["The Air Quality API provides real-time and historical air quality data, forecasts, and heatmaps for over 100 countries with 500x500 meter resolution. Key actions include querying current conditions, accessing up to 30 days of hourly history, viewing color-coded heatmap tiles, and obtaining up to 96-hour hourly forecasts. The API delivers information on 70+ AQIs, pollutants, and health recommendations for various groups, leveraging methods such as `currentConditions`, `history`, `heatmapTiles`, and `forecast`.\n"],null,["The Air Quality API lets you request air quality data for a specific location,\nincluding over 70 air quality indexes (AQIs), pollutants, and health\nrecommendations. It covers over 100 countries with a resolution of 500 x 500\nmeters.\n\nWhy use the Air Quality API\n\nThe API provides endpoints that let you query:\n\n- **Current Conditions:** Real-time hourly air quality information.\n- **Hourly History:** Air quality history for a specific location, for a given time range, up to a maximum of 30 days.\n- **Heatmaps:** Color coded tiles of various indexes and pollutants.\n- **Hourly Forecast:** Future air quality conditions for a specific location, up to 96 hours (4 days).\n\nFeatures of the Air Quality API\n\n- **Real-time air quality indexes and categories:** The Air Quality API continuously calculates the value of various air quality indexes with 500 x 500 meters resolution.\n- **Health recommendations:** Hundreds of research-backed health recommendations for the general public and sensitivity groups including: children, elderly, pregnant women, athletes and those with asthma or heart conditions.\n- **Pollutant details:** In-depth information about different pollutants, highlighting the dominant pollutant, concentrations, sources and effects.\n- **Hourly history:** Air quality history for a specific location for a given time range. Each response potentially includes hourly air quality indexes, pollutant data, and health recommendations for a maximum of 720 hours (30 days).\n- **Heatmaps:** Heatmaps are a collection of AQ indexes and pollutants image tiles that can be displayed on top of a Google Map. If your billing address is in the European Economic Area (EEA), you may display heatmaps on top of any map. [Learn more](/maps/comms/eea/faq#tos-updates).\n- **Hourly forecast:** Future air quality conditions for a specific location, and for a given time range or for a particular hour in the future, up to 96 hours (4 days). Each response potentially includes hourly air quality forecast indexes, pollutant data and actionable recommendations.\n\nHow the Air Quality API works\n\nThe Air Quality API has the following methods:\n\n- **currentConditions** : The\n [`currentConditions`](/maps/documentation/air-quality/reference/rest/v1/currentConditions/lookup) endpoint\n provides current hourly air quality information.\n\n- **history** : The\n [`history`](/maps/documentation/air-quality/reference/rest/v1/history/lookup) endpoint provides\n historical hourly air quality information for a specific location, for a\n given time range, up to a maximum of 30 days.\n\n- **heatmapTiles** : The [`heatmapTiles`](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile)\n endpoint provides air quality related heatmaps through a tile overlay.\n\n- **forecast** : The [`forecast`](/maps/documentation/air-quality/reference/rest/v1/forecast/lookup)\n endpoint provides hourly future air quality information for a specific\n location, for a given time range, up to a maximum of 96 hours (4 days).\n\nAir Quality API country and region coverage\n\nSee [Air Quality API supported countries and available AQIs](/maps/documentation/air-quality/coverage) for the\nlatest coverage details, on a country-by-country basis, for which air quality\ninformation (AQI) and local air quality information (LAQI) is available.\n\nHow to use the Air Quality API\n\n|---|-------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/air-quality/cloud-setup) and complete the instructions that follow. |\n| 2 | **Get current hourly air quality information** | See [Current conditions](/maps/documentation/air-quality/current-conditions). |\n| 3 | **Get hourly air-quality history** | See [History](/maps/documentation/air-quality/history). |\n| 4 | **Get air quality related heatmaps through a tile overlay** | See [Heatmaps](/maps/documentation/air-quality/heatmaps). |\n| 5 | **Get hourly air quality forecast information** | See [Forecast](/maps/documentation/air-quality/forecast). |\n\nWhat's next\n\n- [Set up your Google Cloud project](/maps/documentation/air-quality/cloud-setup)\n- [Get current conditions](/maps/documentation/air-quality/current-conditions)\n- [Get hourly history](/maps/documentation/air-quality/history)\n- [Get heatmaps](/maps/documentation/air-quality/heatmaps)\n- [Get hourly forecast](/maps/documentation/air-quality/forecast)"]]
