- HTTP リクエスト
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- HourlyForecast
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
指定された期間における特定の場所の大気質予測を返します。
HTTP リクエスト
POST https://airquality.googleapis.com/v1/forecast:lookup
この URL は gRPC Transcoding 構文を使用します。
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "location": { object ( |
フィールド | |
---|---|
location |
必須。API が大気質データを検索する対象の緯度と経度。 |
extraComputations[] |
省略可。オプションで有効にできる追加機能。追加の計算を指定すると、関連する要素とフィールドがレスポンスで返されます。 |
uaqiColorPalette |
省略可。「ユニバーサル大気質指数」によって提供されるデータに使用するカラーパレットを指定します(UAQI)。このカラーパレットは UAQI のみに関係しますが、他の AQI には制御できない事前定義のカラーパレットがあります。 |
customLocalAqis[] |
省略可。「国/地域を AQI に」を表しますあります。国/地域と目的の AQI をペアにして、選択した AQI に応じてその国/地域に必要な大気質データを表示します。このパラメータを使用して、特定の国のデフォルト以外の AQI を指定できます。たとえば、カナダのデフォルトのインデックスではなく、カナダ向けの米国 EPA インデックスを取得できます。 |
pageSize |
省略可。ページごとに返される 1 時間ごとの情報レコードの最大数(デフォルト = 24)。 |
pageToken |
省略可。前回の予測呼び出しで受け取ったページトークン。後続のページを取得するために使用されます。 |
dateTime |
特定の時点のデータを返すタイムスタンプ。タイムスタンプは、直近の 1 時間に四捨五入されます。 これにより、リクエストされたタイムスタンプについてのみ 1 時間ごとのデータが返されます(つまり、1 時間ごとの情報要素だけが返されます)。たとえば、dateTime パラメータが 2023-01-03T11:05:49Z に設定されている状態で送信されたリクエストは、2023-01-03T11:00:00Z に切り捨てられます。 注: リクエストでは |
period |
予測データを取得する 注: リクエストでは |
universalAqi |
省略可。true に設定した場合、Universal AQI が「indexes」に含められます(デフォルトは true)です。 |
languageCode |
省略可。クライアントはレスポンスの言語を選択できます。その言語のデータを提供できない場合、API は最も近い言語を使用します。使用できる値は IETF 標準に準拠しています(デフォルトは「en」)。 |
レスポンスの本文
大気質予測 API のレスポンス オブジェクト。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{
"hourlyForecasts": [
{
object ( |
フィールド | |
---|---|
hourlyForecasts[] |
省略可。リクエストされた範囲の 1 時間ごとの大気質情報が含まれます。たとえば、リクエストが 48 時間の予測の場合、1 時間ごとの予測の要素数は 48 になります。 |
regionCode |
省略可。リクエストで指定された地域に対応する国/地域の ISO_3166-1 alpha-2 コード。リクエストで指定された場所が係争地にある場合は、レスポンスからこのフィールドが省略されることがあります。 |
nextPageToken |
省略可。次のページを取得するためのトークン。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/cloud-platform
詳しくは、OAuth 2.0 の概要をご覧ください。
HourlyForecast
リクエストされた範囲の 1 時間ごとの大気質情報が含まれます。たとえば、リクエストが 48 時間の予測の場合、1 時間ごとの予測の要素数は 48 になります。
JSON 表現 |
---|
{ "dateTime": string, "indexes": [ { object ( |
フィールド | |
---|---|
dateTime |
データが参照する時刻(時間)(RFC3339 UTC「Zulu」)を示す、切り捨てられたタイムスタンプ使用できます。例: 「2014-10-02T15:00:00Z」 |
indexes[] |
このリストには、リクエスト パラメータに基づいて、最大 2 つの大気質指数が含まれます。
|
pollutants[] |
リクエストで指定された場所に影響を与える汚染物質のリスト。 注: このフィールドは、POLLUTANT_ADDITIONAL_INFO、DOMINANT_POLLUTANT_CONCENTRATION、POLLUTANT_CONCENTRATION の追加計算を 1 つ以上指定したリクエストに対してのみ返されます。 |
healthRecommendations |
報告された大気質の状態に関連する健康に関するアドバイスと推奨される対応。推奨事項は、リスクのある集団、汚染物質に対して敏感な集団、一般集団に応じて異なります。 |