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

পূর্বাভাস

forecast শেষ বিন্দুটি একটি নির্দিষ্ট স্থানের জন্য ৯৬ ঘন্টা (৪ দিন) পর্যন্ত ঘণ্টাভিত্তিক বায়ুর মানের পূর্বাভাসের তথ্য প্রদান করে। প্রতিটি পূর্বাভাসে ঘণ্টাভিত্তিক বায়ুর মানের সূচকের পাশাপাশি অতিরিক্ত তথ্যও অন্তর্ভুক্ত থাকে:

পূর্বাভাসের জন্য নির্দিষ্ট সময় ও তারিখ বা সময়কাল
অনূদিত ক্ষেত্রগুলির জন্য ভাষা কোড
স্থানীয় বা প্রচলিত বায়ুর গুণমান সূচক (AQI)
স্বাস্থ্য সংক্রান্ত সুপারিশ
প্রভাবশালী দূষক
দূষণকারী ঘনত্ব
দূষক সম্পর্কে অতিরিক্ত তথ্য
প্রতিক্রিয়া পৃষ্ঠার আকার
রঙের প্যালেট

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

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

বায়ুর মানের পূর্বাভাস পেতে, নিচের সাধারণ অনুরোধের উদাহরণে দেখানো অনুযায়ী dateTime প্যারামিটারটিকে ভবিষ্যতের কোনো তারিখ ও সময়ে সেট করুন।

পূর্বাভাস অনুরোধ সম্পর্কে

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

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

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

পূর্বাভাস প্রতিক্রিয়া সম্পর্কে

রেসপন্স বডিতে সেই UTC তারিখ ও সময় প্রদান করা হয়, যার ভিত্তিতে বায়ুর মানের পূর্বাভাস, বায়ুর মানের সূচক এবং অতিরিক্ত কাস্টমাইজড তথ্য প্রদর্শন করা হবে। অনুরোধ করা পৃষ্ঠার আকারের মধ্যে তথ্যটি না ধরলে, পরবর্তী পৃষ্ঠাটি আনার জন্য রেসপন্স বডিতে একটি টোকেনও অন্তর্ভুক্ত থাকে।

মৌলিক অনুরোধের উদাহরণ

নিম্নলিখিত কোডটি দেখায় কিভাবে একটি পূর্বাভাস অনুরোধ তৈরি করতে হয়। এই উদাহরণে, আপনি অবস্থান, তারিখ এবং সময় (পরবর্তী এক ঘন্টা থেকে ৯৬ ঘন্টা পর্যন্ত) নির্দিষ্ট করেন, যার জন্য প্রতি ঘন্টার বায়ুর মানের পূর্বাভাস তথ্য দেখানো হবে।

curl -X POST -d '{
  "location": {
    "latitude": 37.4125333,
    "longitude": -122.0840937
  },
  "dateTime": "2024-02-09T08:00:00Z"
}' \
-H "Content-Type: application/json" \
-H "Accept-Language: *" \
"https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"

এই কলটি নিম্নলিখিত JSON প্রতিক্রিয়া তৈরি করে।

{
  "hourlyForecasts": [
    {
      "dateTime": "2024-02-09T08:00:00Z",
      "indexes": [
        {
          "code": "uaqi",
          "displayName": "Universal AQI",
          "aqi": 80,
          "aqiDisplay": "80",
          "color": {
            "red": 0.34509805,
            "green": 0.74509805,
            "blue": 0.20784314
          },
          "category": "Excellent air quality",
          "dominantPollutant": "pm25"
        }
      ]
    }
  ],
  "regionCode": "us"
}

একাধিক প্যারামিটার সহ অনুরোধের উদাহরণ

নিম্নলিখিত কোডটি দেখায় কিভাবে একাধিক প্যারামিটার সহ একটি রিকোয়েস্ট বডি তৈরি করতে হয়। এই উদাহরণে, আপনি নিম্নলিখিতগুলি নির্দিষ্ট করবেন:

অবস্থান
বায়ুর মানের পূর্বাভাস তথ্য প্রদর্শনের সময়কাল
ভাষা কোড
অতিরিক্ত গণনা (যেমন স্বাস্থ্য সংক্রান্ত সুপারিশ, প্রধান দূষকের ঘনত্ব এবং দূষক সম্পর্কিত অতিরিক্ত তথ্য)
রঙের প্যালেট

curl -X POST -d '{
    "pageSize": "10",
    "universalAqi": "true",
    "location": {
        "latitude": "40.741895",
        "longitude": "-73.989308"
    },
    "period": {
        "startTime": "2024-02-27T13:58:14+02:00",
        "endTime": "2024-02-28T16:58:14+02:00"
    },
    "languageCode": "en",
    "extraComputations": [
        "HEALTH_RECOMMENDATIONS",
        "DOMINANT_POLLUTANT_CONCENTRATION",
        "POLLUTANT_ADDITIONAL_INFO"
    ],
    "uaqiColorPalette": "RED_GREEN"
}' \
-H "Content-Type: application/json" \
-H "Accept-Language: *" \
"https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"

এই কলটি নিম্নলিখিত JSON প্রতিক্রিয়া তৈরি করে।

{
  {
  "hourlyForecasts": [
    {
      "dateTime": "2024-02-27T11:00:00Z",
      "indexes": [
        {
          "code": "uaqi",
          "displayName": "Universal AQI",
          "aqi": 75,
          "aqiDisplay": "75",
          "color": {
            "red": 0.43137255,
            "green": 0.7764706,
            "blue": 0.20392157
          },
          "category": "Good air quality",
          "dominantPollutant": "pm25"
        }
      ],
      "pollutants": [
        {
          "code": "pm25",
          "displayName": "PM2.5",
          "fullName": "Fine particulate matter (\u003c2.5µm)",
          "concentration": {
            "value": 15.1,
            "units": "MICROGRAMS_PER_CUBIC_METER"
          },
          "additionalInfo": {
            "sources": "...",
            "effects": "..."
          }
        }
      ],
      "healthRecommendations": {
        "generalPopulation": "...",
        "lungDiseasePopulation": "...",
        "heartDiseasePopulation": "...",
        "athletes": "...",
        "pregnantWomen": "..."
      }
    },
    {
      "dateTime": "2024-02-27T12:00:00Z",
      "indexes": [
        {
          "code": "uaqi",
          "displayName": "Universal AQI",
          "aqi": 67,
          "aqiDisplay": "67",
          "color": {
            "red": 0.5882353,
            "green": 0.8392157,
            "blue": 0.16862746
          },
          "category": "Good air quality",
          "dominantPollutant": "pm25"
        }
      ],
      "pollutants": [
        {
          "code": "pm25",
          "displayName": "PM2.5",
          "fullName": "Fine particulate matter (\u003c2.5µm)",
          "concentration": {
            "value": 19.96,
            "units": "MICROGRAMS_PER_CUBIC_METER"
          },
          "additionalInfo": {
            "sources": "...",
            "effects": "..."
          }
        }
      ],
      "healthRecommendations": {
        "generalPopulation": "...",
        "lungDiseasePopulation": "...",
        "heartDiseasePopulation": "...",
        "athletes": "...",
        "pregnantWomen": "...",
        "children": "..."
      }
    },
    /.../
  ]
  }
  "regionCode": "us",
  "nextPageToken": "CjMKEglwCFVq9l5EQBH0aoDSUH9SwBoQCgYI1pDirgYSBgiGiOiuBiABKgMCBAMyAmVuOAEQGA=="
}

পূর্বাভাস তথ্যের পরবর্তী পৃষ্ঠা দেখতে, রেসপন্স বডির শেষে ফেরত আসা nextPageToken টি পাস করুন:

curl -X POST -d '{
    "universalAqi": "true",
    "location": {
        "latitude": "40.741895",
        "longitude": "-73.989308"
    },
    "period": {
        "startTime": "2024-02-27T13:58:14+02:00",
        "endTime": "2024-02-28T16:58:14+02:00"
    },
    "languageCode": "en",
    "extraComputations": [
        "HEALTH_RECOMMENDATIONS",
        "DOMINANT_POLLUTANT_CONCENTRATION",
        "POLLUTANT_ADDITIONAL_INFO"
    ],
    "uaqiColorPalette": "RED_GREEN",
    "pageToken": "CjMKEglwCFVq9l5EQBH0aoDSUH9SwBoQCgYI1pDirgYSBgiGiOiuBiABKgMCBAMyAmVuOAEQGA=="
}' \
-H "Content-Type: application/json" \
-H "Accept-Language: *" \
"https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"

এটি পূর্বাভাস তথ্যের পরবর্তী পৃষ্ঠাটি ফেরত দেয়:

{
  "hourlyForecasts": [
    {
      "dateTime": "2024-02-27T21:00:00Z",
      "indexes": [
        {
          "code": "uaqi",
          "displayName": "Universal AQI",
          "aqi": 74,
          "aqiDisplay": "74",
          "color": {
            "red": 0.44705883,
            "green": 0.78431374,
            "blue": 0.2
          },
          "category": "Good air quality",
          "dominantPollutant": "o3"
        }
      ],
      "pollutants": [
        {
          "code": "o3",
          "displayName": "O3",
          "fullName": "Ozone",
          "concentration": {
            "value": 32.07,
            "units": "PARTS_PER_BILLION"
          },
          "additionalInfo": {
            "sources": "...",
            "effects": "..."
          }
        }
      ],
      "healthRecommendations": {
        "generalPopulation": "...",
        "elderly": "...",
        "lungDiseasePopulation": "...",
        "heartDiseasePopulation": "...",
        "athletes": "...",
        "pregnantWomen": "...",
        "children": "..."
      }
    },
    {
      "dateTime": "2024-02-27T22:00:00Z",
      "indexes": [
        {
          "code": "uaqi",
          "displayName": "Universal AQI",
          "aqi": 75,
          "aqiDisplay": "75",
          "color": {
            "red": 0.43137255,
            "green": 0.7764706,
            "blue": 0.20392157
          },
          "category": "Good air quality",
          "dominantPollutant": "o3"
        }
      ],
      "pollutants": [
        {
          "code": "o3",
          "displayName": "O3",
          "fullName": "Ozone",
          "concentration": {
            "value": 30.94,
            "units": "PARTS_PER_BILLION"
          },
          "additionalInfo": {
            "sources": "...",
            "effects": "..."
          }
        }
      ],
      "healthRecommendations": {
        "generalPopulation": "...",
        "lungDiseasePopulation": "...",
        "heartDiseasePopulation": "...",
        "athletes": "...",
        "pregnantWomen": "...",
        "children": "..."
      }
    },
    /.../
  ]
  "regionCode": "us"
}

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

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

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