Method: history.lookup

指定された時間範囲における特定の場所の大気質の履歴を返します。

HTTP リクエスト

POST https://airquality.googleapis.com/v1/history:lookup

この URL は gRPC Transcoding 構文を使用します。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "pageSize": integer,
  "pageToken": string,
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "dateTime": string,
  "hours": integer,
  "period": {
    object (Interval)
  }
  // End of list of possible types for union field time_range.
  "universalAqi": boolean,
  "languageCode": string
}
フィールド
pageSize

integer

省略可。ページごとに返される 1 時間ごとの情報レコードの最大数。デフォルトは 72、最大値は 168（7 日間のデータ）です。
pageToken

string

省略可。前回の履歴呼び出しから受け取ったページトークン。後続のページを取得するために使用されます。

このパラメータの値を指定する際は、指定する他のすべてのパラメータが、ページトークンを提供した呼び出し（前の呼び出し）と一致している必要があります。
location

object (LatLng)

必須。API が大気質履歴データを検索する緯度と経度。
extraComputations[]

enum (ExtraComputation)

省略可。必要に応じて有効にできる追加機能。追加の計算を指定すると、関連する要素とフィールドがレスポンスで返されます。
uaqiColorPalette

enum (ColorPalette)

省略可。ユニバーサル大気質指数（UAQI）で提供されるデータに使用するカラーパレットを指定します。このカラーパレットは UAQI 専用ですが、他の AQI にはあらかじめ決められたカラーパレットがあり、制御できません。
customLocalAqis[]

object (CustomLocalAqi)

省略可。国/地域と AQI の関係を表します。国/地域を目的の AQI とペア設定して、その国/地域に必要な大気質データが、選択した AQI に従って表示されます。このパラメータを使用すると、特定の国のデフォルト以外の AQI を指定できます。たとえば、カナダのデフォルトのインデックスではなく、カナダの US EPA インデックスを取得できます。
dateTime

string (Timestamp format)

過去のデータを返すためのタイムスタンプ。タイムスタンプは過去 1 時間に丸められます。

注: これにより、リクエストされたタイムスタンプの時間データのみ（つまり、1 つの時間ごとの info 要素）が返されます。たとえば、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」

注: リクエストには dateTime、startTime、endTime のいずれかを使用できます。
hours

integer

リクエストの時間範囲を示す 1 ～ 720 の数値。例: 値が 48 の場合、過去 48 時間のデータが生成されます。
period

object (Interval)

過去のデータを取得する startTime 期間と endTime 期間を指定します。タイムスタンプは過去 1 時間に丸められます。

注: リクエストには dateTime、startTime、endTime のいずれかを使用できます。
universalAqi

boolean

省略可。true に設定すると、ユニバーサル AQI がレスポンスの「indexes」フィールドに含まれます。デフォルト値は true です。
languageCode

string

省略可。クライアントがレスポンスの言語を選択できるようにします。その言語のデータを提供できない場合、API は最も近い言語を使用します。使用できる値は IETF 標準に準拠しています。デフォルト値は en です。

レスポンスの本文

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "hoursInfo": [
    {
      object (HourInfo)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
フィールド
hoursInfo[]

object (HourInfo)

省略可。リクエストされた範囲内の 1 時間ごとの大気質情報が含まれます。たとえば、リクエストが 48 時間の履歴に関する場合、1 時間ごとの情報には 48 の要素があります。
regionCode

string

省略可。リクエストで指定された場所に対応する国/地域の ISO_3166-1 alpha-2 コード。リクエストで指定された場所が係争地にある場合、このフィールドはレスポンスから省略されることがあります。
nextPageToken

string

省略可。次のページを取得するためのトークン。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

詳細については、OAuth 2.0 の概要をご覧ください。

HourInfo

リクエストされた範囲内の 1 時間ごとの大気質情報が含まれます。たとえば、リクエストが 48 時間の履歴に関する場合、1 時間ごとの情報には 48 の要素があります。

JSON 表現 
{
  "dateTime": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
フィールド
dateTime

string (Timestamp format)

データが参照する時刻を RFC3339 UTC「Zulu」形式で示す切り捨てタイムスタンプ。精度はナノ秒単位で、小数点以下 9 桁までです。例: 「2014-10-02T15:00:00Z」
indexes[]

object (AirQualityIndex)

このリストには、リクエストのパラメータに基づいて、最大 2 つの大気質指数が含まれます。

  • ユニバーサル AQI。UniversalAqi ブール値が true に設定されている場合に返されます。
  • ローカル大気質指数。LOCAL_AQI 追加計算が指定されている場合は返されます。
pollutants[]

object (Pollutant)

リクエストで指定された場所に影響を与える汚染物質のリスト。注: このフィールドは、POLLUTANT_additional_INFO、DOMINANT_POLLUTANT_CONCENTRATION、POLLUTANT_CONCENTRATION の追加計算を 1 つ以上指定したリクエストに対してのみ返されます。
healthRecommendations

object (HealthRecommendations)

報告された大気質状態に関連する健康に関するアドバイスと推奨される対応。推奨事項は、リスクのある集団、汚染物質に敏感なグループ、一般集団に合わせて調整されています。