forecast.hours এন্ডপয়েন্টটি বর্তমান ঘন্টা থেকে শুরু করে একটি নির্দিষ্ট অবস্থানের জন্য ২৪০ ঘন্টা পর্যন্ত পূর্বাভাসের তথ্য প্রদান করে। এপিআইটি নিম্নলিখিত ফলাফল প্রদান করে:
- বর্তমান আবহাওয়ার অবস্থার বিবরণ এবং তার সাথে সংশ্লিষ্ট আইকন।
- বর্তমান তাপমাত্রা
- আপাত ("অনুভূত") তাপমাত্রা
- শিশির বিন্দু
- তাপ সূচক
- বাতাসের শীতলতা
- আর্দ্র বাল্ব তাপমাত্রা
- আপেক্ষিক আর্দ্রতা
- ইউভি সূচক
- বৃষ্টিপাতের সম্ভাবনা, শতাংশ এবং প্রকারভেদ
- বজ্রঝড়ের সম্ভাবনা
- সমুদ্রপৃষ্ঠের চাপ
- বাতাসের দিক , গতি এবং দমকা হাওয়া
- দৃশ্যমানতা এবং মেঘের আচ্ছাদন
এপিআই এক্সপ্লোরার আপনাকে সরাসরি অনুরোধ করার সুযোগ দেয়, যাতে আপনি এপিআই এবং এর অপশনগুলোর সাথে পরিচিত হতে পারেন:
ঘণ্টাভিত্তিক পূর্বাভাস অনুরোধ সম্পর্কে
ঘণ্টাভিত্তিক পূর্বাভাসের তথ্য জানতে, এখানে একটি HTTP GET অনুরোধ পাঠান:
https://weather.googleapis.com/v1/forecast/hours:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE
আপনার অনুরোধের URL প্যারামিটারগুলিতে অবস্থানটির অক্ষাংশ এবং দ্রাঘিমাংশের স্থানাঙ্ক অন্তর্ভুক্ত করুন।
ঘণ্টাভিত্তিক পূর্বাভাস অনুরোধের উদাহরণ
ডিফল্টরূপে, forecast.hours এন্ডপয়েন্টটি বর্তমান ঘন্টা থেকে শুরু করে ২৪০ ঘন্টার ডেটা ফেরত দেয়। আপনি hours প্যারামিটার ব্যবহার করে আপনার অনুরোধকে একটি নির্দিষ্ট সময়কালের মধ্যে সীমাবদ্ধ করতে পারেন।
নিম্নলিখিত উদাহরণটিতে ক্যালিফোর্নিয়ার মাউন্টেন ভিউ-এর জন্য পরবর্তী তিন ঘণ্টার ঘণ্টাভিত্তিক পূর্বাভাসের তথ্য জানতে চাওয়া হয়েছে:
curl -X GET "https://weather.googleapis.com/v1/forecast/hours:lookup?key=YOUR_API_KEY&location.latitude=37.4220 &location.longitude=-122.0841 &hours=3"
প্রতিক্রিয়ায়, interval অবজেক্টটি প্রতি ঘণ্টার তথ্য নির্দেশ করে:
{ "forecastHours": [ { "interval": { "startTime": "2025-02-05T23:00:00Z", "endTime": "2025-02-06T00:00:00Z" }, "displayDateTime": { "year": 2025, "month": 2, "day": 5, "hours": 15, "utcOffset": "-28800s" }, "isDaytime": true, "weatherCondition": { "iconBaseUri": "https://maps.gstatic.com/weather/v1/sunny", "description": { "text": "Sunny", "languageCode": "en" }, "type": "CLEAR" }, "temperature": { "degrees": 12.7, "unit": "CELSIUS" }, "feelsLikeTemperature": { "degrees": 12, "unit": "CELSIUS" }, "dewPoint": { "degrees": 2.7, "unit": "CELSIUS" }, "heatIndex": { "degrees": 12.7, "unit": "CELSIUS" }, "windChill": { "degrees": 12, "unit": "CELSIUS" }, "wetBulbTemperature": { "degrees": 7.7, "unit": "CELSIUS" }, "relativeHumidity": 51, "uvIndex": 1, "precipitation": { "probability": { "percent": 0, "type": "RAIN" }, "qpf": { "quantity": 0, "unit": "MILLIMETERS" } }, "thunderstormProbability": 0, "airPressure": { "meanSeaLevelMillibars": 1019.13 }, "wind": { "direction": { "degrees": 335, "cardinal": "NORTH_NORTHWEST" }, "speed": { "value": 10, "unit": "KILOMETERS_PER_HOUR" }, "gust": { "value": 19, "unit": "KILOMETERS_PER_HOUR" } }, "visibility": { "distance": 16, "unit": "KILOMETERS" }, "cloudCover": 0, "iceThickness": { "thickness": 0, "unit": "MILLIMETERS" } }, { "interval": { "startTime": "2025-02-06T00:00:00Z", "endTime": "2025-02-06T01:00:00Z" }, "displayDateTime": { "year": 2025, "month": 2, "day": 5, "hours": 16, "utcOffset": "-28800s" }, "isDaytime": true, "weatherCondition": { "iconBaseUri": "https://maps.gstatic.com/weather/v1/sunny", "description": { "text": "Sunny", "languageCode": "en" }, "type": "CLEAR" }, "temperature": { "degrees": 12.5, "unit": "CELSIUS" }, /.../ }, { "interval": { "startTime": "2025-02-06T01:00:00Z", "endTime": "2025-02-06T02:00:00Z" }, "displayDateTime": { "year": 2025, "month": 2, "day": 5, "hours": 17, "utcOffset": "-28800s" }, "isDaytime": true, "weatherCondition": { "iconBaseUri": "https://maps.gstatic.com/weather/v1/sunny", "description": { "text": "Sunny", "languageCode": "en" }, "type": "CLEAR" }, "temperature": { "degrees": 11.4, "unit": "CELSIUS" }, /.../ } ], "timeZone": { "id": "America/Los_Angeles" } }
প্রতি পৃষ্ঠার জন্য কত ঘন্টা পর পর ফিরবেন তা নির্দিষ্ট করুন।
আপনি pageSize URL প্যারামিটার ব্যবহার করে প্রতি পৃষ্ঠায় কত ঘণ্টার ডেটা দেখানো হবে তা নির্দিষ্ট করতে পারেন। এর ডিফল্ট মান হলো প্রতি পৃষ্ঠায় ২৪ ঘণ্টার পূর্বাভাসের তথ্য।
একাধিক পৃষ্ঠার তথ্য সম্বলিত রেসপন্সে একটি nextPageToken অন্তর্ভুক্ত থাকে। তথ্যের পরবর্তী পৃষ্ঠাটি দেখতে, আপনার রিকোয়েস্টের pageToken প্যারামিটারে nextPageToken এর ভ্যালুটি পাস করুন।
নিম্নলিখিত উদাহরণটিতে ক্যালিফোর্নিয়ার মাউন্টেন ভিউ-এর জন্য ২৫ ঘণ্টার আবহাওয়ার পূর্বাভাসের ডেটা অনুরোধ করা হয়েছে, যেখানে প্রতি পৃষ্ঠায় তিন ঘণ্টার ডেটা থাকবে:
curl -X GET "https://weather.googleapis.com/v1/forecast/hours:lookup?key=YOUR_API_KEY&location.latitude=37.4220 &location.longitude=-122.0841 &hours=25&pageSize=3"
প্রতিক্রিয়াটি, যাতে প্রথম তিন ঘণ্টার ডেটা অন্তর্ভুক্ত রয়েছে, তা নিম্নরূপ:
{ "forecastHours": [ { "interval": { "startTime": "2025-02-06T23:00:00Z", "endTime": "2025-02-07T00:00:00Z" }, "displayDateTime": { "year": 2025, "month": 2, "day": 6, "hours": 15, "utcOffset": "-28800s" }, "isDaytime": true, "weatherCondition": { "iconBaseUri": "https://maps.gstatic.com/weather/v1/showers", "description": { "text": "Rain showers", "languageCode": "en" }, "type": "RAIN_SHOWERS" }, "temperature": { "degrees": 14.6, "unit": "CELSIUS" }, /.../ }, { "interval": { "startTime": "2025-02-07T00:00:00Z", "endTime": "2025-02-07T01:00:00Z" }, "displayDateTime": { "year": 2025, "month": 2, "day": 6, "hours": 16, "utcOffset": "-28800s" }, "isDaytime": true, "weatherCondition": { "iconBaseUri": "https://maps.gstatic.com/weather/v1/drizzle", "description": { "text": "Light rain", "languageCode": "en" }, "type": "LIGHT_RAIN" }, "temperature": { "degrees": 14.4, "unit": "CELSIUS" }, /.../ }, { "interval": { "startTime": "2025-02-07T01:00:00Z", "endTime": "2025-02-07T02:00:00Z" }, "displayDateTime": { "year": 2025, "month": 2, "day": 6, "hours": 17, "utcOffset": "-28800s" }, "isDaytime": true, "weatherCondition": { "iconBaseUri": "https://maps.gstatic.com/weather/v1/cloudy", "description": { "text": "Cloudy", "languageCode": "en" }, "type": "CLOUDY" }, "temperature": { "degrees": 14.4, "unit": "CELSIUS" }, /.../ } ], "timeZone": { "id": "America/Los_Angeles" }, "nextPageToken": "ChYKEgm8dJMYBLZCQBH-ZffkYYVewBAZEAMYAyIMCLKClb0GEJeO18kDKhNBbWVyaWNhL0xvc19BbmdlbGVz" }
ডেটার পরবর্তী পৃষ্ঠা অ্যাক্সেস করতে, আপনার অনুরোধের pageToken প্যারামিটারে nextPageToken ভ্যালুটি পাস করুন:
curl -X GET "https://weather.googleapis.com/v1/forecast/hours:lookup?key=YOUR_API_KEY&location.latitude=37.4220 &location.longitude=-122.0841 &hours=25 &pageSize=3 &pageToken=ChYKEgm8dJMYBLZCQBH-ZffkYYVewBAZEAMYAyIMCLKClb0GEJeO18kDKhNBbWVyaWNhL0xvc19BbmdlbGVz"
উত্তরটি নিম্নরূপ:
{ "forecastHours": [ { "interval": { "startTime": "2025-02-07T02:00:00Z", "endTime": "2025-02-07T03:00:00Z" }, "displayDateTime": { "year": 2025, "month": 2, "day": 6, "hours": 18, "utcOffset": "-28800s" }, "isDaytime": false, "weatherCondition": { "iconBaseUri": "https://maps.gstatic.com/weather/v1/cloudy", "description": { "text": "Cloudy", "languageCode": "en" }, "type": "CLOUDY" }, "temperature": { "degrees": 14.3, "unit": "CELSIUS" }, /.../ }, { "interval": { "startTime": "2025-02-07T03:00:00Z", "endTime": "2025-02-07T04:00:00Z" }, "displayDateTime": { "year": 2025, "month": 2, "day": 6, "hours": 19, "utcOffset": "-28800s" }, "isDaytime": false, "weatherCondition": { "iconBaseUri": "https://maps.gstatic.com/weather/v1/showers", "description": { "text": "Rain showers", "languageCode": "en" }, "type": "RAIN_SHOWERS" }, "temperature": { "degrees": 14.2, "unit": "CELSIUS" }, /.../ }, { "interval": { "startTime": "2025-02-07T04:00:00Z", "endTime": "2025-02-07T05:00:00Z" }, "displayDateTime": { "year": 2025, "month": 2, "day": 6, "hours": 20, "utcOffset": "-28800s" }, "isDaytime": false, "weatherCondition": { "iconBaseUri": "https://maps.gstatic.com/weather/v1/showers", "description": { "text": "Rain showers", "languageCode": "en" }, "type": "RAIN_SHOWERS" }, "temperature": { "degrees": 14.1, "unit": "CELSIUS" }, /.../ } ], "timeZone": { "id": "America/Los_Angeles" }, "nextPageToken": "ChYKEgm8dJMYBLZCQBH-ZffkYYVewBAZEAYYBiILCPeDlb0GEICs5TMqE0FtZXJpY2EvTG9zX0FuZ2VsZXM=" }
চেষ্টা করে দেখুন!
এপিআই এক্সপ্লোরার আপনাকে নমুনা অনুরোধ করার সুযোগ দেয়, যাতে আপনি এপিআই এবং এর অপশনগুলোর সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডানদিকে থাকা API আইকনটি (api) নির্বাচন করুন।
ইচ্ছা হলে অনুরোধের প্যারামিটারগুলো সম্পাদনা করুন।
Execute বাটনটি নির্বাচন করুন। প্রদর্শিত ডায়ালগ বক্সে, অনুরোধটি করার জন্য আপনি যে অ্যাকাউন্টটি ব্যবহার করতে চান, সেটি বেছে নিন।
এপিআই এক্সপ্লোরার প্যানেলে, এপিআই এক্সপ্লোরার উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকনটি নির্বাচন করুন।