আবহাওয়ার মানচিত্র পান (পরীক্ষামূলক)

mapTypes এন্ডপয়েন্টটি বিভিন্ন আবহাওয়াগত ঘটনা, যেমন বৃষ্টিপাতের পূর্বাভাস, উপস্থাপনকারী রাস্টার ম্যাপ টাইলস প্রদান করে। এই ম্যাপ টাইলসগুলো সাধারণ গুগল ম্যাপের উপর স্থাপন করা যায়।

শর্তাবলী

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

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

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

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

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

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

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

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

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

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

মানচিত্রের প্রকারভেদ

ওয়েদার এপিআই বিভিন্ন ধরনের ওয়েদার ম্যাপ সমর্থন করে, যা বিভিন্ন অন্তর্নিহিত ওয়েদার মডেল এবং ভৌগোলিক এলাকার সাথে সঙ্গতিপূর্ণ:

  • US_PRECIPITATION_CURRENT : মার্কিন যুক্তরাষ্ট্রের বৃষ্টিপাতের উচ্চ-রেজোলিউশনের তাৎক্ষণিক পূর্বাভাস।
  • EU_PRECIPITATION_CURRENT : উচ্চ-রেজোলিউশনের ইউরোপীয় বৃষ্টিপাতের তাৎক্ষণিক পূর্বাভাস।

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

আবহাওয়ার মানচিত্রের টাইলস কভারেজ

টাইল স্থানাঙ্ক ব্যবস্থা

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

এই সিস্টেমে:

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

আবহাওয়ার মানচিত্র প্রদর্শন করুন

গুগল ম্যাপস জাভাস্ক্রিপ্ট এপিআই ব্যবহার করে কোনো ওয়েব অ্যাপ্লিকেশনে এই টাইলগুলো প্রদর্শন করতে, আপনি একটি কাস্টম 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 ।