আবহাওয়ার ম্যাপ পাওয়া (এক্সপেরিমেন্টাল)

এই প্রোডাক্ট বা ফিচারটি পরীক্ষামূলক (প্রি-GA)। প্রি-GA প্রোডাক্ট ও ফিচারের ক্ষেত্রে সীমিত সহায়তা থাকতে পারে এবং প্রি-GA প্রোডাক্ট ও ফিচারে করা পরিবর্তন অন্যান্য প্রি-GA ভার্সনের সাথে মানানসই নাও হতে পারে। Pre-GA অফার Google Maps Platform পরিষেবার নির্দিষ্ট শর্তাবলী-এর আওতাভুক্ত। আরও তথ্যের জন্য, লঞ্চ স্টেজের বিবরণ দেখুন।

mapTypes এন্ডপয়েন্ট র‍্যাস্টার ম্যাপ টাইল প্রদান করে যা বিভিন্ন আবহাওয়ার ঘটনা দেখায়, যেমন বৃষ্টিপাতের পূর্বাভাস। এই ম্যাপ টাইলগুলি স্ট্যান্ডার্ড Google Maps-এর উপরে ওভারলে করা যেতে পারে।

মনে রাখবেন: forecast:minute এন্ডপয়েন্টের মাধ্যমে প্রদান করা ডেটার সাথে ওয়েদার ম্যাপ টাইল সিঙ্ক বা অ্যালাইন নাও হতে পারে।

শর্তাবলী

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

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

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

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

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

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

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

আবহাওয়ার ম্যাপ সংক্রান্ত অনুরোধ সম্পর্কে

আবহাওয়ার ম্যাপের জন্য অনুরোধ করতে, এখানে HTTP GET অনুরোধ পাঠান:

https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}

ম্যাপের ধরন

Weather API বিভিন্ন ধরনের আবহাওয়ার ম্যাপ সাপোর্ট করে, যা বিভিন্ন অন্তর্নিহিত আবহাওয়ার মডেল এবং ভৌগোলিক এলাকার সাথে সম্পর্কিত:

• US_PRECIPITATION_CURRENT: মার্কিন যুক্তরাষ্ট্রের হাই-রেজোলিউশন বৃষ্টিপাতের নাওকাস্ট।
• EU_PRECIPITATION_CURRENT: ইউরোপের হাই-রেজোলিউশন প্রেসিপিটেশন নাওকাস্ট।

নিচের কভারেজ ম্যাপে সেইসব অঞ্চল দেখানো হয়েছে যেখানে আবহাওয়ার ম্যাপ টাইল উপলভ্য:

টাইল স্থানাঙ্ক সিস্টেম

API স্ট্যান্ডার্ড ওয়েব মারকেটর টাইল স্থানাঙ্ক সিস্টেম ব্যবহার করে। ম্যাপ ও টাইল স্থানাঙ্কের বিস্তারিত ব্যাখ্যার জন্য, রোডম্যাপ টাইল এবং ম্যাপ ও টাইল স্থানাঙ্ক দেখুন।

এই সিস্টেমে:

• zoom: জুম লেভেল (০ থেকে ১৬)। জুম লেভেল ০ দিয়ে একটি টাইল (২^০ x ২^০ = ১টি টাইল) হিসেবে সমগ্র বিশ্বকে বোঝানো হয়। জুম লেভেল z পৃথিবীকে 2^z x 2^z টাইলসের গ্রিডে ভাগ করে।
• x: টাইলটির X কোঅর্ডিনেট (কলাম), যা ০ (সবচেয়ে পশ্চিমে) থেকে ২^zoom - ১ (সবচেয়ে পূর্বে) পর্যন্ত বিস্তৃত।
• y: টাইলসের Y কোঅর্ডিনেট (সারি), ০ (সবচেয়ে উত্তরে) থেকে 2^জুম - 1 (সবচেয়ে দক্ষিণে) পর্যন্ত।

আবহাওয়ার ম্যাপ দেখুন

Google Maps JavaScript API ব্যবহার করে কোনও ওয়েব অ্যাপ্লিকেশনে এইসব টাইল দেখাতে, আপনি কাস্টম google.maps.ImageMapType তৈরি করতে পারবেন:

const weatherMapType = new google.maps.ImageMapType({
  getTileUrl: function(coord, zoom) {
    const mapType = "US_PRECIPITATION_CURRENT";
    return `https://weather.googleapis.com/v1/mapTypes/${mapType}/mapTiles/${zoom}/${coord.x}/${coord.y}`;
  },
  tileSize: new google.maps.Size(256, 256),
  maxZoom: 16,
  minZoom: 0,
  name: "Weather"
});

// Overlay on existing map
map.overlayMapTypes.insertAt(0, weatherMapType);

আবহাওয়ার ম্যাপ সংক্রান্ত অনুরোধের উদাহরণ

নিম্নলিখিত উদাহরণে নিউ অরলিন্সের জন্য মার্কিন যুক্তরাষ্ট্রের বৃষ্টিপাত সংক্রান্ত আবহাওয়া ম্যাপ টাইলসের অনুরোধ করা হয়েছে:

curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"

উত্তরটি বাইনারি। JSON র‍্যাপার শুধুমাত্র নির্দিষ্ট সিরিয়ালাইজেশন সেটিংসে দেখা যায়, যেমন ?alt=json।