Air Quality API の概要
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Air Quality API を使用すると、70 を超える大気質指数(AQI)、汚染物質、健康に関する推奨事項など、特定の場所の大気質データをリクエストできます。100 を超える国に対応しており、解像度は 500 × 500 メートルです。
Air Quality API を使用する理由
この API は、次のものをクエリできるエンドポイントを提供します。
- 現在の状況: リアルタイムの 1 時間ごとの大気質情報。
- 1 時間ごとの履歴: 指定された時間範囲(最長 30 日)における特定の場所の大気質の履歴。
- ヒートマップ: さまざまな指標と汚染物質を示す色分けしたタイル。
- 1 時間ごとの予測: 特定の場所の最大 96 時間(4 日間)先までの大気質の状況。
Air Quality API の機能
- 大気質指数とカテゴリのリアルタイム情報: Air Quality API は、500 × 500 メートルの解像度でさまざまな大気質指数の値を継続的に計算します。
- 健康に関する推奨事項: 一般ユーザーや、子ども、高齢者、妊娠中の女性、アスリート、喘息や心臓病を患っている人などの影響を受けやすいグループに対して、数百件の科学的根拠に基づいた健康に関する推奨事項を提供します。
- 汚染物質の詳細: さまざまな汚染物質に関する詳細情報。主な汚染物質、濃度、発生源、影響がハイライト表示されます。
- 1 時間ごとの履歴: 指定された時間範囲における特定の場所の大気質の履歴。各応答には、1 時間ごとの大気質指数、汚染物質のデータ、最大 720 時間(30 日間)の健康に関する推奨事項が含まれます。
- ヒートマップ: ヒートマップは、Google マップ上に表示される大気質指数と汚染物質の画像タイルのコレクションです。請求先住所が欧州経済領域(EEA)にある場合は、任意の地図の上にヒートマップを表示できます。詳細
- 1 時間ごとの天気予報: 特定の場所の将来の大気質の状況。指定された時間範囲または将来の特定の時間について、最大 96 時間(4 日間)の予測を取得できます。各応答には、1 時間ごとの大気質予報指数、汚染物質のデータ、実用的な推奨事項が含まれます。
Air Quality API の仕組み
Air Quality API には次のメソッドがあります。
currentConditions: currentConditions
エンドポイントは、現在の 1 時間ごとの大気質情報を提供します。
history: history
エンドポイントは、指定された時間範囲(最長 30 日)における特定の場所の 1 時間ごとの過去の大気質情報を提供します。
heatmapTiles: heatmapTiles
エンドポイントは、タイル オーバーレイを通じて大気質関連のヒートマップを提供します。
forecast: forecast
エンドポイントは、特定の場所の 1 時間ごとの将来の大気質情報を、指定された時間範囲で最大 96 時間(4 日間)提供します。
Air Quality API の対象国と地域
大気質情報(AQI)と地域の大気質情報(LAQI)が利用可能な国別の最新のサポート範囲については、Air Quality API のサポート対象国と利用可能な AQI をご覧ください。
Air Quality API の使用方法
1 |
セットアップする |
Google Cloud プロジェクトを設定するから始めて、以降の手順を完了します。 |
2 |
現在の 1 時間ごとの大気質情報を取得する |
現在の状況をご覧ください。 |
3 |
1 時間ごとの大気質の履歴を取得する |
履歴をご覧ください。 |
4 |
タイル オーバーレイを通じて大気質関連のヒートマップを取得する |
ヒートマップをご覧ください。 |
5 |
1 時間ごとの大気質予報情報を取得する |
予測をご覧ください。 |
次のステップ
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は 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)"]]