Android ইউটিলিটি সেটআপের জন্য মানচিত্র SDK

এই পৃষ্ঠায় অ্যান্ড্রয়েডের জন্য ম্যাপস এসডিকে ইউটিলিটি লাইব্রেরিটি কীভাবে সেট আপ করতে হয় এবং এর অন্তর্ভুক্ত ডেমো অ্যাপটি কীভাবে চালাতে হয়, তা বর্ণনা করা হয়েছে।

পূর্বশর্ত এবং নোট

অ্যান্ড্রয়েডের জন্য ম্যাপস এসডিকে ইউটিলিটি লাইব্রেরিটি অ্যান্ড্রয়েড এপিআই লেভেল ১৫ এবং তার উপরের সংস্করণ সমর্থন করে। আপনার প্রোজেক্টের বিল্ড টার্গেট সেট করার সময়, সর্বশেষ অ্যান্ড্রয়েড এপিআই লেভেল ব্যবহার করা নিশ্চিত করুন।

রেফারেন্স ডকুমেন্টেশন গিটহাবে পাওয়া যাবে।

ধাপ ১. অ্যান্ড্রয়েডের জন্য ম্যাপস এসডিকে ইউটিলিটি লাইব্রেরিটি ইনস্টল করুন।

আপনার অ্যাপের 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("com.google.maps.android:android-maps-utils:3.19.0")
}

লাইব্রেরি থেকে মার্কার ক্লাস্টারিং , হিটম্যাপ বা অন্যান্য ইউটিলিটিগুলোর মধ্যে যেকোনো একটি ব্যবহার করুন।

ধাপ ২. (ঐচ্ছিক) অ্যান্ড্রয়েডের জন্য ম্যাপস এসডিকে ইউটিলিটি KTX লাইব্রেরিটি ইনস্টল করুন।

অ্যান্ড্রয়েডের জন্য ম্যাপস এসডিকে ইউটিলিটি লাইব্রেরির সাথে একটি সংশ্লিষ্ট কোটলিন এক্সটেনশন (KTX) লাইব্রেরি রয়েছে। এই লাইব্রেরিটি আপনাকে সংক্ষিপ্ত এবং প্রচলিত রীতি অনুযায়ী কোটলিন কোড লিখতে সক্ষম করার জন্য এক্সটেনশন ফাংশন, নেমড এবং ডিফল্ট আর্গুমেন্টের মতো কোটলিন ভাষার বৈশিষ্ট্য সরবরাহ করে। আপনি যদি কোটলিনে ডেভেলপ না করেন, তবে এই ধাপটি এড়িয়ে যেতে পারেন।

এই লাইব্রেরিটি ব্যবহার করতে, আপনার অ্যাপের build.gradle.kts ফাইলে android-maps-utils ডিপেন্ডেন্সির পাশাপাশি নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করুন:

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation(libs.maps.utils.ktx)
}

এই লাইব্রেরি সম্পর্কে আরও তথ্যের জন্য Maps KTX গিটহাব পেজটি দেখুন।

ধাপ ৩. অ্যান্ড্রয়েডের জন্য ম্যাপস এসডিকে ইউটিলিটি লাইব্রেরির সোর্স কোড দেখুন।

যেহেতু ইউটিলিটি লাইব্রেরিটি ওপেন সোর্স, আপনি এটিকে কাস্টমাইজ করতে, ডেমো অ্যাপ দেখতে, বা লাইব্রেরিটি কীভাবে কাজ করে তা বোঝার জন্য android-maps-utils লাইব্রেরিটি আপনার মেশিনে ডাউনলোড করতে পারেন। আপনি রিপোটি ক্লোন করে (স্বয়ংক্রিয় আপডেট পাওয়ার জন্য এটিই সুপারিশ করা হয়) অথবা একটি জিপ ফাইল ডাউনলোড করে এটি করতে পারেন। আপনি যদি লাইব্রেরিটি কাস্টমাইজ করতে চান, তবে আপনার রিপোটি ফর্ক করা উচিত।

রিপোজিটরিতে অন্তর্ভুক্ত রয়েছে:

• demo ডিরেক্টরিতে একটি ডেমো অ্যাপ্লিকেশন।
• ইউটিলিটিগুলির লাইব্রেরি, যা library ডিরেক্টরিতে অবস্থিত।
• লাইসেন্স, অবদানকারী এবং রিডমি তথ্য সম্বলিত বিভিন্ন ফাইল।
• অ্যান্ড্রয়েড স্টুডিও-তে ব্যবহারের জন্য গ্রেডল বিল্ড কনফিগারেশন।

ইউটিলিটি ডেমো অ্যাপটি চালান

ইউটিলিটি লাইব্রেরির গিটহাব রিপোজিটরিতে একটি ডেমো অ্যাপ রয়েছে, যাতে প্রতিটি ইউটিলিটির নমুনা বাস্তবায়ন অন্তর্ভুক্ত আছে। আপনার অ্যান্ড্রয়েড ডিভাইসে ডেমো অ্যাপটি চালানোর জন্য এই ধাপগুলো অনুসরণ করুন।

1. উপরে উল্লিখিত বিকল্পগুলির মধ্যে একটি ব্যবহার করে রিপোজিটরিটি ডাউনলোড করুন।
2. অ্যান্ড্রয়েড স্টুডিওতে, ফাইল -> নতুন -> প্রজেক্ট ইম্পোর্ট নির্বাচন করুন।
3. ইউটিলিটি লাইব্রেরিটি ক্লোন করার সময় তৈরি হওয়া android-maps-utils ডিরেক্টরিটি ব্রাউজ করে নির্বাচন করুন (ডাবল-ক্লিক করুন)। এখন অ্যান্ড্রয়েড স্টুডিও প্রজেক্টটি বিল্ড করবে।
4. আপনি যদি এমুলেটরের পরিবর্তে অ্যান্ড্রয়েড ডিভাইস ব্যবহার করেন, তাহলে ডেভেলপার মোড চালু করে নিন । এরপর অ্যান্ড্রয়েড ডিভাইসটি আপনার কম্পিউটারের সাথে সংযুক্ত করুন।

5. local.properties ফাইলে এইরকম একটি লাইন যোগ করুন:

   MAPS_API_KEY=YOUR_API_KEY

   যেখানে YOUR_API_KEY হলো সেই এপিআই কী যা আপনি "এপিআই কী ব্যবহার" অংশে বর্ণিত পদ্ধতি অনুসারে পেয়েছেন।

6. ডেমো অ্যাপটি বিল্ড ও রান করুন।

অ্যাপটি অ্যান্ড্রয়েড ডিভাইসে খুলবে এবং এতে ক্লাস্টারিং, পলিইউটিল, হিটম্যাপসহ আরও অনেক ইউটিলিটির একটি তালিকা দেখা যাবে। এছাড়াও আপনি আপনার অ্যাপ লিস্টে ‘Maps Utils Demo’ নামেও অ্যাপটি খুঁজে পেতে পারেন।