এই পৃষ্ঠায় বর্ণনা করা হয়েছে যে কীভাবে Android-এর জন্য Maps SDK ইউটিলিটি লাইব্রেরি সেট-আপ করতে হয় এবং লাইব্রেরিতে অন্তর্ভুক্ত ডেমো অ্যাপ চালাতে হয়।
পূর্বশর্ত ও নোট
Android ইউটিলিটি লাইব্রেরির জন্য Maps SDK, Android API লেভেল ১৫ এবং তার পরবর্তী ভার্সনে কাজ করে। আপনার প্রোজেক্ট বিল্ড টার্গেট সেট করার সময়, লেটেস্ট Android API লেভেল ব্যবহার করছেন কিনা তা ভাল করে দেখে নিন।
GitHub-এ রেফারেন্স ডকুমেন্টেশন উপলভ্য।
ধাপ ১. Maps SDK for Android ইউটিলিটি লাইব্রেরি ইনস্টল করা
আপনার অ্যাপের build.gradle.kts ফাইলে নিম্নলিখিত ডিপেন্ডেন্সি যোগ করুন:
dependencies { // Utility Library for Maps SDK for Android // You do not need to add a separate dependency for the Maps SDK for Android // since this library builds in the compatible version of the Maps SDK. implementation(libs.android.maps.utils) }
লাইব্রেরি থেকে কোনও একটি ইউটিলিটি ব্যবহার করুন, যেমন মার্কার ক্লাস্টারিং, হিটম্যাপ অথবা অন্যান্য ইউটিলিটি।
ধাপ ২. (ঐচ্ছিক) Maps SDK for Android ইউটিলিটি KTX লাইব্রেরি ইনস্টল করুন
Maps SDK for Android ইউটিলিটি লাইব্রেরির সাথে একটি সংশ্লিষ্ট Kotlin এক্সটেনশন (KTX) লাইব্রেরি আসে। এই লাইব্রেরি Kotlin ভাষার ফিচার প্রদান করে—যেমন এক্সটেনশন ফাংশন, নামযুক্ত এবং ডিফল্ট আর্গুমেন্ট—যাতে আপনি সংক্ষিপ্ত এবং ইডিওমেটিক Kotlin লিখতে পারেন। আপনি Kotlin-এ ডেভেলপ না করলে, এই ধাপটি এড়িয়ে যেতে পারেন।
এই লাইব্রেরি ব্যবহার করতে, আপনার অ্যাপের build.gradle.kts ফাইলে, android-maps-utils ডিপেন্ডেন্সি ছাড়াও, নিম্নলিখিত ডিপেন্ডেন্সি যোগ করুন:
dependencies { // Maps SDK for Android Utility Library implementation(libs.android.maps.utils) }
এই লাইব্রেরি সম্পর্কে আরও তথ্য পেতে, Maps KTX GitHub পৃষ্ঠা দেখুন।
ধাপ ৩. Android ইউটিলিটি লাইব্রেরি সোর্স কোডের জন্য Maps SDK দেখুন
যেহেতু ইউটিলিটি লাইব্রেরি ওপেন সোর্স, তাই আপনি এটি কাস্টমাইজ করতে, ডেমো অ্যাপ দেখতে অথবা লাইব্রেরি কীভাবে কাজ করে তা বুঝতে চাইলে, আপনার মেশিনে android-maps-utils লাইব্রেরি ডাউনলোড করতে পারেন। আপনি এটি করতে পারেন, এর জন্য রেপো ক্লোন করুন (অটোমেটিক আপডেট পেতে, সাজেস্ট করা হয়েছে) অথবা একটি zip ফাইল ডাউনলোড করুন। আপনি লাইব্রেরি কাস্টমাইজ করতে চাইলে, আপনাকে রেপো ফর্ক করতে হবে।
রিপোজিটরিতে এগুলি অন্তর্ভুক্ত:
demoডিরেক্টরিতে একটি ডেমো অ্যাপ্লিকেশন।libraryডিরেক্টরিতে, ইউটিলিটির লাইব্রেরি।- লাইসেন্স, কন্ট্রিবিউটর ও রিডমি সংক্রান্ত তথ্য সহ বিভিন্ন ফাইল।
- Android Studio-র সাথে ব্যবহার করার জন্য Gradle বিল্ড কনফিগারেশন।
ইউটিলিটি ডেমো অ্যাপ রান করুন
ইউটিলিটি লাইব্রেরির জন্য GitHub রিপোজিটরি একটি ডেমো অ্যাপের সাথে আসে যাতে প্রতিটি ইউটিলিটির স্যাম্পেল ইমপ্লিমেন্টেশন অন্তর্ভুক্ত থাকে। আপনার Android ডিভাইসে ডেমো অ্যাপ চালাতে এইসব ধাপ অনুসরণ করুন।
- উপরে উল্লেখ করা বিকল্পগুলির মধ্যে একটি ব্যবহার করে রেপোজিটরি ডাউনলোড করুন।
- Android Studio-তে, ফাইল -> নতুন -> প্রজেক্ট ইমপোর্ট করুন বিকল্প বেছে নিন।
- ইউটিলিটি লাইব্রেরি ক্লোন করার সময় তৈরি হওয়া android-maps-utils ডিরেক্টরি ব্রাউজ করে বেছে নিন (ডবল-ক্লিক করুন)। Android Studio এখন প্রোজেক্ট তৈরি করে।
- আপনি এমুলেটরের পরিবর্তে Android ডিভাইস ব্যবহার করলে, এগুলি করতে ভুলবেন না: ডেভেলপার মোড চালু করুন। তারপর আপনার কম্পিউটারের সাথে Android ডিভাইসটি অ্যাটাচ করুন।
local.properties-এ একটি লাইন যোগ করুন যা দেখতে এইরকম:MAPS_API_KEY=YOUR_API_KEY
যেখানে YOUR_API_KEY হল API key যা আপনি API key ব্যবহার করা বিভাগে বর্ণিত পদ্ধতি অনুযায়ী পেয়েছেন।
- ডেমো অ্যাপ তৈরি করে রান করুন।
Android ডিভাইসে অ্যাপটি খুলে যাবে এবং ক্লাস্টারিং, পলিউটিল, হিটম্যাপ ও আরও অনেক কিছু সহ ইউটিলিটিগুলির একটি তালিকা দেখাবে। এছাড়াও, আপনি অ্যাপ তালিকায় Maps Utils Demo নামে অ্যাপটি খুঁজে পাবেন।