Package google.maps.airquality.v1

সূচক

এয়ার কোয়ালিটি

বায়ু মানের পরিষেবা।

লুকআপ কারেন্ট কন্ডিশন

rpc LookupCurrentConditions( LookupCurrentConditionsRequest ) returns ( LookupCurrentConditionsResponse )

বর্তমান অবস্থার এন্ডপয়েন্ট 100 টিরও বেশি দেশে 500 x 500 মিটার রেজোলিউশন পর্যন্ত প্রতি ঘণ্টায় বাতাসের মানের তথ্য সরবরাহ করে। 70 টিরও বেশি স্থানীয় সূচক এবং বিশ্বব্যাপী বায়ু মানের সূচক এবং বিভাগগুলি অন্তর্ভুক্ত করে।

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

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

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

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

Lookup Forecast

rpc LookupForecast( LookupForecastRequest ) returns ( LookupForecastResponse )

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

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

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

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

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

হিটম্যাপটাইল দেখুন

rpc LookupHeatmapTile( LookupHeatmapTileRequest ) returns ( HttpBody )

টাইল PNG চিত্রের ডেটা ধারণকারী একটি বাইট অ্যারে প্রদান করে।

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

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

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

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

লুকআপ হিস্ট্রি

rpc LookupHistory( LookupHistoryRequest ) returns ( LookupHistoryResponse )

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

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

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

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

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

এয়ার কোয়ালিটি ইনডেক্স

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

ক্ষেত্র
code

string

সূচক এর কোড. এই ক্ষেত্রটি স্পেস এর পরিবর্তে স্নেক কেস ব্যবহার করে প্রোগ্রামিং উদ্দেশ্যে সূচক উপস্থাপন করে। উদাহরণ: "uaqi", "fra_atmo"।

display_name

string

সূচক নামের একটি মানুষের পাঠযোগ্য উপস্থাপনা। উদাহরণ: "AQI (US)"

aqi_display

string

সূচক সাংখ্যিক স্কোরের পাঠ্য উপস্থাপনা, এতে উপসর্গ বা প্রত্যয় চিহ্ন অন্তর্ভুক্ত থাকতে পারে, যা সাধারণত সবচেয়ে খারাপ সূচক স্কোর প্রতিনিধিত্ব করে। উদাহরণ: >100 বা 10+।

দ্রষ্টব্য: আপনি যখন সূচক স্কোর প্রদর্শন করতে চান তখন এই ক্ষেত্রটি ব্যবহার করা উচিত। অ-সংখ্যাসূচক সূচকের জন্য, এই ক্ষেত্রটি খালি।

color

Color

AQI সাংখ্যিক স্কোর উপস্থাপন করতে ব্যবহৃত রঙ।

category

string

সূচক সংখ্যাসূচক স্কোর ব্যাখ্যা পাঠ্য শ্রেণীবিভাগ. উদাহরণস্বরূপ: "চমৎকার বায়ু গুণমান"।

dominant_pollutant

string

প্রভাবশালী দূষণকারী রাসায়নিক প্রতীক। যেমন: "CO"।

aqi

int32

সূচকের সংখ্যাসূচক স্কোর। উদাহরণ: 10, 100।

মান স্বাভাবিক করা হয় না এবং শুধুমাত্র তার সম্পর্কিত বায়ু-গুণমান সূচকের প্রসঙ্গে ব্যাখ্যা করা উচিত। অ-সংখ্যাসূচক সূচকের জন্য, এই ক্ষেত্রটি ফেরত দেওয়া হবে না।

দ্রষ্টব্য: এই ক্ষেত্রটি গণনা, গ্রাফ প্রদর্শন ইত্যাদির জন্য ব্যবহার করা উচিত। সূচক স্কোর প্রদর্শনের জন্য, আপনার AQI প্রদর্শন ক্ষেত্রটি ব্যবহার করা উচিত।

রঙ্গের পাত

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

Enums
COLOR_PALETTE_UNSPECIFIED ডিফল্ট মান। প্যারামিটার হিসাবে পাস করা হলে উপেক্ষা করা হয়।
RED_GREEN একটি লাল/সবুজ প্যালেট ব্যবহার করতে হবে কিনা তা নির্ধারণ করে।
INDIGO_PERSIAN_DARK একটি নীল/পার্সিয়ান প্যালেট (গাঢ় থিম) ব্যবহার করবেন কিনা তা নির্ধারণ করে।
INDIGO_PERSIAN_LIGHT একটি নীল/পার্সিয়ান প্যালেট (হালকা থিম) ব্যবহার করবেন কিনা তা নির্ধারণ করে।

CustomLocalAqi

একটি 'দেশ/অঞ্চল থেকে AQI' সম্পর্ক প্রকাশ করে। একটি কাঙ্খিত AQI এর সাথে একটি দেশ/অঞ্চল যুক্ত করে যাতে সেই দেশ/অঞ্চলের জন্য প্রয়োজনীয় বায়ু মানের ডেটা নির্বাচিত AQI অনুযায়ী প্রদর্শিত হবে।

ক্ষেত্র
region_code

string

যে দেশ/অঞ্চলে কাস্টম AQI প্রয়োজন। ISO 3166-1 আলফা-2 কোড ব্যবহার করে মান প্রদান করা উচিত।

aqi

string

দেশ/অঞ্চলের সাথে যুক্ত করার জন্য AQI। মান একটি বৈধ সূচক কোড হওয়া উচিত।

এক্সট্রা কম্পিউটেশন

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

Enums
EXTRA_COMPUTATION_UNSPECIFIED ডিফল্ট মান। এটি একটি প্যারামিটার হিসাবে পাস করা হলে সার্ভার এটি উপেক্ষা করে।
LOCAL_AQI

উত্তরে অনুরোধ করা অবস্থানের (দেশ) স্থানীয় (জাতীয়) AQI অন্তর্ভুক্ত করতে হবে কিনা তা নির্ধারণ করে।

যদি নির্দিষ্ট করা হয়, প্রতিক্রিয়াটিতে অবস্থানের স্থানীয় AQI-এর সমস্ত প্রাসঙ্গিক ডেটা সহ একটি 'এয়ার_গুণমান_সূচক' ডেটা কাঠামো থাকবে।

HEALTH_RECOMMENDATIONS

বর্তমান AQI অবস্থার জন্য প্রতিক্রিয়া স্বাস্থ্য পরামর্শ এবং সুপারিশকৃত পদক্ষেপগুলি অন্তর্ভুক্ত করবে কিনা তা নির্ধারণ করে।

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

যদি নির্দিষ্ট করা থাকে, প্রাসঙ্গিক ডেটা উপলব্ধ হলে health_recommendations ক্ষেত্রটি প্রতিক্রিয়াতে তৈরি করা হবে।

POLLUTANT_ADDITIONAL_INFO

প্রতিটি দূষণকারীর অতিরিক্ত তথ্য প্রতিক্রিয়াতে অন্তর্ভুক্ত করতে হবে কিনা তা নির্ধারণ করে।

যদি নির্দিষ্ট করা থাকে, 'সূচীপত্র' ক্ষেত্রের প্রতিক্রিয়াতে থাকা প্রতিটি বায়ুর গুণমান সূচক বস্তুতে ডেটা উপলব্ধ হলে একটি additional_info ক্ষেত্র অন্তর্ভুক্ত হবে।

DOMINANT_POLLUTANT_CONCENTRATION

বৈশ্বিক এবং/অথবা স্থানীয় সূচক অনুযায়ী পরিমাপ করা প্রভাবশালী দূষণকারীর ঘনত্বের প্রতিক্রিয়া অন্তর্ভুক্ত করবে কিনা তা নির্ধারণ করে।

যদি অনুরোধটি বিশ্বব্যাপী AQI এবং স্থানীয় AQI উভয়ই নির্দিষ্ট করে থাকে, তাহলে দুটি পর্যন্ত দূষণকারী কোড ফেরত দেওয়া হতে পারে।

যদি নির্দিষ্ট করা হয়, 'দূষণকারী' তালিকায় থাকা প্রভাবশালী দূষণকারী বস্তুতে একটি concentration ক্ষেত্র অন্তর্ভুক্ত হবে যখন ডেটা উপলব্ধ হবে।

POLLUTANT_CONCENTRATION

বৈশ্বিক এবং/অথবা স্থানীয় সূচক অনুসারে উপলব্ধ পরিমাপ সহ সমস্ত দূষণকারীর ঘনত্বের প্রতিক্রিয়া অন্তর্ভুক্ত করবে কিনা তা নির্ধারণ করে।

নির্দিষ্ট করা হলে, প্রতিক্রিয়ার 'দূষণকারী' ক্ষেত্রের মধ্যে থাকা প্রতিটি দূষণকারী বস্তুর মধ্যে একটি concentration ক্ষেত্র অন্তর্ভুক্ত থাকবে যখন ডেটা উপলব্ধ থাকবে।

স্বাস্থ্য সুপারিশ

একটি বিনামূল্যে পাঠ্য বিন্যাসে বিভিন্ন জনসংখ্যা গোষ্ঠীর জন্য স্বাস্থ্য সুপারিশ। সুপারিশগুলি তাদের সম্পর্কিত বায়ু মানের অবস্থা থেকে উদ্ভূত হয়।

ক্ষেত্র
general_population

string

কোন নির্দিষ্ট সংবেদনশীলতা.

elderly

string

অবসরপ্রাপ্ত এবং সাধারণ জনসংখ্যার চেয়ে বয়স্ক ব্যক্তিরা।

lung_disease_population

string

শ্বাসকষ্টজনিত সমস্যা ও হাঁপানিতে ভোগেন।

heart_disease_population

string

হার্ট এবং সংবহনতন্ত্রের রোগ।

athletes

string

খেলাধুলা এবং অন্যান্য কঠোর বহিরঙ্গন কার্যকলাপ.

pregnant_women

string

গর্ভাবস্থার সব পর্যায়ে নারী।

children

string

শিশু, ছোট বাচ্চা এবং শিশু সহ অল্পবয়সী জনগোষ্ঠী।

LookupCurrentConditionsRequest

বায়ু মানের বর্তমান অবস্থার অনুরোধ সংজ্ঞা.

ক্ষেত্র
location

LatLng

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

extra_computations[]

ExtraComputation

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

uaqi_color_palette

ColorPalette

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

custom_local_aqis[]

CustomLocalAqi

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

universal_aqi

bool

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

language_code

string

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

LookupCurrent Conditionsresponse

ক্ষেত্র
date_time

Timestamp

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

region_code

string

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

indexes[]

AirQualityIndex

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

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

Pollutant

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

health_recommendations

HealthRecommendations

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

LookupForecastRequest

বায়ু মানের পূর্বাভাস API এর অনুরোধ বস্তু।

ক্ষেত্র
location

LatLng

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

extra_computations[]

ExtraComputation

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

uaqi_color_palette

ColorPalette

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

custom_local_aqis[]

CustomLocalAqi

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

page_size

int32

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

page_token

string

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

ইউনিয়ন ক্ষেত্রের time_range । প্রয়োজনীয় বায়ু মানের পূর্বাভাসের ডেটার সময়সীমা। পরিসীমা ভবিষ্যতে অন্তত এক বৃত্তাকার ঘন্টা হতে হবে. এই ক্ষেত্রটি নির্দিষ্ট করতে ব্যর্থ হলে একটি INVALID_ARGUMENT ত্রুটি দেখা দেবে৷ time_range নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
date_time

Timestamp

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

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

period

Interval

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

universal_aqi

bool

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

language_code

string

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

LookupForecast Response

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

ক্ষেত্র
hourly_forecasts[]

HourlyForecast

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

region_code

string

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

next_page_token

string

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

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

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

ক্ষেত্র
date_time

Timestamp

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

indexes[]

AirQualityIndex

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

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

Pollutant

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

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

health_recommendations

HealthRecommendations

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

হিটম্যাপটাইল রিকোয়েস্ট দেখুন

একটি হিটম্যাপ টাইল অনুরোধ।

কাঠামোটি স্ট্যান্ডার্ড টাইল সার্ভার GET কলের সাথে মেনে চলে, যেমন https://airquality.googleapis.com/v1/mapTypes/{map_type}/heatmapTiles/{zoom}/{x}/{y}

উদাহরণ: https://airquality.googleapis.com/v1/mapTypes/BAQI_INDIGO_PERSIAN/heatmapTiles/1/1/1

ক্ষেত্র
map_type

MapType

প্রয়োজন। বাতাসের মানের হিটম্যাপের ধরন। মানচিত্র গ্রাফিকভাবে উপস্থাপন করবে এমন দূষণকারীকে সংজ্ঞায়িত করে।

Allowed values:
- UAQI_RED_GREEN (UAQI, red-green palette)
- UAQI_INDIGO_PERSIAN (UAQI, indigo-persian palette)
- PM25_INDIGO_PERSIAN
- GBR_DEFRA
- DEU_UBA
- CAN_EC
- FRA_ATMO
- US_AQI
zoom

int32

প্রয়োজন। মানচিত্রের জুম স্তর। মানচিত্র দৃশ্যে একটি মানচিত্রের বিষয়বস্তু কতটা বড় বা ছোট তা সংজ্ঞায়িত করে।

জুম লেভেল 0 হল একটি একক টাইলে সমগ্র বিশ্ব। জুম লেভেল 1 হল 4টি টাইলে সমগ্র বিশ্ব। জুম লেভেল 2 হল সমগ্র বিশ্ব 16টি টাইলস। জুম লেভেল 16 হল সমগ্র বিশ্ব 65,536টি টাইলস।

অনুমোদিত মান: 0-16

x

int32

প্রয়োজন। অনুরোধ করা টাইলে পূর্ব-পশ্চিম বিন্দু সংজ্ঞায়িত করে।

y

int32

প্রয়োজন। অনুরোধ করা টাইলে উত্তর-দক্ষিণ বিন্দু সংজ্ঞায়িত করে।

LookupHistoryRequest

এয়ার কোয়ালিটি হিস্ট্রি API-এর রিকোয়েস্ট অবজেক্ট।

ক্ষেত্র
page_size

int32

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

page_token

string

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

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

location

LatLng

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

extra_computations[]

ExtraComputation

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

uaqi_color_palette

ColorPalette

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

custom_local_aqis[]

CustomLocalAqi

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

ইউনিয়ন ক্ষেত্রের time_range । প্রয়োজনীয় বায়ু মানের ডেটার সময়সীমা। যেকোনো সময় সীমা সম্পর্কিত ক্ষেত্র নির্দিষ্ট করতে ব্যর্থ হলে একটি INVALID_ARGUMENT ত্রুটি দেখা দেবে৷ time_range নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: time_range নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
date_time

Timestamp

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

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

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

hours

int32

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

period

Interval

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

universal_aqi

bool

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

language_code

string

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

লুকআপ হিস্ট্রি রেসপন্স

ক্ষেত্র
hours_info[]

HourInfo

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

region_code

string

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

next_page_token

string

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

আওয়ার ইনফো

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

ক্ষেত্র
date_time

Timestamp

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

indexes[]

AirQualityIndex

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

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

Pollutant

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

health_recommendations

HealthRecommendations

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

মানচিত্রের ধরণ

বাতাসের মানের হিটম্যাপের ধরন। মানচিত্র গ্রাফিকভাবে উপস্থাপন করবে এমন দূষণকারীকে সংজ্ঞায়িত করে।

Enums
MAP_TYPE_UNSPECIFIED ডিফল্ট মান। এটি একটি প্যারামিটার হিসাবে পাস করা হলে সার্ভার এটি উপেক্ষা করে।
UAQI_RED_GREEN ইউনিভার্সাল এয়ার কোয়ালিটি ইনডেক্স লাল-সবুজ প্যালেট।
UAQI_INDIGO_PERSIAN ইউনিভার্সাল এয়ার কোয়ালিটি ইনডেক্স ইন্ডিগো-পার্সিয়ান প্যালেট।
PM25_INDIGO_PERSIAN PM2.5 সূচক নীল-পার্সিয়ান প্যালেট।
GBR_DEFRA দৈনিক এয়ার কোয়ালিটি ইনডেক্স (ইউকে) কালার প্যালেট।
DEU_UBA জার্মান স্থানীয় বায়ু গুণমান সূচক রঙ প্যালেট.
CAN_EC কানাডিয়ান এয়ার কোয়ালিটি হেলথ ইনডেক্স কালার প্যালেট।
FRA_ATMO ফ্রান্স এয়ার কোয়ালিটি ইনডেক্স কালার প্যালেট।
US_AQI ইউএস এয়ার কোয়ালিটি ইনডেক্স কালার প্যালেট।

দূষণকারী

বায়ু মানের দূষণকারী সম্পর্কিত ডেটা।

ক্ষেত্র
code

string

দূষণকারীর কোড নাম। যেমন: "so2"। সমস্ত উপলব্ধ কোডের একটি তালিকা এখানে পাওয়া যাবে।

display_name

string

দূষণকারীর প্রদর্শনের নাম। যেমন: "NOx"।

full_name

string

দূষণকারীর পুরো নাম। রাসায়নিক যৌগের জন্য, এটি IUPAC নাম। উদাহরণ: "সালফার ডাই অক্সাইড"।

IUPAC নামের সারণী সম্পর্কে আরও তথ্যের জন্য, https://iupac.org/what-we-do/periodic-table-of-elements/ দেখুন

concentration

Concentration

দূষণকারীর ঘনত্বের স্তর একটি আদর্শ বায়ু দূষণ পরিমাপ ইউনিট দ্বারা পরিমাপ করা হয়।

additional_info

AdditionalInfo

দূষণকারী সম্পর্কে অতিরিক্ত তথ্য।

অতিরিক্ত তথ্য

প্রদত্ত দূষণকারীর নির্গমন উত্স এবং স্বাস্থ্যের প্রভাব।

ক্ষেত্র
sources

string

দূষণকারীর প্রধান নির্গমন উৎসের প্রতিনিধিত্বকারী পাঠ্য।

effects

string

দূষণকারীর প্রধান স্বাস্থ্যের প্রভাবের প্রতিনিধিত্বকারী পাঠ্য।

একাগ্রতা

বাতাসে প্রদত্ত দূষণকারীর ঘনত্ব।

ক্ষেত্র
units

Unit

এই দূষণকারী ঘনত্ব পরিমাপের জন্য একক।

value

float

দূষণকারী ঘনত্বের মান।

ইউনিট

দূষণকারীর ঘনত্ব পরিমাপ করতে ব্যবহৃত একক সংজ্ঞায়িত করে।

Enums
UNIT_UNSPECIFIED অনির্দিষ্ট ঘনত্ব একক।
PARTS_PER_BILLION ppb (পার্টস পার বিলিয়ন) ঘনত্ব একক।
MICROGRAMS_PER_CUBIC_METER "µg/m^3" (মাইক্রোগ্রাম প্রতি ঘনমিটার) ঘনত্ব একক।