ইতিহাস

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

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

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

JSON অনুরোধের বডিতে আপনার অনুরোধের বিকল্পগুলি অন্তর্ভুক্ত করুন। অনুরোধের মূল অংশে অবস্থান এবং সময়সীমা রয়েছে যার জন্য আপনি প্রতি ঘন্টায় বায়ু মানের ইতিহাস পেতে চান। প্রতিক্রিয়াতে কী বায়ুর মানের তথ্য অন্তর্ভুক্ত করতে হবে তা নিয়ন্ত্রণ করার জন্য এটি বিভিন্ন বিকল্পও অন্তর্ভুক্ত করতে পারে।

APIs এক্সপ্লোরার আপনাকে লাইভ অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পগুলির সাথে পরিচিত হতে পারেন:

এটা চেষ্টা করুন!

এক ঘণ্টার অনুরোধের উদাহরণ

একক ঘন্টা অনুরোধ শরীর

নিম্নলিখিত কোডটি দেখায় কিভাবে 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'