Method: history.lookup

একটি নির্দিষ্ট সময়সীমার জন্য একটি নির্দিষ্ট অবস্থানের জন্য বায়ু মানের ইতিহাস প্রদান করে।

HTTP অনুরোধ

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

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

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

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

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

integer

ঐচ্ছিক। প্রতি পৃষ্ঠায় ফেরার জন্য ঘন্টায় তথ্য রেকর্ডের সর্বোচ্চ সংখ্যা। ডিফল্ট হল 72 এবং সর্বোচ্চ মান হল 168 (7 দিনের ডেটা)।

pageToken

string

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

মনে রাখবেন যে এই প্যারামিটারের জন্য একটি মান প্রদান করার সময় প্রদত্ত অন্যান্য সমস্ত পরামিতি অবশ্যই পৃষ্ঠা টোকেন (আগের কল) প্রদানকারী কলের সাথে মেলে।

location

object ( LatLng )

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

extraComputations[]

enum ( ExtraComputation )

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

uaqiColorPalette

enum ( ColorPalette )

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

customLocalAqis[]

object ( CustomLocalAqi )

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

dateTime

string ( Timestamp format)

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

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

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z"।

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

hours

integer

1 থেকে 720 পর্যন্ত নম্বর যা অনুরোধের ঘন্টার পরিসীমা নির্দেশ করে৷ উদাহরণস্বরূপ: 48 এর একটি মান গত 48 ঘন্টার ডেটা প্রদান করবে।

period

object ( Interval )

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

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

universalAqi

boolean

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

languageCode

string

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

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

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

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

object ( HourInfo )

ঐচ্ছিক। অনুরোধকৃত পরিসরে প্রতিটি ঘন্টার জন্য বাতাসের মানের তথ্য রয়েছে। উদাহরণস্বরূপ, যদি অনুরোধটি 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। সার্বজনীন আকি বুলিয়ান সত্যে সেট করা থাকলে ফেরত দেওয়া হবে।
  • স্থানীয় AQI। LOCAL_AQI অতিরিক্ত গণনা নির্দিষ্ট করা থাকলে ফেরত দেওয়া হবে।
pollutants[]

object ( Pollutant )

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

healthRecommendations

object ( HealthRecommendations )

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