publicAlerts এন্ডপয়েন্টটি নির্ভরযোগ্য জাতীয় ও আন্তর্জাতিক সংস্থা কর্তৃক জারি করা নির্দিষ্ট আবহাওয়া সংক্রান্ত সতর্কবার্তার বিশদ বিবরণ প্রদান করে। এই সতর্কবার্তাগুলো অত্যন্ত গুরুত্বপূর্ণ এবং জীবন রক্ষাকারী তথ্য সরবরাহ করে।
এই এন্ডপয়েন্টটি একটি নির্দিষ্ট অক্ষাংশ এবং দ্রাঘিমাংশের জন্য রিয়েল-টাইমে ঘটা আবহাওয়ার সতর্কতা প্রদান করে। সমর্থিত আবহাওয়ার ঘটনাগুলোর মধ্যে নিম্নলিখিতগুলো অন্তর্ভুক্ত:
- বৃষ্টিপাত: বৃষ্টি, তুষারপাত, শিলাবৃষ্টি, খরা এবং আরও অনেক কিছু।
- চরম তাপমাত্রা: ঠান্ডা, গরম, হিম, তুষারপাত, শীতল বাতাস এবং আর্দ্রতা
- ঝড়ো হাওয়া ও ঝঞ্ঝা: তুষারঝড়, হারিকেন, টর্নেডো, ক্রান্তীয় ঝড়, বজ্রঝড় এবং আরও অনেক কিছু।
- দৃশ্যমানতার প্রতিবন্ধকতা: কুয়াশা, ধূলিঝড় এবং উড়ন্ত তুষার।
- জলবাহিত বিপদসমূহ: বন্যা, সুনামি, জলোচ্ছ্বাস, উপকূলীয় বিপদ এবং আরও অনেক কিছু।
- ভূ-ভৌত ও ভূতাত্ত্বিক ঘটনা: ভূমিকম্প, ভূমিধস এবং আগ্নেয়গিরির কার্যকলাপ
- অগ্নিকাণ্ড: দাবানল, অগ্নিকাণ্ডের উপযোগী আবহাওয়া এবং আরও অনেক কিছু
সমর্থিত আবহাওয়া ঘটনাগুলির সম্পূর্ণ তালিকার জন্য, আবহাওয়া ঘটনার প্রকারভেদ দেখুন।
ডেটা উৎস থেকে প্রাপ্ত তথ্যের উপর নির্ভর করে, সতর্কবার্তায় স্থানীয় বিবরণ থাকতেও পারে বা নাও থাকতে পারে। ডেটা উৎসের সীমাবদ্ধতার কারণে, তথ্যটি যেমন আছে তেমনই (কাঁচা বিষয়বস্তু) পরিবেশন করা হয়। আবহাওয়ার সতর্কবার্তার উৎস সম্পর্কে আরও তথ্যের জন্য, ডেটা উৎসসমূহ দেখুন।
প্রদত্ত আবহাওয়ার সতর্কতার জন্য এপিআই নিম্নলিখিত তথ্য ফেরত দেয়:
- সতর্কবার্তার সাথে সম্পর্কিত আবহাওয়ার ঘটনার ধরণ
- ক্ষতিগ্রস্ত এলাকাগুলোর একটি তালিকা এবং সেই এলাকাগুলোর ভৌগোলিক সীমানা নির্দেশকারী স্থানাঙ্ক।
- আবহাওয়ার ঘটনাটির এক বাক্যের সারাংশ
- গুরুত্ব, নিশ্চয়তা এবং জরুরি অবস্থার মাত্রা
- লক্ষ্য দর্শকদের জন্য করণীয় নির্দেশাবলীর বিবরণ
- নিরাপত্তা সুপারিশ
- সতর্কবার্তার শুরু এবং শেষের সময়
- প্রকাশনা কর্তৃপক্ষের নাম ও ওয়েবসাইট
এপিআই এক্সপ্লোরার আপনাকে সরাসরি অনুরোধ করার সুযোগ দেয়, যাতে আপনি এপিআই এবং এর অপশনগুলোর সাথে পরিচিত হতে পারেন:
আবহাওয়া সতর্কতা অনুরোধ সম্পর্কে
আবহাওয়ার সতর্কতা সংক্রান্ত তথ্য জানতে, এখানে একটি HTTP GET অনুরোধ পাঠান:
https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE
আপনার অনুরোধের URL প্যারামিটারগুলিতে অবস্থানটির অক্ষাংশ এবং দ্রাঘিমাংশের স্থানাঙ্ক অন্তর্ভুক্ত করুন।
আবহাওয়া সতর্কতা প্রতিক্রিয়া সম্পর্কে
ওয়েদার এপিআই রেসপন্স বডিতে নিম্নলিখিত ফিল্ডগুলো ফেরত দেয়:
| মাঠ | প্রকার | বর্ণনা | আবশ্যক বা ঐচ্ছিক |
|---|---|---|---|
alertId | স্ট্রিং | অ্যালার্ট আইডি। এটি ডেটা প্রদানকারীর ওয়েবসাইটেও পাওয়া যাবে। | প্রয়োজনীয় |
alertTitle | স্ট্রিং | সতর্কবার্তার শিরোনাম, যা আবহাওয়ার ঘটনাটির বর্ণনা দেয়। দ্রষ্টব্য: অনুরোধে ভাষা কোড প্যারামিটার অন্তর্ভুক্ত করা হলে শুধুমাত্র এই স্ট্রিংটিই অনুবাদ করা হয়। | প্রয়োজনীয় |
eventType | এনাম | সতর্কবার্তাটির সাথে সংশ্লিষ্ট আবহাওয়ার ঘটনার ধরণ। সমর্থিত আবহাওয়া ঘটনাগুলির সম্পূর্ণ তালিকার জন্য, আবহাওয়া ঘটনার প্রকারভেদ দেখুন। | প্রয়োজনীয় |
areaName | স্ট্রিং | সতর্কবার্তার আওতাভুক্ত ভৌগোলিক এলাকার নাম, যার মধ্যে অনুরোধকৃত অবস্থানটিও অন্তর্ভুক্ত। | প্রয়োজনীয় |
polygon | স্ট্রিং | সতর্কবার্তার একটি বদ্ধ মাত্রিক এলাকা নির্ধারণকারী স্থানাঙ্ক। | ঐচ্ছিক |
description | স্ট্রিং | একটি সংক্ষিপ্ত বাক্যাংশ যা নির্দিষ্ট ভাষায় ঘটনাটির বিবরণ তুলে ধরে (উদাহরণস্বরূপ, "টর্নেডো সতর্কতা")। | ঐচ্ছিক |
severity | এনাম | সতর্কবার্তাটির তীব্রতার মাত্রা:
| ঐচ্ছিক |
certainty | এনাম | সতর্কবার্তাটির নিশ্চয়তার মাত্রা:
| ঐচ্ছিক |
urgency | এনাম | সতর্কবার্তাটির জরুরি অবস্থার মাত্রা:
| ঐচ্ছিক |
instruction | স্ট্রিং | লক্ষ্য দর্শকদের জন্য প্রতিক্রিয়াশীল কর্ম নির্দেশাবলীর বিবরণ। | ঐচ্ছিক |
safetyRecommendations | স্ট্রিং | সরকারি কর্তৃপক্ষের বিধিমালার উপর ভিত্তি করে নিরাপত্তা সংক্রান্ত সুপারিশসমূহ। এতে শীর্ষ-স্তরের নির্দেশাবলী এবং অতিরিক্ত তথ্যসহ অন্তর্নিহিত অর্থ অন্তর্ভুক্ত রয়েছে। | ঐচ্ছিক |
timezoneOffset | স্ট্রিং | ইভেন্টটির টাইমজোন অফসেট, +/-HH:MM ফরম্যাটে। | প্রয়োজনীয় |
startTime | তারিখ ও সময় | সতর্কবার্তায় থাকা তথ্যের কার্যকর ইপক তারিখ ও সময় (ইউটিসি সময়)। | ঐচ্ছিক |
expirationTime | তারিখ ও সময় | যে ইপক তারিখ ও সময়ে (ইউটিসি সময়) একটি অ্যালার্ট শেষ হবে বলে আশা করা হচ্ছে। অনির্দিষ্টকালের জন্য চলমান ইভেন্টগুলোর ক্ষেত্রে এটি শূন্য হতে পারে, সেক্ষেত্রে শিরোনামে উল্লেখ করা থাকবে যে ইভেন্টটি "কার্যকর" রয়েছে। | ঐচ্ছিক |
dataSource | এনাম | প্রকাশক, নাম এবং ইউআরএল সহ কর্তৃপক্ষের বিবরণ। | প্রয়োজনীয় |
regionCode | এনাম | অনুরোধকৃত অবস্থানের অঞ্চল কোড। | ঐচ্ছিক |
ডেটা উৎস
আবহাওয়ার সতর্কতা এন্ডপয়েন্টটি নিম্নলিখিত সারণীতে তালিকাভুক্ত প্রদানকারীদের দ্বারা প্রকাশিত ডেটা ফেরত দেয়। অনুরোধে প্রদত্ত অক্ষাংশ এবং দ্রাঘিমাংশের স্থানাঙ্কের উপর ভিত্তি করে, প্রতিক্রিয়া অংশটি উপযুক্ত স্থানীয় কর্তৃপক্ষের ডেটা প্রদর্শন করে।
ফিডে অন্তর্ভুক্ত পরিষেবা প্রদানকারীরা গুগলের পাবলিক অ্যালার্ট নির্দেশিকা অনুসরণ করে। গুগল যেকোনো সময় পরিষেবা প্রদানকারীদের তালিকা হালনাগাদ করতে পারে।
অ্যাট্রিবিউশন
যেসব ডিসপ্লেতে ডেটা উপস্থাপন করা হয়, তার সবগুলিতেই কাস্টমার অ্যাপ্লিকেশনকে অবশ্যই ` dataSource ফিল্ড ব্যবহার করে মূল উৎসের একটি অ্যাট্রিবিউশন অন্তর্ভুক্ত করতে হবে:
"dataSource": {
"publisher": "NOAA",
"name": "National Weather Service",
"authorityUri": "https://www.weather.gov/"
}
অ্যাট্রিবিউশনে অবশ্যই ডেটা সোর্সের পুরো নাম ( name ফিল্ডে দেওয়া নাম অনুযায়ী) এবং authorityUri ফিল্ডে দেওয়া ইউআরএল ব্যবহার করে ডেটা সোর্সের হাইপারলিঙ্ক অন্তর্ভুক্ত করতে হবে (উদাহরণস্বরূপ, " National Weather Service ")।
আবহাওয়ার ঘটনার প্রকারভেদ
নিম্নলিখিত আবহাওয়ার ঘটনা প্রকারগুলি সমর্থিত:
| আবহাওয়ার ঘটনার প্রকারভেদ | |
|---|---|
ACID_RAINAVALANCHEBLIZZARDBLOWING_SNOWCOASTAL_FLOODCOASTAL_HAZARDCOLDCYCLONEDROUGHTEXTRATROPICAL_CYCLONEFIRE_WEATHERFLASH_FLOODFLOODFOGFREEZINGFREEZING_AIR_TEMPERATUREFREEZING_DRIZZLEFREEZING_RAINFROSTGALEGLAZEHAILHAZARDOUS_SEASHEATHUMIDITYHURRICANEICE_STORMLAKE_EFFECT_SNOWMONSOONMUDDY_FLOODOUTFLOWRAIN | RIVER_FLOODINGSEVERE_THUNDERSTORM_WARNINGSNOWSNOWSQUALLSTORMSTORM_SURGETHUNDERTHUNDERSTORMTORNADOTORNADO_WARNINGTROPICAL_CYCLONETROPICAL_CYCLONE_WARNINGS_AND_WATCHESTROPICAL_DISTURBANCETROPICAL_STORMTYPHOONWINDWIND_CHILLWIND_WAVEWINTER_STORMWILDFIREBUSHFIREFIRELANDSLIDEEARTHQUAKEDUST_STORMAFTERSHOCKTSUNAMIVOLCANIC_ASHVOLCANIC_ERUPTIONRADIATION |
প্রতিক্রিয়া অনুবাদ আচরণ
গুগল শুধুমাত্র alertTitle ফিল্ডের জন্য অনুবাদ প্রদান করে। মূল ডেটা সোর্সের ভাষা সমর্থনের উপর নির্ভর করে eventType , areaName , instruction , এবং safetyRecommendations এর মতো অন্যান্য ফিল্ডগুলোও অনূদিত হতে পারে; তবে, গুগল এই ফিল্ডগুলোর জন্য স্বতন্ত্র অনুবাদ প্রদান করতে পারে না।
অনুরোধে অন্তর্ভুক্ত languageCode প্যারামিটারের উপর ভিত্তি করে, alertTitle ফিল্ডের জন্য নিম্নলিখিত আচরণগুলো প্রত্যাশিত:
- সমর্থিত
languageCode: যদি অনুরোধ করাlanguageCodeপ্রদান করা হয় এবং তা সমর্থিত হয়, তাহলে প্রতিক্রিয়াটি অনুরোধ করা ভাষাতেই ফেরত দেওয়া হয়। - অসমর্থিত
languageCode: যেসব ক্ষেত্রে অনুরোধ করাlanguageCodeসমর্থিত নয় এবং এর কাছাকাছি কোনো বিকল্প খুঁজে পাওয়া যায় না, সেক্ষেত্রে এন্ডপয়েন্টটি ডিফল্টরূপে ইংরেজিতে প্রতিক্রিয়া ফেরত দেয়। - কোনো
languageCodeপ্রদান করা হয়নি: এন্ডপয়েন্টটি ডিফল্টরূপে ইংরেজিতে প্রতিক্রিয়া প্রদান করে।
আবহাওয়ার সতর্কতা অনুরোধের উদাহরণ
নিম্নলিখিত উদাহরণটিতে নর্থ ক্যারোলাইনার একটি শহরের জন্য আবহাওয়ার সতর্কতা সংক্রান্ত তথ্য জানতে চাওয়া হয়েছে:
curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635 &location.longitude=-78.3168047 &languageCode=en"
প্রতিক্রিয়ার মূল অংশটি নিম্নরূপ:
{ "weatherAlerts": [ { "alertId": "urn:oid:2.49.0.1.840.0.2416b1b5a6f51d29ef4b94948328dca303fbbb5c.001.1", "alertTitle": { "text": "Flash Flood Warning", "languageCode": "en" }, "eventType": "FLASH_FLOOD", "areaName": "Franklin, NC; Johnston, NC; Nash, NC; Wake, NC", "polygon": "{\"type\":\"Polygon\",\"coordinates\":[[[-78.450000,35.820000],[-78.410000,35.730000],[-78.280000,35.660000],[-78.180000,35.740000],[-77.840000,36.150000],[-77.890000,36.140000],[-77.900000,36.160000],[-77.920000,36.170000], [-77.930000,36.190000], [-77.940000,36.190000],[-77.950000,36.180000],[-77.970000,36.190000],[-77.970000,36.180000], [-77.980000,36.180000],[-78.010000,36.210000],[-78.040000,36.210000],[-78.110000,36.210000],[-78.130000,36.230000], [-78.350000,35.940000],[-78.450000,35.820000]]]}", "description": "FFWRAH\n\nThe National Weather Service in Raleigh has issued a\n\n* Flash Flood Warning for... \nEastern Franklin County in central North Carolina...\nNorth Central Johnston County in central North Carolina... \nWestern Nash County in central North Carolina...\nEast Central Wake County in central North Carolina... \n\n* Until 530 PM EDT.\n\n* At 224 PM EDT, local law enforcement reported flash flooding in\nSpring Hope. Between 3 and 5 inches of rain have fallen. \nAdditional rainfall amounts of 1 to 3 inches are possible in the\nwarned area.\n\nHAZARD...Life threatening flash flooding. Heavy rain producing\nflash flooding.\n\nSOURCE...Law enforcement reported.\n\nIMPACT...Life threatening flash flooding of creeks and streams,\nurban areas, highways, streets and underpasses.\n\n* Some locations that will experience flash flooding include... \nZebulon, Bunn, Wendell, Spring Hope, Middlesex, Castalia,\nCenterville, Pilot, Emit and Aventon.", "severity": "SEVERE", "certainty": "LIKELY", "urgency": "IMMEDIATE", "instruction": [ "Turn around, don't drown when encountering flooded roads. Most flood\ndeaths occur in vehicles." ], "safetyRecommendations": [ { "directive": "Build an emergency kit and make a family communications plan.", "subtext": "Follow the instructions at http://www.ready.gov/build-a-kit for building an emergency kit and http://www.ready.gov/make-a-plan for a family communications plan." }, { "directive": "Be aware that flash flooding can occur. ", "subtext": "If there is any possibility of a flash flood, move immediately to higher ground. Do not wait for instructions to move." }, ... ], "timezoneOffset": "-14400s", "startTime": "2025-08-06T18:24:00Z", "expirationTime": "2025-08-06T21:30:00Z", "dataSource": { "publisher": "NOAA", "name": "National Weather Service", "authorityUri": "https://www.weather.gov/" } } ], "regionCode": "US" }
চেষ্টা করে দেখুন!
এপিআই এক্সপ্লোরার আপনাকে নমুনা অনুরোধ করার সুযোগ দেয়, যাতে আপনি এপিআই এবং এর অপশনগুলোর সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডানদিকে থাকা API আইকনটি (api) নির্বাচন করুন।
ইচ্ছা হলে অনুরোধের প্যারামিটারগুলো সম্পাদনা করুন।
Execute বাটনটি নির্বাচন করুন। প্রদর্শিত ডায়ালগ বক্সে, অনুরোধটি করার জন্য আপনি যে অ্যাকাউন্টটি ব্যবহার করতে চান, সেটি বেছে নিন।
এপিআই এক্সপ্লোরার প্যানেলে, এপিআই এক্সপ্লোরার উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকনটি নির্বাচন করুন।