এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

ইতিহাস

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

আপনি 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 জন্য রিকোয়েস্ট বডি তৈরি করতে হয় যা ঐতিহাসিক ঘণ্টাভিত্তিক বায়ুর মানের একাধিক রেকর্ড ফেরত দেয়।

আপনি একটি সময়সীমা (অর্থাৎ শুরু ও শেষের টাইমস্ট্যাম্প) উল্লেখ করে, অথবা বর্তমান সময় থেকে কত ঘণ্টা আগের সময় উল্লেখ করে একাধিক রেকর্ডের জন্য অনুরোধ করতে পারেন।

দ্রষ্টব্য: ফলাফলগুলো পৃষ্ঠা আকারে দেখানো হয়, এবং সর্বশেষ ফলাফলগুলো প্রথম পৃষ্ঠায় প্রদর্শিত হয়। প্রতি পৃষ্ঠায় ফলাফলের সর্বোচ্চ সংখ্যা নিয়ন্ত্রণ করতে 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 প্রতিক্রিয়া তৈরি করে। প্রতিক্রিয়া ডেটা সম্পর্কে আরও বিশদ জানতে, প্রতিক্রিয়া ডেটা দেখুন।

উপরের উভয় কলেই চার ঘণ্টার বায়ুর মানের ডেটা চাওয়া হয়েছে। কিন্তু, আপনি অনুরোধে 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'

চেষ্টা করে দেখুন!

এপিআই এক্সপ্লোরার আপনাকে নমুনা অনুরোধ করার সুযোগ দেয়, যাতে আপনি এপিআই এবং এর অপশনগুলোর সাথে পরিচিত হতে পারেন।

পৃষ্ঠার ডানদিকে থাকা API আইকনটি (api) নির্বাচন করুন।
ইচ্ছা হলে অনুরোধের প্যারামিটারগুলো সম্পাদনা করুন।
Execute বাটনটি নির্বাচন করুন। প্রদর্শিত ডায়ালগ বক্সে, অনুরোধটি করার জন্য আপনি যে অ্যাকাউন্টটি ব্যবহার করতে চান, সেটি বেছে নিন।
এপিআই এক্সপ্লোরার প্যানেলে, এপিআই এক্সপ্লোরার উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকনটি নির্বাচন করুন।