publicAlerts
এন্ডপয়েন্ট,
কর্তৃত্বপূর্ণ জাতীয় এবং আন্তর্জাতিক এজেন্সির মাধ্যমে জারি করা নির্দিষ্ট আবহাওয়া ইভেন্ট সংক্রান্ত সতর্কতার বিবরণ প্রদান করে। এইসব সতর্কতা গুরুত্বপূর্ণ,
সম্ভাব্য জীবন রক্ষাকারী তথ্য প্রদান করে।
এন্ডপয়েন্ট, প্রদত্ত অক্ষাংশ ও দ্রাঘিমাংশের জন্য রিয়েল-টাইমে হওয়া আবহাওয়ার সতর্কতা রিটার্ন করে। নিম্নলিখিত আবহাওয়ার ইভেন্টগুলি কাজ করে:
- বৃষ্টিপাত: বৃষ্টি, তুষারপাত, শিলাবৃষ্টি, খরা এবং আরও অনেক কিছু
- চরম তাপমাত্রা: ঠান্ডা, গরম, জমে যাওয়া, তুষারপাত, ঠান্ডা হাওয়া এবং আর্দ্রতা
- বাতাস ও ঝড় সংক্রান্ত ইভেন্ট: তুষারঝড়, ঘূর্ণিঝড়, টর্নেডো, ক্রান্তীয় ঝড়, বজ্রবিদ্যুৎসহ ঝড় ও আরও অনেক কিছু
- দৃশ্যমানতা সংক্রান্ত সমস্যা: কুয়াশা, ধূলিঝড় ও তুষারপাত
- জল-সম্পর্কিত বিপদ: বন্যা, সুনামি, ঝড়ের কারণে জলোচ্ছ্বাস, উপকূলবর্তী বিপদ এবং আরও অনেক কিছু
- ভূ-প্রাকৃতিক ও ভূতাত্ত্বিক ঘটনা: ভূমিকম্প, ভূমিধস ও আগ্নেয়গিরির অ্যাক্টিভিটি
- অগ্নিকাণ্ড: দাবানল, আগুন লাগার মতো আবহাওয়া ও আরও অনেক কিছু
কাজ করে এমন আবহাওয়ার ইভেন্টের সম্পূর্ণ তালিকা দেখতে, আবহাওয়ার ইভেন্টের প্রকার দেখুন।
ডেটা সোর্স থেকে কী উপলভ্য আছে তার উপর নির্ভর করে, অ্যালার্টে স্থানীয় ভাষায় বিবরণ থাকতেও পারে বা নাও থাকতে পারে। ডেটা সোর্স সংক্রান্ত বিধিনিষেধের কারণে, তথ্যটি অপরিবর্তিত (কাঁচা কন্টেন্ট) হিসেবে পরিবেশন করা হয়। আবহাওয়া সংক্রান্ত সতর্কতা সোর্স সম্পর্কে আরও তথ্য পেতে, ডেটা সোর্স দেখুন।
API কোনও নির্দিষ্ট আবহাওয়ার অ্যালার্টের জন্য নিম্নলিখিত তথ্য রিটার্ন করে:
- সতর্কতার সাথে যুক্ত আবহাওয়ার ইভেন্টের ধরন
- প্রভাবিত এলাকার তালিকা এবং সেইসব এলাকার ভৌগোলিক সীমানা নির্ধারণকারী কোঅর্ডিনেট
- আবহাওয়ার ইভেন্টের এক বাক্যের সারসংক্ষেপ
- গুরুত্ব, নিশ্চিততা ও জরুরি অবস্থার লেভেল
- টার্গেট অডিয়েন্সের জন্য অ্যাকশন-সাজেস্ট করা নির্দেশাবলীর বিবরণ
- সুরক্ষা সংক্রান্ত সাজেশন
- সতর্কতার শুরু ও শেষের সময়
- প্রকাশক কর্তৃপক্ষের নাম ও ওয়েবসাইট
API এক্সপ্লোরার আপনাকে লাইভ অনুরোধ করতে দেয় যাতে আপনি API ও API বিকল্প সম্পর্কে পরিচিত হতে পারেন:
আবহাওয়ার সতর্কতা সংক্রান্ত অনুরোধ সম্পর্কে
আবহাওয়ার সতর্কতা সংক্রান্ত তথ্যের জন্য অনুরোধ করতে, এখানে HTTP GET অনুরোধ পাঠান:
https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE
আপনার অনুরোধে লোকেশনের অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক URL প্যারামিটার অন্তর্ভুক্ত করুন।
আবহাওয়ার সতর্কতা সম্পর্কিত উত্তরের ব্যাপারে
Weather API রেসপন্স বডিতে নিম্নলিখিত ফিল্ডগুলি দেখায়:
| ফিল্ড | ধরন | বিবরণ | প্রয়োজনীয় বা ঐচ্ছিক |
|---|---|---|---|
alertId |
স্ট্রিং | অ্যালার্ট আইডি। এটি ডেটা প্রদানকারীর ওয়েবসাইটেও পাওয়া যেতে পারে। | প্রয়োজনীয় |
alertTitle |
স্ট্রিং | আবহাওয়ার ইভেন্ট বর্ণনা করে এমন অ্যালার্টের শীর্ষক। মনে রাখবেন: অনুরোধে কোনও ভাষা কোড প্যারামিটার অন্তর্ভুক্ত করা হলে, এটিই একমাত্র স্ট্রিং যা অনুবাদ করা হয়। |
প্রয়োজনীয় |
eventType |
Enum | অ্যালার্টের সাথে যুক্ত আবহাওয়ার ইভেন্টের ধরন। কাজ করে এমন আবহাওয়ার ইভেন্টের সম্পূর্ণ তালিকা দেখতে, আবহাওয়ার ইভেন্টের ধরন দেখুন। |
প্রয়োজনীয় |
areaName |
স্ট্রিং | সতর্কতার দ্বারা প্রভাবিত ভৌগোলিক এলাকার নাম, যার মধ্যে অনুরোধ করা লোকেশন অন্তর্ভুক্ত। | প্রয়োজনীয় |
polygon |
স্ট্রিং | অ্যালার্টের বন্ধ ডাইমেনশনাল এলাকা নির্ধারণকারী স্থানাঙ্ক। | ঐচ্ছিক |
description |
স্ট্রিং | নির্দিষ্ট ভাষায় ইভেন্টের বিবরণকে সংক্ষিপ্তভাবে তুলে ধরে এমন একটি ছোট বাক্যাংশ (যেমন, "ঘূর্ণিঝড়ের সতর্কতা")। | ঐচ্ছিক |
severity |
Enum | সতর্কতার জন্য সিভিয়ারিটি লেভেল:
|
ঐচ্ছিক |
certainty |
Enum | সতর্কতা সম্পর্কে নিশ্চিত হওয়ার লেভেল:
|
ঐচ্ছিক |
urgency |
Enum | অ্যালার্টের জরুরি অবস্থা:
|
ঐচ্ছিক |
instruction |
স্ট্রিং | টার্গেট দর্শকদের জন্য রেসপন্সিভ অ্যাকশন সংক্রান্ত নির্দেশাবলীর বিবরণ। | ঐচ্ছিক |
safetyRecommendations |
স্ট্রিং | সরকারি কর্তৃপক্ষের কোডের উপর ভিত্তি করে নিরাপত্তা সংক্রান্ত সাজেশন। এতে অতিরিক্ত তথ্য সহ শীর্ষ-স্তরের নির্দেশাবলী এবং সাবটেক্স অন্তর্ভুক্ত থাকে। | ঐচ্ছিক |
timezoneOffset |
স্ট্রিং | ইভেন্টের টাইমজোন অফসেট, +/-HH:MM ফর্ম্যাটে। | প্রয়োজনীয় |
startTime |
DateTime | সতর্কতা মেসেজে থাকা তথ্যের কার্যকর Epoch তারিখ ও সময় (UTC সময়)। | ঐচ্ছিক |
expirationTime |
DateTime | কোনও সতর্কতা শেষ হওয়ার সম্ভাব্য তারিখ ও সময় (UTC সময়)। অনির্দিষ্টকালের জন্য দীর্ঘ ইভেন্টের ক্ষেত্রে এটি শূন্য হতে পারে, সেক্ষেত্রে শিরোনামে ইঙ্গিত করা হবে যে ইভেন্টটি "কার্যকর"। | ঐচ্ছিক |
dataSource |
Enum | প্রকাশক, নাম ও URL সহ কর্তৃপক্ষের বিবরণ। | প্রয়োজনীয় |
regionCode |
Enum | যে লোকেশন সম্পর্কে অনুরোধ করা হয়েছে সেটির অঞ্চল কোড। | ঐচ্ছিক |
ডেটা সোর্স
আবহাওয়ার অ্যালার্ট এন্ডপয়েন্ট, নিম্নলিখিত টেবিলে তালিকাভুক্ত প্রদানকারীদের দ্বারা প্রকাশিত ডেটা রিটার্ন করে। অনুরোধে উল্লিখিত অক্ষাংশ ও দ্রাঘিমাংশের কোঅর্ডিনেটের ভিত্তিতে, উত্তরের বডিতে উপযুক্ত স্থানীয় কর্তৃপক্ষের ডেটা দেখানো হয়।
ফিডে অন্তর্ভুক্ত থাকা প্রদানকারী Google-এর পাবলিক অ্যালার্ট নির্দেশিকা মেনে চলে। Google যেকোনও সময় পরিষেবা প্রদানকারীর তালিকা আপডেট করতে পারে।
অ্যাট্রিবিউশন
যেসব ডিসপ্লেতে ডেটা দেখানো হয়, সেখানে গ্রাহকের অ্যাপ্লিকেশনকে অবশ্যই
dataSource ফিল্ড ব্যবহার করে আসল সোর্সের অ্যাট্রিবিউশন অন্তর্ভুক্ত করতে হবে:
"dataSource": {
"publisher": "NOAA",
"name": "National Weather Service",
"authorityUri": "https://www.weather.gov/"
}
অ্যাট্রিবিউশনে ডেটা সোর্সের সম্পূর্ণ নাম (name ফিল্ডে
যেমন দেওয়া আছে) এবং
authorityUri ফিল্ডে দেওয়া URL ব্যবহার করে ডেটা সোর্সে হাইপারলিঙ্ক করতে হবে (যেমন, "ন্যাশনাল ওয়েদার
সার্ভিস")।
আবহাওয়ার ইভেন্টের ধরন
নিম্নলিখিত ধরনের আবহাওয়ার ইভেন্ট কাজ করে:
| আবহাওয়ার ইভেন্টের ধরন | |
|---|---|
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 |
উত্তর অনুবাদ করার আচরণ
Google শুধুমাত্র alertTitle ফিল্ডের জন্য অনুবাদ প্রদান করে। eventType, areaName, instruction ও safetyRecommendations-এর মতো অন্যান্য ফিল্ডও
অনুবাদ করা হতে পারে, তবে এটি মূল ডেটা সোর্সের ভাষা সংক্রান্ত সহায়তার উপর নির্ভর করে;
তবে, Google এইসব ফিল্ডের জন্য স্বতন্ত্র অনুবাদ প্রদান করতে পারে না।
অনুরোধে অন্তর্ভুক্ত 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 ও API বিকল্পগুলির সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডানদিকে API আইকন api বেছে নিন।
ঐচ্ছিকভাবে, অনুরোধের প্যারামিটার এডিট করুন।
এক্সিকিউট করুন বোতামটি বেছে নিন। ডায়ালগে, অনুরোধ করার জন্য আপনি যে অ্যাকাউন্ট ব্যবহার করতে চান সেটি বেছে নিন।
APIs Explorer প্যানেলে, APIs Explorer উইন্ডো বড় করতে ফুলস্ক্রিন আইকন ফুলস্ক্রিন বেছে নিন।