Method: forecast.lookup

একটি নির্দিষ্ট সময়ের জন্য একটি নির্দিষ্ট অবস্থানের জন্য বায়ু মানের পূর্বাভাস প্রদান করে।

HTTP অনুরোধ

POST https://airquality.googleapis.com/v1/forecast:lookup

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব 
{
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "pageSize": integer,
  "pageToken": string,
  "dateTime": string,
  "period": {
    object (Interval)
  }
  // End of list of possible types for union field time_range.
  "universalAqi": boolean,
  "languageCode": string
}
ক্ষেত্র
location

object ( LatLng )

প্রয়োজন। যে অক্ষাংশ এবং দ্রাঘিমাংশের জন্য API বায়ুর গুণমানের ডেটা খোঁজে৷

extraComputations[]

enum ( ExtraComputation )

ঐচ্ছিক। অতিরিক্ত বৈশিষ্ট্য যা ঐচ্ছিকভাবে সক্ষম করা যেতে পারে। অতিরিক্ত গণনা নির্দিষ্ট করার ফলে প্রাসঙ্গিক উপাদান এবং ক্ষেত্রগুলি প্রতিক্রিয়াতে ফিরে আসবে।

uaqiColorPalette

enum ( ColorPalette )

ঐচ্ছিক। 'ইউনিভার্সাল এয়ার কোয়ালিটি ইনডেক্স' (UAQI) দ্বারা প্রদত্ত ডেটার জন্য ব্যবহৃত রঙের প্যালেট নির্ধারণ করে। এই রঙের প্যালেটটি শুধুমাত্র UAQI-এর জন্য প্রাসঙ্গিক, অন্যান্য AQI-এর একটি পূর্বনির্ধারিত রঙ প্যালেট রয়েছে যা নিয়ন্ত্রণ করা যায় না।

customLocalAqis[]

object ( CustomLocalAqi )

ঐচ্ছিক। একটি 'দেশ/অঞ্চল থেকে AQI' সম্পর্ক প্রকাশ করে। একটি কাঙ্খিত AQI এর সাথে একটি দেশ/অঞ্চল যুক্ত করে যাতে সেই দেশ/অঞ্চলের জন্য প্রয়োজনীয় বায়ু মানের ডেটা নির্বাচিত AQI অনুযায়ী প্রদর্শিত হবে। এই প্যারামিটারটি একটি প্রদত্ত দেশের জন্য একটি নন-ডিফল্ট AQI নির্দিষ্ট করতে ব্যবহার করা যেতে পারে, উদাহরণস্বরূপ, কানাডার জন্য ডিফল্ট সূচকের পরিবর্তে কানাডার জন্য US EPA সূচক পেতে৷

pageSize

integer

ঐচ্ছিক। প্রতি পৃষ্ঠায় ফেরত দেওয়ার জন্য সর্বোচ্চ সংখ্যক ঘন্টায় তথ্য রেকর্ড (ডিফল্ট = 24)।

pageToken

string

ঐচ্ছিক। পূর্ববর্তী পূর্বাভাস কল থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। এটি পরবর্তী পৃষ্ঠা পুনরুদ্ধার করতে ব্যবহৃত হয়।

dateTime

string ( Timestamp format)

একটি টাইমস্ট্যাম্প যার জন্য নির্দিষ্ট সময়ে ডেটা ফেরত দিতে হয়। টাইমস্ট্যাম্প পূর্ববর্তী সঠিক ঘন্টায় বৃত্তাকার হয়।

এটি শুধুমাত্র অনুরোধ করা টাইমস্ট্যাম্পের জন্য প্রতি ঘন্টায় ডেটা প্রদান করবে (যেমন একটি একক ঘন্টায় তথ্য উপাদান)। উদাহরণস্বরূপ, একটি অনুরোধ পাঠানো হয়েছে যেখানে dateTime প্যারামিটার 2023-01-03T11:05:49Z তে সেট করা হয়েছে 2023-01-03T11:00:00Z-এ রাউন্ড ডাউন করা হবে।

দ্রষ্টব্য: একটি অনুরোধে dateTime বা startTime এবং endTime ব্যবহার করা যেতে পারে৷

period

object ( Interval )

পূর্বাভাসের ডেটা পেতে startTime এবং endTime সময়কাল নির্দেশ করে৷ endTime অন্তর্ভুক্ত। টাইমস্ট্যাম্প পূর্ববর্তী সঠিক ঘন্টায় বৃত্তাকার হয়।

দ্রষ্টব্য: একটি অনুরোধে dateTime বা startTime এবং endTime ব্যবহার করা যেতে পারে৷

universalAqi

boolean

ঐচ্ছিক। সত্যে সেট করা হলে, ইউনিভার্সাল AQI প্রতিক্রিয়ার 'সূচীপত্র' ক্ষেত্রে অন্তর্ভুক্ত করা হবে (ডিফল্ট = সত্য)।

languageCode

string

ঐচ্ছিক। ক্লায়েন্টকে প্রতিক্রিয়ার জন্য ভাষা বেছে নেওয়ার অনুমতি দেয়। যদি সেই ভাষার জন্য ডেটা সরবরাহ করা না যায় তবে API সবচেয়ে কাছের মিল ব্যবহার করে। অনুমোদিত মান IETF স্ট্যান্ডার্ডের উপর নির্ভর করে (ডিফল্ট = 'en')।

প্রতিক্রিয়া শরীর

বায়ু মানের পূর্বাভাস API এর প্রতিক্রিয়া বস্তু।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব 
{
  "hourlyForecasts": [
    {
      object (HourlyForecast)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
ক্ষেত্র
hourlyForecasts[]

object ( HourlyForecast )

ঐচ্ছিক। অনুরোধকৃত পরিসরে প্রতিটি ঘন্টার জন্য বাতাসের মানের তথ্য রয়েছে। উদাহরণস্বরূপ, যদি অনুরোধটি 48 ঘণ্টার পূর্বাভাসের জন্য হয় তাহলে প্রতি ঘণ্টার পূর্বাভাসের 48টি উপাদান থাকবে।

regionCode

string

ঐচ্ছিক। অনুরোধে প্রদত্ত অবস্থানের সাথে সংশ্লিষ্ট দেশ/অঞ্চলের ISO_3166-1 আলফা-2 কোড। এই ক্ষেত্রটি প্রতিক্রিয়া থেকে বাদ দেওয়া হতে পারে যদি অনুরোধে দেওয়া অবস্থানটি একটি বিতর্কিত অঞ্চলে থাকে।

nextPageToken

string

ঐচ্ছিক। পরবর্তী পৃষ্ঠা পুনরুদ্ধার করার টোকেন।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/cloud-platform

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

প্রতি ঘণ্টার পূর্বাভাস

অনুরোধকৃত পরিসরে প্রতিটি ঘন্টার জন্য বাতাসের মানের তথ্য রয়েছে। উদাহরণস্বরূপ, যদি অনুরোধটি 48 ঘণ্টার পূর্বাভাসের জন্য হয় তাহলে প্রতি ঘণ্টার পূর্বাভাসের 48টি উপাদান থাকবে।

JSON প্রতিনিধিত্ব 
{
  "dateTime": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
ক্ষেত্র
dateTime

string ( Timestamp format)

RFC3339 UTC "জুলু" ফরম্যাটে ডেটার উল্লেখ করার সময় (ঘন্টা) নির্দেশ করে একটি বৃত্তাকার ডাউন টাইমস্ট্যাম্প৷ যেমন: "2014-10-02T15:00:00Z"।

indexes[]

object ( AirQualityIndex )

অনুরোধের পরামিতিগুলির উপর ভিত্তি করে, এই তালিকায় (পর্যন্ত) দুটি বায়ু মানের সূচক অন্তর্ভুক্ত থাকবে:

  • ইউনিভার্সাল AQI। universalAqi আকি বুলিয়ান সত্যে সেট করা থাকলে ফেরত দেওয়া হবে।
  • স্থানীয় AQI। LOCAL_AQI অতিরিক্ত গণনা নির্দিষ্ট করা থাকলে ফেরত দেওয়া হবে।
pollutants[]

object ( Pollutant )

অনুরোধে উল্লিখিত অবস্থানকে প্রভাবিত করে এমন দূষণকারীদের একটি তালিকা৷

দ্রষ্টব্য: এই ক্ষেত্রটি শুধুমাত্র সেই অনুরোধগুলির জন্য ফেরত দেওয়া হবে যা নিম্নলিখিত অতিরিক্ত গণনার একটি বা একাধিক নির্দিষ্ট করেছে: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION৷

healthRecommendations

object ( HealthRecommendations )

রিপোর্ট করা বায়ু মানের অবস্থার সাথে সম্পর্কিত স্বাস্থ্য পরামর্শ এবং সুপারিশকৃত পদক্ষেপ। ঝুঁকিপূর্ণ জনসংখ্যা, দূষণকারীর প্রতি অধিক সংবেদনশীল গোষ্ঠী এবং সাধারণ জনসংখ্যার জন্য সুপারিশগুলি ভিন্নভাবে তৈরি করা হয়েছে।