歴史

history エンドポイントは、 特定の場所における、特定の場所における 1 時間ごとの大気質情報 最大 30 日の範囲で設定できます。どの AQI と 関連する情報(汚染物質の濃度レベル、 。

1 時間ごとの大気質の履歴は、 history HTTP POST リクエストを次の宛先に送信します。

https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY

JSON にリクエスト オプションを含める リクエスト本文。リクエスト本文 には、メッセージを取得する対象のロケーションと 1 時間ごとの大気質履歴。画像アセットを制御するためのさまざまなオプションが 回答に含める大気質情報を指定します。

API Explorer を使用すると、ライブ リクエストを発行できるため、 API と API のオプション:

試してみる

1 時間のリクエストの例

1 時間のリクエスト本文

次のコードは、1 時間のリクエスト本文を作成する方法を示しています。 使用して履歴データを history メソッドを使用します。 この例では、場所と過去のタイムスタンプを設定します。

curl -X POST -d '{
  "dateTime": "2023-06-26T15:01:23Z",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

1 時間以内のレスポンス

上記の呼び出しにより、以下が生成されます。 JSON レスポンス。 レスポンス データの詳細については、レスポンス データをご覧ください。

{
    "hoursInfo": [
        {
            "dateTime": "2023-06-26T15:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 73,
                    "aqiDisplay": "73",
                    "color": {
                        "red": 118,
                        "green": 202,
                        "blue": 51,
                        "alpha": 255
                    },
                    "category": "Good air quality",
                    "dominantPollutant": "pm10"
                }
            ]
        }
    ],
    "regionCode": "us"
}

期間リクエストの例

期間のリクエスト

次のコードは、 history は複数の値を返します。 1 時間ごとの大気質の履歴記録。

時間範囲を指定することで、複数のレコードをリクエストできます。つまり、 または、現在の時刻からの何時間前までの経過時間を あります。

次の例では、ページサイズを 2 に設定したため、 4 時間の大気質履歴が 2 つのページで返されます。 2 時間分のデータが含まれます

curl -X POST -d '{
  "hours": 4,
  "pageSize": 2,
  "pageToken":"",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

開始と終了のタイムスタンプを渡して、同様のリクエストを行うこともできます。

curl -X POST -d '{
  "period": {
      "startTime":"2023-06-15T08:00:00Z",
      "endTime":"2023-06-15T12:00:00Z"
  },
  "pageSize": 2,
  "pageToken":"",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

期間のレスポンス

上記の呼び出しにより フォームの JSON レスポンス ご覧くださいレスポンス データの詳細については、このモジュールの レスポンス データ

上記のどちらの通話も、4 時間の大気質データをリクエストします。ただし リクエストの pageSize プロパティを 2 に設定しても、レスポンスには 結果が表示されます。

{
    "hoursInfo": [
        {
            "dateTime": "2023-06-15T11:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 83,
                    "aqiDisplay": "83",
                    "color": {
                        "red": 74,
                        "green": 185,
                        "blue": 54,
                        "alpha": 255
                    },
                    "category": "Excellent air quality",
                    "dominantPollutant": "o3"
                }
            ]
        },
        {
            "dateTime": "2023-06-15T10:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 89,
                    "aqiDisplay": "89",
                    "color": {
                        "red": 48,
                        "green": 175,
                        "blue": 55,
                        "alpha": 255
                    },
                    "category": "Excellent air quality",
                    "dominantPollutant": "o3"
                }
            ]
        }
    ],
    "regionCode": "us",
    "nextPageToken": "ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA"
}

レスポンスには nextPageToken プロパティも含まれていることに注意してください。使用する プロパティを使用して、結果の次のページにアクセスします。これには、次の 2 つのページが含まれます。 超えています。

結果の次のページにアクセスするには、 history エンドポイントですが、今回は pageToken プロパティを以下に設定します。 最初のレスポンスの nextPageToken の値。

curl -X POST -d '{
  "hours": 4,
  "pageSize": 2,
  "pageToken":"ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'