تاریخ

نقطه پایانی history اطلاعات ساعتی تاریخی کیفیت هوا را برای یک مکان خاص، برای یک محدوده زمانی معین، حداکثر تا 30 روز ارائه می دهد. می توانید AQI و اطلاعات مربوطه را که بازگردانده می شوند (مانند سطح غلظت آلاینده ها و توصیه های بهداشتی) کنترل کنید.

با ارسال یک درخواست HTTP POST می توانید تاریخچه کیفیت هوای ساعتی را با استفاده از نقطه پایانی history درخواست کنید:

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

گزینه های درخواست خود را در بدنه درخواست JSON قرار دهید. بدنه درخواست شامل مکان و محدوده زمانی است که می‌خواهید تاریخچه ساعتی کیفیت هوا را دریافت کنید. همچنین ممکن است شامل گزینه های مختلفی برای کنترل اطلاعات کیفیت هوا در پاسخ باشد.

APIs Explorer به شما امکان می دهد درخواست های زنده بنویسید تا بتوانید با API و گزینه های API آشنا شوید:

آن را امتحان کنید!

نمونه ای از درخواست یک ساعته

بدن درخواست یک ساعته

کد زیر نحوه ساخت بدنه درخواست برای یک درخواست تاریخچه یک ساعته را با استفاده از روش 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'

پاسخگویی یک ساعته

تماس بالا پاسخ 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 ای را نشان می دهد که چندین رکورد از کیفیت هوای ساعتی تاریخی را برمی گرداند.

شما می توانید با تعیین یک بازه زمانی، به معنی مهر زمانی شروع و پایان، یا با تعیین تعداد ساعات برگشت از زمان فعلی، چندین رکورد را درخواست کنید.

در مثال زیر، چون اندازه صفحه را 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 به شکل زیر ایجاد می کنند. برای جزئیات بیشتر درباره داده‌های پاسخ، به داده‌های پاسخ مراجعه کنید.

هر دو تماس فوق چهار ساعت داده کیفیت هوا را درخواست می کنند. با این حال، از آنجایی که ویژگی 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 نیز می شود. از این ویژگی برای دسترسی به صفحه بعدی نتایج که حاوی داده های دو ساعت بعدی است استفاده کنید.

برای دسترسی به صفحه بعدی نتایج، یک درخواست دوم به نقطه پایانی 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'