মিনিট-ভিত্তিক পূর্বাভাস পাওয়া (এক্সপেরিমেন্টাল)

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

API ৬-ঘণ্টার টাইমফ্রেমের জন্য নিম্নলিখিত তথ্য রিটার্ন করে:

  • পূর্বাভাস সময়সীমার শুরু ও শেষ হওয়ার সময়
  • অনুরোধ করা লোকেশনের টাইম জোন
  • প্রতিটি পূর্বাভাস সেগমেন্টের শুরু ও শেষ হওয়ার সময়
  • প্রতিটি সেগমেন্টে বৃষ্টিপাতের পূর্বাভাসিত ধরন, সম্ভাবনা, পরিমাণ এবং তীব্রতা

শর্তাবলী

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

১.১ অ্যাট্রিবিউশন সংক্রান্ত প্রয়োজনীয়তা। গ্রাহক যদি Weather API থেকে Google Maps কন্টেন্ট ব্যবহার করেন, তাহলে গ্রাহককে ডকুমেন্টেশন অনুযায়ী Google-কে অ্যাট্রিবিউশন প্রদান করতে হবে।

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

১.৩ ক্যাশিং। গ্রাহকরা প্রযোজ্য ক্যাশিং পিরিয়ডের জন্য Weather API থেকে প্রযোজ্য Google Maps কন্টেন্ট সাময়িকভাবে ক্যাশে করতে পারেন, যেমনটি সারণী ১.৩.১ (ক্যাশিং সংক্রান্ত অনুমতি)-এ বর্ণনা করা হয়েছে।

টেবিল ১.৩.১ (ক্যাশিং সংক্রান্ত অনুমতি)

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

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

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

মিনিট-ভিত্তিক পূর্বাভাস পেতে, এখানে 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 আগের অনুরোধ থেকে পাওয়া একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠার ডেটা পেতে, পরবর্তী অনুরোধে ইনপুট প্যারামিটার হিসেবে pageToken পাস করুন। ঐচ্ছিক

মিনিট ভিত্তিক পূর্বাভাস সংক্রান্ত উত্তর সম্পর্কে

Weather API, উত্তরের বডিতে নিম্নলিখিত ফিল্ডগুলি রিটার্ন করে:

ফিল্ড বিবরণ
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"
    },
    ...
  ]
}