التاريخ

توفر نقطة نهاية history المعلومات السابقة حول جودة الهواء كل ساعة في موقع جغرافي محدّد النطاق الزمني، بحد أقصى 30 يومًا. يمكنك تحديد مؤشرات جودة الهواء (مثل مستوى تركيز الملوّثات والتوصيات الصحية).

يمكنك طلب الاطّلاع على سجلّ جودة الهواء كل ساعة باستخدام history نقطة النهاية عن طريق إرسال طلب HTTP POST إلى:

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

إدراج خيارات الطلب في ملف JSON نص الطلب. نص الطلب يحتوي على الموقع والنطاق الزمني الذي ترغب في الحصول على سجلّ جودة الهواء كل ساعة قد يتضمن أيضًا خيارات مختلفة للتحكم معلومات جودة الهواء التي يجب تضمينها في الاستجابة.

يتيح لك مستكشف واجهات برمجة التطبيقات تقديم طلبات مباشرة حتى تكون على دراية خيارات واجهة برمجة التطبيقات وواجهة برمجة التطبيقات:

جرِّبه الآن

مثال على طلب ساعة واحدة

نص الطلب لساعة واحدة

يوضح الرمز التالي كيفية إنشاء نص طلب لساعة واحدة طلب سجلّ باستخدام 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'