ম্যাপ ম্যানেজমেন্ট এপিআই হলো একটি RESTful এপিআই, যা ব্যবহার করে আপনি প্রোগ্রাম্যাটিকভাবে আপনার ক্লাউড-ভিত্তিক ম্যাপের স্টাইলিং রিসোর্সগুলো পরিচালনা করতে পারেন। এই এপিআই-এর সাহায্যে, আপনি ক্লাউড কনসোল ব্যবহার না করেই আপনার ম্যাপের ভিজ্যুয়াল চেহারা নির্ধারণ করতে, ম্যাপের পরিচিতি পরিচালনা করতে এবং নির্দিষ্ট ম্যাপ ভ্যারিয়েন্টের সাথে কাস্টম স্টাইল ও ডেটাসেট যুক্ত করতে পারবেন।
ম্যাপ ম্যানেজমেন্ট এপিআইটি এমন ডেভেলপারদের জন্য ডিজাইন করা হয়েছে, যারা ম্যাপ কনফিগারেশনের বৃহৎ পরিসরের ব্যবস্থাপনা করতে চান অথবা তাদের নিজস্ব স্বয়ংক্রিয় ওয়ার্কফ্লো এবং অভ্যন্তরীণ টুলগুলিতে ম্যাপ স্টাইলিং একীভূত করতে চান।
মূল সম্পদ
- StyleConfig : একটি ম্যাপ স্টাইলের JSON উপস্থাপনা ধারণ করে। এটি ম্যাপ ফিচারগুলির রং, দৃশ্যমানতা এবং ঘনত্ব নির্ধারণ করে।
- MapConfig : একটি অনন্য মানচিত্র পরিচয় (Map ID) উপস্থাপন করে। এটি স্টাইলিং সেটিংস এবং POI বুস্টিং বা বিল্ডিং ফ্ল্যাটেনিং-এর মতো ফিচারগুলোর জন্য একটি ধারক হিসেবে কাজ করে।
- MapContextConfig : একটি
MapConfigমধ্যে থাকা নির্দিষ্টMapVariantsসাথে একটিStyleConfig(এবং ঐচ্ছিকভাবে এক বা একাধিক Dataset)-কে সংযুক্ত করে।
এপিআই ভার্সনিং চ্যানেল
ম্যাপ ম্যানেজমেন্ট এপিআই পরীক্ষামূলক ফিচার থেকে স্থিতিশীল ও সাধারণ প্রাপ্যতার দিকে একটি সুস্পষ্ট পথ তৈরি করতে চ্যানেল-ভিত্তিক ভার্সনিং ব্যবহার করে।
- v2alpha (পরীক্ষামূলক) : এতে সর্বশেষ পরীক্ষামূলক ফিচারগুলো রয়েছে। এই চ্যানেলের ফিচারগুলো কোনো পূর্ব বিজ্ঞপ্তি ছাড়াই পরিবর্তিত হতে পারে এবং প্রোডাকশন ব্যবহারের জন্য এগুলো সুপারিশ করা হয় না।
- v2beta (প্রিভিউ) : এতে এমন সব ফিচার রয়েছে যা স্থিতিশীল এবং সর্বসাধারণের জন্য উপলব্ধ করার প্রস্তুতি চলছে। এই চ্যানেলটি প্রি-প্রোডাকশন পরিবেশে প্রাথমিক গ্রহণ এবং পরীক্ষার জন্য উপযুক্ত।
- v2 (সাধারণ প্রাপ্যতা) : এতে সম্পূর্ণরূপে সমর্থিত ও উৎপাদনের জন্য প্রস্তুত বৈশিষ্ট্যসমূহ রয়েছে।
v2-এর বেশিরভাগ ফিচার তাদের নিজ নিজ রোলআউট পর্যায়ে v2alpha এবং v2beta উভয় এন্ডপয়েন্টেই পাওয়া যায়। নতুন ব্যবহারকারীদের জন্য, গুগল v2beta এন্ডপয়েন্ট দিয়ে শুরু করার পরামর্শ দেয়।
প্রমাণীকরণ
আপনি ম্যাপ ম্যানেজমেন্ট এপিআই (Map Management API)-এর সাথে প্রমাণীকরণের জন্য শুধুমাত্র OAuth 2.0 ব্যবহার করতে পারবেন, যা এপিআই কী (API key) সমর্থন করে না। আরও তথ্যের জন্য, OAuth-এর ব্যবহার (Use OAuth) দেখুন।
সীমাবদ্ধতা
- ডেভেলপার ভূমিকা : ম্যাপ ম্যানেজমেন্ট এপিআই ব্যবহার করার জন্য, আপনার গুগল ক্লাউড প্রোজেক্টের মধ্যে গুগল ম্যাপস প্ল্যাটফর্ম রিসোর্সসমূহ পরিচালনা করার প্রয়োজনীয় আইএএম (IAM) অনুমতি থাকতে হবে।
- রিসোর্স স্কোপ : এই API-টি ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং রিসোর্স ব্যবস্থাপনার উপর আলোকপাত করে। অন্যান্য গুগল ম্যাপস প্ল্যাটফর্ম কনফিগারেশনের জন্য এখনও ক্লাউড কনসোলের প্রয়োজন হতে পারে।
খরচ
ম্যাপ ম্যানেজমেন্ট এপিআই ব্যবহারের জন্য কোনো চার্জ নেই। এপিআই কলগুলো ক্লাউড কনসোলের বিলিং পেজে দেখা যায়, কিন্তু এর জন্য কোনো চার্জ লাগবে না। তবে, অনুরোধগুলো নিম্নরূপভাবে সীমাবদ্ধ:
- ৩ কিউপিএস (কোয়েরি প্রতি সেকেন্ড)
- একটি প্রকল্পের জন্য প্রতি মিনিটে ১৮০টি কোয়েরি (QPM), যা প্রতি মিনিটে রিফ্রেশ করা হয়।
- একটি প্রকল্পের জন্য দৈনিক ১,০০,০০০ কোয়েরি (QPD), যা প্রতিদিন রিফ্রেশ করা হয়।
ব্যবহারবিধি ও বিলিং দেখুন।