इस पेज का अनुवाद Cloud Translation API से किया गया है.

इतिहास

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

हर घंटे की एयर क्वालिटी के इतिहास का अनुरोध करने के लिए, इनका इस्तेमाल करें: 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, जो नतीजे के तौर पर कई हर घंटे की एयर क्वालिटी के रिकॉर्ड.

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

ध्यान दें: नतीजे, पेजों में दिखाए जाते हैं और सबसे हाल ही के नतीजे खोजें. ज़्यादा से ज़्यादा इतने डिवाइसों को कंट्रोल करने के लिए, 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'

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

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

ऊपर बताए गए दोनों कॉल, एयर क्वालिटी के चार घंटे के डेटा का अनुरोध करते हैं. हालांकि, क्योंकि आपने 2 के लिए pageSize प्रॉपर्टी, अनुरोध के जवाब में सिर्फ़ यह शामिल है सबसे हाल के दो घंटों के नतीजे.

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