इतिहास

history एंडपॉइंट से, किसी खास जगह के लिए, हर घंटे की एयर क्वालिटी की पुरानी जानकारी मिलती है. एयर क्वालिटी ज़्यादा से ज़्यादा 30 दिनों तक की हो सकती है. आपके पास यह कंट्रोल करने का विकल्प है कि कौनसे एक्यूआई और कौनसी जानकारी को दिखाना है. जैसे, प्रदूषण फैलाने वाले कॉम्पोनेंट की मात्रा का लेवल और सेहत से जुड़े सुझाव.

history एंडपॉइंट का इस्तेमाल करके, हर घंटे की एयर क्वालिटी के इतिहास का अनुरोध किया जा सकता है. इसके लिए, आपको एचटीटीपी पोस्ट करने का अनुरोध भेजना होगा:

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'