মিনিট পূর্বাভাস পান (পরীক্ষামূলক)

forecast:minutes এন্ডপয়েন্টটি একটি নির্দিষ্ট স্থানের জন্য উচ্চ-রেজোলিউশনের, মিনিট-প্রতি-মিনিটের বৃষ্টিপাতের পূর্বাভাস ( যা নাউকাস্টিং নামেও পরিচিত) প্রদান করে।

এপিআইটি ৬-ঘণ্টার সময়সীমার জন্য নিম্নলিখিত তথ্য প্রদান করে:

  • পূর্বাভাসের সময়সীমার শুরু এবং শেষের সময়
  • অনুরোধকৃত স্থানের সময় অঞ্চল
  • প্রতিটি পূর্বাভাস পর্বের শুরু এবং শেষের সময়
  • প্রতিটি পর্বে বৃষ্টিপাতের পূর্বাভাসিত ধরন, সম্ভাবনা, পরিমাণ এবং তীব্রতা

শর্তাবলী

এই শর্তাবলী, গুগল এবং আপনার সম্মতিক্রমে, গুগল ম্যাপস প্ল্যাটফর্ম পরিষেবা-নির্দিষ্ট শর্তাবলীর ধারা ৬ (প্রি-জিএ অফারিংস শর্তাবলী)-এর অধীনে জারি করা হয়েছে।

১.১ অ্যাট্রিবিউশন আবশ্যকতা। গ্রাহক যদি ওয়েদার এপিআই (Weather API) থেকে গুগল ম্যাপস কন্টেন্ট (Google Maps Content) ব্যবহার করেন, তবে তাকে অবশ্যই ডকুমেন্টেশন অনুযায়ী গুগলকে অ্যাট্রিবিউশন প্রদান করতে হবে।

১.২ সীমাবদ্ধতা। গ্রাহকরা ওয়েদার এপিআই (Weather API) থেকে প্রাপ্ত গুগল ম্যাপস কন্টেন্ট (Google Maps Content) ব্যবহার করে কোনো গুগল পরিষেবা বা পণ্য পুনরায় তৈরি করতে পারবেন না (যেমন, এমন কোনো ওয়েদার অ্যাপ বা ওয়েদার মডেলে ওয়েদার এপিআই থেকে প্রাপ্ত ডেটা ব্যবহার করা, যার প্রধান উদ্দেশ্য হলো আবহাওয়ার তথ্য প্রদান করা)।

১.৩ ক্যাশিং। গ্রাহকরা টেবিল ১.৩.১ (ক্যাশিং অনুমতি)-এ বর্ণিত প্রযোজ্য ক্যাশিং সময়কালের জন্য ওয়েদার এপিআই থেকে প্রযোজ্য গুগল ম্যাপস কন্টেন্ট সাময়িকভাবে ক্যাশ করতে পারেন।

সারণি ১.৩.১ (ক্যাশিং অনুমতিসমূহ)

এই অনুমতিগুলো গুগল ম্যাপস প্ল্যাটফর্ম পরিষেবা-সংক্রান্ত নির্দিষ্ট শর্তাবলীর সারণি ১৭.২.১- এ বর্ণিত অনুমতিগুলো ছাড়াও অতিরিক্ত।

গুগল ম্যাপস কন্টেন্ট ক্যাশিং সময়কাল
মিনিটের পূর্বাভাস মান এক ঘণ্টা পর গ্রাহককে অবশ্যই ক্যাশ করা গুগল ম্যাপস কন্টেন্ট মুছে ফেলতে হবে।

মিনিট পূর্বাভাস অনুরোধ সম্পর্কে

মিনিটের পূর্বাভাস জানতে, এখানে একটি HTTP GET অনুরোধ পাঠান:

https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE

আপনার অনুরোধের প্যারামিটারগুলিতে অবস্থানটির অক্ষাংশ এবং দ্রাঘিমাংশের স্থানাঙ্ক অন্তর্ভুক্ত করুন।

অনুরোধের পরামিতি

forecast.minutes এন্ডপয়েন্টটি নিম্নলিখিত অনুরোধ প্যারামিটারগুলি গ্রহণ করে:

প্যারামিটার বর্ণনা আবশ্যক বা ঐচ্ছিক
location.latitude অনুরোধকৃত অবস্থানের অক্ষাংশ স্থানাঙ্ক। প্রয়োজনীয়
location.longitude অনুরোধকৃত অবস্থানের দ্রাঘিমাংশ স্থানাঙ্ক। প্রয়োজনীয়
unitsSystem অনুরোধকৃত একক পদ্ধতি। মানগুলো হলো:
  • UNITS_SYSTEM_UNSPECIFIED
  • IMPERIAL
  • METRIC

একক পদ্ধতি নির্দিষ্ট করা না থাকলে, প্রতিক্রিয়াটি ডিফল্টরূপে METRIC হবে।

 ঐচ্ছিক
pageSize ফেরত দেওয়া ফলাফলের সর্বোচ্চ সংখ্যা নির্দিষ্ট করে। ঐচ্ছিক
pageToken A page token received from a previous request. To retrieve the next page of data, pass pageToken as an input parameter in the next request. ঐচ্ছিক

মিনিট পূর্বাভাস প্রতিক্রিয়া সম্পর্কে

ওয়েদার এপিআই রেসপন্স বডিতে নিম্নলিখিত ফিল্ডগুলো ফেরত দেয়:

মাঠ বর্ণনা
overallPredictionTimeframe পূর্বাভাসগুলোর সামগ্রিক সময়সীমা।
overallPredictionTimeframe.startTime পূর্বাভাস সময়সীমার শুরুর সময়। এটি প্রাথমিক নির্দেশক বিন্দুকে নির্দেশ করে।
overallPredictionTimeframe.endTime পূর্বাভাসের সময়সীমার শেষ সময়। এটি শুরুর সময়ের ছয় ঘণ্টা পরে নির্ধারণ করা হয়।
timeZone অনুরোধকৃত স্থানের সময় অঞ্চল।
segments মিনিট-স্তরের পূর্বাভাসের অংশগুলো, যা timeFrame দ্বারা চিহ্নিত করা হয়।
segments.timeFrame সেগমেন্টটির জন্য প্রাসঙ্গিক সময়সীমা।
segments.timeFrame.startTime অংশটির শুরুর সময়।
segments.timeFrame.endTime পর্বটির সমাপ্তির সময়।
segments.type ঐ সময়কালে পূর্বাভাসিত বৃষ্টিপাতের ধরণ। মানগুলো হলো:
  • DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED
  • NONE
  • RAIN
  • SNOW
  • HAIL
segments.probability ঐ সময়কালে বৃষ্টিপাতের পূর্বাভাসিত সম্ভাবনা। মানগুলো ০ থেকে ১০০ পর্যন্ত শতাংশে প্রকাশ করা হয়েছে।
segments.qpf পরিমাণগত বৃষ্টিপাতের পূর্বাভাস।
segments.qpf.quantity ঐ সময়কালে পূর্বাভাসিত বৃষ্টিপাতের পরিমাণ।
segments.qpf.unit সঞ্চিত বৃষ্টিপাতের পরিমাণ পরিমাপের একক (যেমন, MILLIMETERS , INCHES )।
segments.snowfallAmount ঐ সময়কালে তুষারপাতের পূর্বাভাসিত পরিমাণ।
segments.snowfallAmount.quantity ঐ সময়কালে পূর্বাভাসিত তুষারপাতের পরিমাণ (তরল জলের সমতুল্য হিসেবে)।
segments.snowfallAmount.unit জমে থাকা বরফের পরিমাণ পরিমাপের একক (যেমন, MILLIMETERS , INCHES )।
segments.intensity অংশটির বৃষ্টিপাতের তীব্রতা। মানগুলো হলো:
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • LIGHT
  • MODERATE
  • HEAVY
nextPageToken পরবর্তী পৃষ্ঠা আনার জন্য pageToken হিসেবে পাঠানো যায় এমন একটি টোকেন। এই ক্ষেত্রটি বাদ দিলে, পরবর্তী কোনো পৃষ্ঠা থাকবে না।

মিনিটের পূর্বাভাসের উদাহরণ

নিম্নলিখিত উদাহরণটিতে পশ্চিম ভার্জিনিয়ার একটি স্থানের জন্য মিনিটের পূর্বাভাসের তথ্য জানতে চাওয়া হয়েছে:

curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"

প্রতিক্রিয়ায়, segments অবজেক্টটি সামগ্রিক পূর্বাভাস সময়সীমার প্রতিটি অংশকে নির্দেশ করে:

  {
  "overallPredictionTimeframe": {
    "startTime": "2026-05-11T12:10:00Z",
    "endTime": "2026-05-11T18:12:00Z"
  },
  "timeZone": {
    "id": "America/New_York"
  },
  "segments": [
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:20:00Z",
        "endTime": "2026-05-11T12:22:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:22:00Z",
        "endTime": "2026-05-11T12:24:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    ...
  ]
}