publicAlerts এন্ডপয়েন্টে জাতীয় এবং আন্তর্জাতিক সংস্থা কর্তৃক জারি করা নির্দিষ্ট আবহাওয়ার সতর্কতার বিশদ বিবরণ রয়েছে। এই সতর্কতাগুলি গুরুত্বপূর্ণ, সম্ভাব্য জীবন রক্ষাকারী তথ্য সরবরাহ করে।
এন্ডপয়েন্টটি একটি নির্দিষ্ট অক্ষাংশ এবং দ্রাঘিমাংশের জন্য রিয়েল টাইমে ঘটতে থাকা আবহাওয়ার সতর্কতা প্রদান করে। সমর্থিত আবহাওয়ার ইভেন্টগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
- বৃষ্টিপাত: বৃষ্টি, তুষার, শিলাবৃষ্টি, খরা এবং আরও অনেক কিছু
- চরম তাপমাত্রা: ঠান্ডা, তাপ, হিমশীতল, তুষারপাত, বাতাসের ঠান্ডা অবস্থা এবং আর্দ্রতা
- বাতাস এবং ঝড়ের ঘটনা: তুষারঝড়, হারিকেন, টর্নেডো, গ্রীষ্মমন্ডলীয় ঝড়, বজ্রঝড় এবং আরও অনেক কিছু
- দৃশ্যমানতার ব্যাঘাত: কুয়াশা, ধুলোঝড় এবং তুষারপাত
- পানি-সম্পর্কিত বিপদ: বন্যা, সুনামি, ঝড়ো হাওয়া, উপকূলীয় বিপদ এবং আরও অনেক কিছু
- ভূ-ভৌতিক এবং ভূতাত্ত্বিক ঘটনা: ভূমিকম্প, ভূমিধস এবং আগ্নেয়গিরির কার্যকলাপ
- অগ্নিকাণ্ডের ঘটনা: দাবানল, অগ্নিকাণ্ডের আবহাওয়া এবং আরও অনেক কিছু
সমর্থিত আবহাওয়া ইভেন্টের সম্পূর্ণ তালিকার জন্য, আবহাওয়া ইভেন্টের ধরণ দেখুন।
ডেটা উৎস থেকে কী পাওয়া যায় তার উপর নির্ভর করে সতর্কতাগুলিতে স্থানীয় বিবরণ থাকতে পারে বা নাও থাকতে পারে। ডেটা উৎসের সীমাবদ্ধতার কারণে, তথ্য যেমন আছে তেমন পরিবেশিত হয় (কাঁচা সামগ্রী)। আবহাওয়া সতর্কতা উৎস সম্পর্কে আরও তথ্যের জন্য, ডেটা উৎস দেখুন।
API একটি প্রদত্ত আবহাওয়া সতর্কতার জন্য নিম্নলিখিত তথ্য প্রদান করে:
- সতর্কতার সাথে সম্পর্কিত আবহাওয়ার ঘটনার ধরণ
- ক্ষতিগ্রস্ত এলাকার তালিকা এবং সেই এলাকার ভৌগোলিক সীমানা নির্ধারণকারী স্থানাঙ্ক।
- আবহাওয়ার ঘটনার এক বাক্যের সারসংক্ষেপ
- তীব্রতা, নিশ্চিততা এবং জরুরিতার স্তর
- লক্ষ্য দর্শকদের জন্য কর্ম-সুপারিশ নির্দেশাবলীর একটি বর্ণনা
- নিরাপত্তা সুপারিশ
- সতর্কতার জন্য শুরু এবং শেষের সময়
- প্রকাশনা কর্তৃপক্ষের নাম এবং ওয়েবসাইট
APIs Explorer আপনাকে লাইভ অনুরোধ করতে দেয় যাতে আপনি 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 প্যারামিটারে অবস্থানের অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক অন্তর্ভুক্ত করুন।
আবহাওয়ার সতর্কতার প্রতিক্রিয়া সম্পর্কে
ওয়েদার এপিআই রেসপন্স বডিতে নিম্নলিখিত ক্ষেত্রগুলি ফেরত দেয়:
| মাঠ | আদর্শ | বিবরণ | প্রয়োজনীয় অথবা ঐচ্ছিক |
|---|---|---|---|
alertId | স্ট্রিং | সতর্কতা আইডি। এটি ডেটা প্রদানকারীর ওয়েবসাইটেও পাওয়া যাবে। | প্রয়োজনীয় |
alertTitle | স্ট্রিং | সতর্কতার শিরোনাম, যা আবহাওয়ার ঘটনা বর্ণনা করে। দ্রষ্টব্য: অনুরোধে একটি ভাষা কোড প্যারামিটার অন্তর্ভুক্ত করা হলে এটিই একমাত্র স্ট্রিং যা অনুবাদ করা হয়। | প্রয়োজনীয় |
eventType | এনাম | সতর্কতার সাথে সম্পর্কিত আবহাওয়ার ঘটনার ধরণ। সমর্থিত আবহাওয়া ইভেন্টের সম্পূর্ণ তালিকার জন্য, আবহাওয়া ইভেন্টের ধরণ দেখুন। | প্রয়োজনীয় |
areaName | স্ট্রিং | সতর্কতা দ্বারা প্রভাবিত ভৌগোলিক এলাকার নাম, যার মধ্যে অনুরোধকৃত অবস্থান অন্তর্ভুক্ত। | প্রয়োজনীয় |
polygon | স্ট্রিং | সতর্কতার একটি বদ্ধ মাত্রিক ক্ষেত্র সংজ্ঞায়িত স্থানাঙ্ক। | ঐচ্ছিক |
description | স্ট্রিং | একটি ছোট বাক্যাংশ যা নির্দিষ্ট ভাষায় ঘটনার বর্ণনার সারসংক্ষেপ করে (উদাহরণস্বরূপ, "টর্নেডো সতর্কতা")। | ঐচ্ছিক |
severity | এনাম | সতর্কতার তীব্রতার মাত্রা:
| ঐচ্ছিক |
certainty | এনাম | সতর্কতার জন্য নিশ্চিততার স্তর:
| ঐচ্ছিক |
urgency | এনাম | সতর্কতার জন্য জরুরিতার স্তর:
| ঐচ্ছিক |
instruction | স্ট্রিং | লক্ষ্য দর্শকদের জন্য প্রতিক্রিয়াশীল কর্ম নির্দেশাবলীর বর্ণনা। | ঐচ্ছিক |
safetyRecommendations | স্ট্রিং | সরকারি কর্তৃপক্ষের কোডের উপর ভিত্তি করে নিরাপত্তা সুপারিশ। অতিরিক্ত তথ্য সহ শীর্ষ-স্তরের নির্দেশিকা এবং উপ-টেক্সট অন্তর্ভুক্ত। | ঐচ্ছিক |
timezoneOffset | স্ট্রিং | ইভেন্টের টাইমজোন অফসেট, +/-HH:MM ফর্ম্যাটে। | প্রয়োজনীয় |
startTime | তারিখ সময় | সতর্কতা বার্তায় তথ্যের কার্যকর যুগের তারিখ এবং সময় (UTC সময়)। | ঐচ্ছিক |
expirationTime | তারিখ সময় | যে যুগের তারিখ এবং সময় (UTC সময়) একটি সতর্কতা শেষ হওয়ার সম্ভাবনা রয়েছে। অনির্দিষ্টকালের জন্য দীর্ঘ ইভেন্টের জন্য এটি শূন্য হতে পারে, যে ক্ষেত্রে শিরোনামটি নির্দেশ করবে যে ইভেন্টটি "কার্যকর"। | ঐচ্ছিক |
dataSource | এনাম | প্রকাশক, নাম এবং URL সহ কর্তৃপক্ষের বিবরণ। | প্রয়োজনীয় |
regionCode | এনাম | যে স্থানের জন্য অনুরোধ করা হয়েছে তার অঞ্চল কোড। | ঐচ্ছিক |
তথ্য সূত্র
আবহাওয়া সতর্কতার শেষ বিন্দু নিম্নলিখিত সারণীতে তালিকাভুক্ত সরবরাহকারীদের দ্বারা প্রকাশিত ডেটা ফেরত দেয়। অনুরোধে প্রদত্ত অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্কের উপর ভিত্তি করে, প্রতিক্রিয়া সংস্থাটি উপযুক্ত স্থানীয় কর্তৃপক্ষের কাছ থেকে ডেটা প্রকাশ করে।
ফিডে অন্তর্ভুক্ত প্রোভাইডাররা গুগলের পাবলিক অ্যালার্ট নির্দেশিকা অনুসরণ করে। গুগল যেকোনো সময় প্রোভাইডারদের তালিকা আপডেট করতে পারে।
গুণাবলী
সমস্ত ডিসপ্লেতে যেখানে ডেটা উপস্থাপন করা হয়, গ্রাহক অ্যাপ্লিকেশনটিতে 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 |
প্রতিক্রিয়া অনুবাদ আচরণ
গুগল শুধুমাত্র 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" }
চেষ্টা করে দেখুন!
APIs Explorer আপনাকে নমুনা অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পগুলির সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডান দিকে API আইকন API নির্বাচন করুন।
ঐচ্ছিকভাবে অনুরোধের প্যারামিটারগুলি সম্পাদনা করুন।
এক্সিকিউট বোতামটি নির্বাচন করুন। ডায়ালগে, অনুরোধটি করার জন্য আপনি যে অ্যাকাউন্টটি ব্যবহার করতে চান তা নির্বাচন করুন।
APIs Explorer প্যানেলে, APIs Explorer উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকন ফুলস্ক্রিন নির্বাচন করুন।