इतिहास

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

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

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

अनुरोध के विकल्पों को, JSON अनुरोध के मुख्य हिस्से में शामिल करें. अनुरोध के मुख्य हिस्से में, वह जगह और समय सीमा शामिल होती है जिसके लिए आपको हर घंटे के हिसाब से हवा की क्वालिटी की जानकारी का इतिहास चाहिए. इसमें, हवा की क्वालिटी की कौनसी जानकारी जवाब में शामिल करनी है, यह तय करने के लिए अलग-अलग विकल्प भी शामिल हो सकते हैं.

एपीआई एक्सप्लोरर की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है:

इसे आज़माएं!

एक घंटे के लिए अनुरोध का उदाहरण

एक घंटे के लिए अनुरोध का मुख्य हिस्सा

नीचे दिए गए कोड में, एक घंटे के इतिहास के लिए अनुरोध का मुख्य हिस्सा बनाने का तरीका बताया गया है.history इस उदाहरण में, जगह और पिछले टाइमस्टैंप को सेट किया गया है.

ध्यान दें: पक्का करें कि dateTime पैरामीटर में, पिछले 30 दिनों के अंदर की समय अवधि बताई गई हो.

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 फ़ॉर्मैट में यह जवाब मिलता है . जवाब के डेटा के बारे में ज़्यादा जानकारी के लिए, जवाब का डेटा देखें.

ध्यान दें: डिफ़ॉल्ट रूप से, जवाब में बुनियादी AQI की जानकारी के साथ-साथ, यूनिवर्सल AQI भी शामिल होता है. AQI को हटाया जा सकता है या उससे जुड़े पैरामीटर सेट करके, उसे किसी दूसरे AQI से बदला जा सकता है.

{
    "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"
}

ध्यान दें: अगर किसी color फ़ील्ड की वैल्यू 0 है, तो उस फ़ील्ड को जवाब से हटा दिया जाता है.

तय की गई समय सीमा के लिए अनुरोध का उदाहरण

तय की गई समय सीमा के लिए अनुरोध

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

तय की गई समय सीमा के लिए अनुरोध करके, कई रिकॉर्ड पाए जा सकते हैं. इसके लिए, शुरू और खत्म होने का टाइमस्टैंप तय करें या मौजूदा समय से पिछले घंटों की संख्या तय करें.

ध्यान दें: नतीजे पेज में दिखाए जाते हैं. सबसे हाल के नतीजे, पहले पेज पर दिखाए जाते हैं. हर पेज पर ज़्यादा से ज़्यादा कितने नतीजे दिखाने हैं, यह तय करने के लिए pageSize प्रॉपर्टी का इस्तेमाल करें. अगर सभी नतीजे पाने के लिए एक से ज़्यादा पेजों की ज़रूरत है, तो हर पेज में nextPageToken प्रॉपर्टी शामिल होती है. इसमें वह टोकन होता है जिसका इस्तेमाल करके, अगला पेज पाया जा सकता है.

नीचे दिए गए उदाहरण में, पेज साइज़ को 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'

शुरू और खत्म होने के टाइमस्टैंप पास करके, इसी तरह का अनुरोध किया जा सकता है:

ध्यान दें: पक्का करें कि startTime और endTime पैरामीटर में, पिछले 30 दिनों के अंदर की समय अवधि बताई गई हो.

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 की वैल्यू पर सेट करें.

ध्यान दें: डेटा के अगले पेज ऐक्सेस करने के लिए, pageToken प्रॉपर्टी पास करते समय, अनुरोध के अन्य सभी पैरामीटर, पेज टोकन देने वाले ओरिजनल कॉल से मेल खाने चाहिए.

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'

इसे आज़माएं!

एपीआई एक्सप्लोरर की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.

1. पेज की दाईं ओर मौजूद, एपीआई आइकॉन api को चुनें.

2. ज़रूरत पड़ने पर, अनुरोध के पैरामीटर में बदलाव करें.

3. लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.

4. एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें.