Current Conditions エンドポイントは、100 か国以上における 1 時間ごとの大気質情報を、最大 500 x 500 メートルの解像度で提供しています。70 以上のローカル指数、グローバルな大気質指数および大気質カテゴリが含まれます。
HTTP リクエスト
POST https://airquality.googleapis.com/v1/currentConditions:lookup
この URL は gRPC Transcoding 構文を使用します。
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "location": { object ( |
フィールド | |
---|---|
location |
必須。API が大気質の現在の状態データを検索する場所の経度と緯度。 |
extraComputations[] |
(省略可)必要に応じて有効にできる追加機能。追加の計算を指定すると、レスポンスで関連する要素とフィールドが返されます。 |
uaqiColorPalette |
(省略可)ユニバーサル大気質指数(UAQI)によって提供されるデータに使用するカラーパレットを指定します。このカラーパレットは UAQI 専用です。他の AQI には既定のカラーパレットがあり、コントロールできません。 |
customLocalAqis[] |
(省略可)国/地域と AQI の関係を表します。国/地域を目的の AQI とペア設定し、その国/地域に必要な大気質データが選択した AQI に応じて表示されるようにします。このパラメータを使用して、特定の国のデフォルトではない AQI を指定できます。たとえば、カナダのデフォルトのインデックスではなく、カナダの US EPA インデックスを取得できます。 |
universalAqi |
(省略可)true に設定した場合、ユニバーサル AQI はレスポンスの index フィールドにも含まれます。デフォルト値は true です。 |
languageCode |
(省略可)クライアントがレスポンスの言語を選択できるようにします。その言語のデータを提供できない場合、API は最も近い言語を使用します。指定できる値は IETF 標準に基づきます。デフォルト値は en です。 |
レスポンスの本文
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{ "dateTime": string, "regionCode": string, "indexes": [ { object ( |
フィールド | |
---|---|
dateTime |
RFC3339 UTC「Zulu」形式の切り捨てられたタイムスタンプ。ナノ秒単位で、最大 9 桁の小数点以下になります。例: "2014-10-02T15:00:00Z" |
regionCode |
リクエストで指定されたロケーションに対応する国/地域の ISO_3166-1 alpha-2 コード。リクエストで指定された場所が係争地にある場合は、レスポンスでこのフィールドが省略されることがあります。 |
indexes[] |
リクエスト パラメータに基づいて、このリストには(最大)2 つの大気質指数が含まれます。
|
pollutants[] |
リクエストで指定されたロケーションに影響する汚染物質のリスト。注: このフィールドは、追加の計算 POLLUTANT_additional_INFO、DOMINANT_POLLUTANT_CONCENTRATION、POLLUTANT_CONCENTRATION を 1 つ以上指定したリクエストに対してのみ返されます。 |
healthRecommendations |
報告された大気質状態に関連する健康に関するアドバイスと推奨される対応。推奨事項は、リスクにさらされている集団、汚染物質に敏感なグループ、および一般集団に応じて異なります。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/cloud-platform
詳細については、OAuth 2.0 の概要をご覧ください。