- HTTP অনুরোধ
- কোয়েরি প্যারামিটার
- অনুরোধের মূল অংশ
- প্রতিক্রিয়া মূল অংশ
- অনুমোদনের সুযোগ
- পূর্বাভাসদিন
- তারিখ
- পূর্বাভাসদিনভাগ
- সানইভেন্টস
- মুনইভেন্টস
- মুনফেজ
বর্তমান দিন থেকে শুরু করে, একটি নির্দিষ্ট স্থানে ১০ দিনের দৈনিক পূর্বাভাস প্রদান করে।
HTTP অনুরোধ
GET https://weather.googleapis.com/v1/forecast/days:lookup
URL টি gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
কোয়েরি প্যারামিটার
| পরামিতি | |
|---|---|
location | প্রয়োজনীয়। দৈনিক পূর্বাভাস পাওয়ার স্থান। |
unitsSystem | ঐচ্ছিক। ফেরত আসা আবহাওয়ার জন্য ব্যবহারযোগ্য ইউনিট সিস্টেম। যদি সরবরাহ না করা হয়, তাহলে ফেরত আসা আবহাওয়া মেট্রিক সিস্টেমে থাকবে (ডিফল্ট = METRIC)। |
pageSize | ঐচ্ছিক। প্রতি পৃষ্ঠায় সর্বোচ্চ কত দৈনিক পূর্বাভাস রেকর্ড ফেরত পাঠানো হবে - ১ থেকে ১০ (সমেত) পর্যন্ত একটি মান। ডিফল্ট মান হল ৫। |
pageToken | ঐচ্ছিক। পূর্ববর্তী অনুরোধ থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। এটি পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে ব্যবহৃত হয়। |
days | ঐচ্ছিক। বর্তমান দিন থেকে শুরু করে মোট কত দিন আনা হবে তা সীমিত করে - ১ থেকে ১০ পর্যন্ত একটি মান (সমেত)। ডিফল্ট মান হল সর্বোচ্চ অনুমোদিত মান ১০। |
languageCode | ঐচ্ছিক। ক্লায়েন্টকে প্রতিক্রিয়ার জন্য ভাষা বেছে নেওয়ার অনুমতি দেয়। যদি সেই ভাষার জন্য ডেটা সরবরাহ করা না যায়, তাহলে API সবচেয়ে কাছের মিল ব্যবহার করে। অনুমোদিত মানগুলি IETF BCP-47 স্ট্যান্ডার্ডের উপর নির্ভর করে। ডিফল্ট মান হল "en"। |
অনুরোধের মূল অংশ
অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।
প্রতিক্রিয়া মূল অংশ
দিনের জন্য প্রতিক্রিয়া। RPC দেখুন।
যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:
| JSON উপস্থাপনা |
|---|
{ "forecastDays": [ { object ( |
| ক্ষেত্র | |
|---|---|
forecastDays[] | অনুরোধে উল্লেখিত দিনের সংখ্যা এবং পৃষ্ঠার আকার অনুসারে দৈনিক পূর্বাভাস রেকর্ড করা হয়। |
timeZone | অনুরোধকৃত স্থানে সময় অঞ্চল। |
nextPageToken | পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করার জন্য টোকেন। |
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth স্কোপ প্রয়োজন:
-
https://www.googleapis.com/auth/cloud-platform
পূর্বাভাসদিন
একটি নির্দিষ্ট স্থানে দৈনিক পূর্বাভাসের রেকর্ড উপস্থাপন করে।
| JSON উপস্থাপনা |
|---|
{ "interval": { object ( |
| ক্ষেত্র | |
|---|---|
interval | এই পূর্বাভাসিত দিনটি যখন শুরু (সমেত) এবং শেষ (একচেটিয়া) হয় তখন UTC সময়ের ব্যবধান। দ্রষ্টব্য: একটি দিন স্থানীয় সময় সকাল ৭টায় শুরু হয় এবং পরের দিন সকাল ৭টায় শেষ হয়। উদাহরণস্বরূপ: যদি স্থানীয় সময় অঞ্চল UTC-7 হয়, তাহলে ব্যবধানটি |
displayDate | অবস্থানের সময় অঞ্চলের স্থানীয় তারিখ (সিভিল সময়) যার জন্য এই দৈনিক পূর্বাভাস গণনা করা হয়। এই ক্ষেত্রটি ক্লায়েন্টে প্রদর্শনের উদ্দেশ্যে ব্যবহার করা যেতে পারে। |
daytimeForecast | দিনের দিনের (স্থানীয় সময় সকাল ৭টা থেকে সন্ধ্যা ৭টা) আবহাওয়ার পূর্বাভাস। |
nighttimeForecast | দিনের রাতের অংশের (স্থানীয় সময় সন্ধ্যা ৭টা থেকে পরের দিন সকাল ৭টা) পূর্বাভাসিত আবহাওয়া পরিস্থিতি। |
maxTemperature | সারা দিনের সর্বোচ্চ (সর্বোচ্চ) তাপমাত্রা। |
minTemperature | সারা দিনের সর্বনিম্ন (সর্বনিম্ন) তাপমাত্রা। |
feelsLikeMaxTemperature | সারাদিনের সর্বোচ্চ (উচ্চ) তাপমাত্রা অনুভূত হওয়ার মতো। |
feelsLikeMinTemperature | সারাদিন সর্বনিম্ন (সর্বনিম্ন) তাপমাত্রা অনুভূত হওয়ার মতো। |
maxHeatIndex | সারা দিনের সর্বোচ্চ তাপ সূচক তাপমাত্রা। |
sunEvents | সূর্যের সাথে সম্পর্কিত ঘটনা (যেমন সূর্যোদয়, সূর্যাস্ত)। |
moonEvents | চাঁদের সাথে সম্পর্কিত ঘটনা (যেমন চন্দ্রোদয়, চন্দ্রাস্ত)। |
তারিখ
একটি পূর্ণাঙ্গ বা আংশিক ক্যালেন্ডার তারিখ প্রতিনিধিত্ব করে, যেমন জন্মদিন। দিনের সময় এবং সময় অঞ্চল হয় অন্য কোথাও নির্দিষ্ট করা আছে অথবা তাৎপর্যপূর্ণ নয়। তারিখটি গ্রেগরিয়ান ক্যালেন্ডারের সাথে সম্পর্কিত। এটি নিম্নলিখিতগুলির মধ্যে একটি প্রতিনিধিত্ব করতে পারে:
- একটি পূর্ণ তারিখ, যেখানে বছর, মাস এবং দিনের মান শূন্য নয়।
- একটি মাস এবং একটি দিন, যেখানে একটি শূন্য বছর (উদাহরণস্বরূপ, একটি বার্ষিকী)।
- একটি শূন্য মাস এবং একটি শূন্য দিন সহ একটি নিজস্ব বছর।
- একটি বছর এবং একটি মাস, শূন্য দিন সহ (উদাহরণস্বরূপ, একটি ক্রেডিট কার্ডের মেয়াদ শেষ হওয়ার তারিখ)।
সম্পর্কিত প্রকার:
-
google.type.TimeOfDay -
google.type.DateTime -
google.protobuf.Timestamp
| JSON উপস্থাপনা |
|---|
{ "year": integer, "month": integer, "day": integer } |
| ক্ষেত্র | |
|---|---|
year | তারিখের বছর। ১ থেকে ৯৯৯৯ পর্যন্ত হতে হবে, অথবা বছর ছাড়া তারিখ উল্লেখ করতে ০ হতে হবে। |
month | বছরের মাস। ১ থেকে ১২ পর্যন্ত হতে হবে, অথবা মাস এবং দিন ছাড়া বছর নির্দিষ্ট করতে ০ হতে হবে। |
day | মাসের দিন। ১ থেকে ৩১ পর্যন্ত হতে হবে এবং বছর এবং মাসের জন্য বৈধ হতে হবে, অথবা একটি বছর নির্দিষ্ট করার জন্য ০ হতে হবে, অথবা এমন একটি বছর এবং মাস যেখানে দিনটি গুরুত্বপূর্ণ নয়। |
পূর্বাভাসদিনভাগ
দিনের একটি অংশের পূর্বাভাসের রেকর্ড উপস্থাপন করে।
| JSON উপস্থাপনা |
|---|
{ "interval": { object ( |
| ক্ষেত্র | |
|---|---|
interval | দিনের এই অংশটি যখন শুরু হয় (অন্তর্ভুক্ত) এবং শেষ হয় (একচেটিয়া) তখন UTC তারিখ এবং সময়। দ্রষ্টব্য: দিনের একটি অংশ স্থানীয় সময় অনুসারে সকাল ৭টায় শুরু হয় এবং সন্ধ্যা ৭টায় শেষ হয়। উদাহরণস্বরূপ: যদি স্থানীয় সময় অঞ্চল UTC-7 হয়, তাহলে দিনের ব্যবধান |
weatherCondition | পূর্বাভাসিত আবহাওয়ার অবস্থা। |
precipitation | পূর্বাভাসিত বৃষ্টিপাত। |
wind | বাতাসের গড় দিক, সর্বোচ্চ গতি এবং ঝোড়ো হাওয়া। |
iceThickness | দিনের যে অংশে বরফ জমেছে। |
relativeHumidity | আপেক্ষিক আর্দ্রতার পূর্বাভাসিত শতাংশ (মান ০ থেকে ১০০ পর্যন্ত)। |
uvIndex | সর্বোচ্চ পূর্বাভাসিত অতিবেগুনী (UV) সূচক। |
thunderstormProbability | গড় বজ্রপাতের সম্ভাবনা। |
cloudCover | গড় মেঘাচ্ছন্নতার শতাংশ। |
সানইভেন্টস
সূর্যের সাথে সম্পর্কিত ঘটনাগুলি (যেমন সূর্যোদয়, সূর্যাস্ত) উপস্থাপন করে।
| JSON উপস্থাপনা |
|---|
{ "sunriseTime": string, "sunsetTime": string } |
| ক্ষেত্র | |
|---|---|
sunriseTime | সূর্য ওঠার সময়। দ্রষ্টব্য: কিছু অনন্য ক্ষেত্রে (যেমন আর্কটিক সার্কেলের উত্তরে) একদিনের জন্য সূর্যোদয়ের সময় নাও থাকতে পারে। এই ক্ষেত্রে, এই ক্ষেত্রটি সেট করা থাকবে না। RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: |
sunsetTime | সূর্য অস্ত যাওয়ার সময়। দ্রষ্টব্য: কিছু অনন্য ক্ষেত্রে (যেমন আর্কটিক সার্কেলের উত্তরে) একদিনের জন্য সূর্যাস্তের সময় নাও থাকতে পারে। এই ক্ষেত্রে, এই ক্ষেত্রটি সেট করা থাকবে না। RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: |
মুনইভেন্টস
চাঁদের সাথে সম্পর্কিত ঘটনাগুলি উপস্থাপন করে (যেমন চন্দ্রোদয়, চন্দ্রাস্ত)।
| JSON উপস্থাপনা |
|---|
{
"moonriseTimes": [
string
],
"moonsetTimes": [
string
],
"moonPhase": enum ( |
| ক্ষেত্র | |
|---|---|
moonriseTimes[] | যে সময় চাঁদের উপরের অংশ দিগন্তের উপরে দেখা যায় ( https://en.wikipedia.org/wiki/Moonrise_and_moonset দেখুন) । দ্রষ্টব্য: বেশিরভাগ ক্ষেত্রে, প্রতিদিন একটি মাত্র চাঁদ ওঠার সময় থাকবে। অন্যান্য ক্ষেত্রে, তালিকাটি খালি থাকতে পারে (যেমন পরের দিন মধ্যরাতের পরে যখন চাঁদ উঠবে)। তবে, অনন্য ক্ষেত্রে (যেমন মেরু অঞ্চলে), তালিকায় একাধিক মান থাকতে পারে। এই ক্ষেত্রে, মানগুলি ঊর্ধ্বমুখী ক্রমে সাজানো হয়। RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: |
moonsetTimes[] | যে সময় চাঁদের উপরের অংশ দিগন্তের নীচে অদৃশ্য হয়ে যায় ( https://en.wikipedia.org/wiki/Moonrise_and_moonset দেখুন) । দ্রষ্টব্য: বেশিরভাগ ক্ষেত্রে, প্রতিদিন একটি মাত্র চাঁদ অস্ত যাওয়ার সময় থাকবে। অন্যান্য ক্ষেত্রে, তালিকাটি খালি থাকতে পারে (যেমন পরের দিন মধ্যরাতের পরে যখন চাঁদ অস্ত যায়)। তবে, অনন্য ক্ষেত্রে (যেমন মেরু অঞ্চলে), তালিকায় একাধিক মান থাকতে পারে। এই ক্ষেত্রে, মানগুলি ঊর্ধ্বমুখী ক্রমে সাজানো হয়। RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: |
moonPhase | চন্দ্র পর্ব (যাকে চন্দ্র পর্বও বলা হয়)। |
মুনফেজ
চাঁদের পর্যায় (যাকে চন্দ্র পর্যায়ও বলা হয়) চিহ্নিত করে।
| এনামস | |
|---|---|
MOON_PHASE_UNSPECIFIED | অনির্দিষ্ট চাঁদের পর্যায়। |
NEW_MOON | চাঁদ সূর্যের আলোয় আলোকিত হয় না। |
WAXING_CRESCENT | উত্তর গোলার্ধে চাঁদের ডান দিকে ০%-৫০% এবং দক্ষিণ গোলার্ধে বাম দিকে ০%-৫০% আলো থাকে। |
FIRST_QUARTER | উত্তর গোলার্ধে চাঁদের ডান দিকে ৫০.১% এবং দক্ষিণ গোলার্ধে বাম দিকে ৫০.১% আলোকিত হয়। |
WAXING_GIBBOUS | চাঁদ উত্তর গোলার্ধে ডান দিকে ৫০%-১০০% এবং দক্ষিণ গোলার্ধে বাম দিকে 🌖 আলোকিত হয়। |
FULL_MOON | চাঁদ সম্পূর্ণরূপে আলোকিত। |
WANING_GIBBOUS | উত্তর গোলার্ধে চাঁদের বাম দিকে ৫০%-১০০% এবং দক্ষিণ গোলার্ধে ডান দিকে 🌔 আলোকিত হয়। |
LAST_QUARTER | উত্তর গোলার্ধে চাঁদের বাম দিকে ৫০.১% এবং দক্ষিণ গোলার্ধে ডান দিকে ৫০.১% আলোকিত হয় 🌓। |
WANING_CRESCENT | উত্তর গোলার্ধে চাঁদের বাম দিকে ০%-৫০% এবং দক্ষিণ গোলার্ধে ডান দিকে ০%-৫০% আলো থাকে। |