ইতিহাস

history এন্ডপয়েন্ট নির্দিষ্ট লোকেশনের জন্য, নির্দিষ্ট সময়সীমার মধ্যে, সর্বাধিক ৩০ দিন পর্যন্ত ঘণ্টাভিত্তিক এয়ার কোয়ালিটির পুরনো তথ্য প্রদান করে। কোন AQI এবং প্রাসঙ্গিক তথ্য (যেমন দূষণকারীর ঘনত্বের লেভেল এবং স্বাস্থ্য সংক্রান্ত সাজেশন) ফেরত দেওয়া হবে তা আপনি নিয়ন্ত্রণ করতে পারবেন।

আপনি history এন্ডপয়েন্ট ব্যবহার করে প্রতি ঘণ্টার এয়ার কোয়ালিটির ইতিহাস জানতে HTTP POST অনুরোধ পাঠাতে পারেন:

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'

এটি ব্যবহার করে দেখুন!

APIs Explorer আপনাকে স্যাম্পেল অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পের সাথে পরিচিত হতে পারেন।

  1. পৃষ্ঠার ডানদিকে API আইকন api বেছে নিন।

  2. ঐচ্ছিকভাবে, অনুরোধের প্যারামিটার এডিট করুন।

  3. এক্সিকিউট করুন বোতামটি বেছে নিন। ডায়ালগে, অনুরোধ করার জন্য আপনি যে অ্যাকাউন্ট ব্যবহার করতে চান সেটি বেছে নিন।

  4. APIs Explorer প্যানেলে, APIs Explorer উইন্ডো বড় করতে ফুলস্ক্রিন আইকন ফুলস্ক্রিন বেছে নিন।