Android Quickstart-এর জন্য মানচিত্র SDK

Android স্টুডিওর জন্য Google Maps Views টেমপ্লেট ব্যবহার করে একটি Android অ্যাপ তৈরি করুন যা একটি মানচিত্র প্রদর্শন করে। আপনার যদি একটি বিদ্যমান অ্যান্ড্রয়েড স্টুডিও প্রজেক্ট থাকে যা আপনি সেট আপ করতে চান, তাহলে একটি অ্যান্ড্রয়েড স্টুডিও প্রজেক্ট সেট আপ করুন দেখুন।

এই কুইকস্টার্টটি সেই ডেভেলপারদের জন্য যারা কোটলিন বা জাভা দিয়ে বেসিক অ্যান্ড্রয়েড ডেভেলপমেন্টের সাথে পরিচিত।

উন্নয়নের পরিবেশ সম্পর্কে

এই কুইকস্টার্টটি অ্যান্ড্রয়েড স্টুডিও হেজহগ এবং অ্যান্ড্রয়েড গ্রেডল প্লাগইন সংস্করণ 8.2 ব্যবহার করে তৈরি করা হয়েছে।

একটি Android ডিভাইস সেট আপ করুন

অ্যান্ড্রয়েডের জন্য মানচিত্র SDK ব্যবহার করে এমন একটি অ্যাপ চালানোর জন্য, আপনাকে অবশ্যই এটি একটি Android ডিভাইস বা Android এমুলেটরে স্থাপন করতে হবে যা Android 5.0 বা উচ্চতর সংস্করণের উপর ভিত্তি করে এবং Google API গুলি অন্তর্ভুক্ত করে৷

• একটি অ্যান্ড্রয়েড ডিভাইস ব্যবহার করতে, একটি হার্ডওয়্যার ডিভাইসে অ্যাপ চালান -এ নির্দেশাবলী অনুসরণ করুন।
• একটি অ্যান্ড্রয়েড এমুলেটর ব্যবহার করতে, আপনি একটি ভার্চুয়াল ডিভাইস তৈরি করতে পারেন এবং অ্যান্ড্রয়েড স্টুডিওর সাথে আসা অ্যান্ড্রয়েড ভার্চুয়াল ডিভাইস (এভিডি) ম্যানেজার ব্যবহার করে এমুলেটরটি ইনস্টল করতে পারেন।

অ্যান্ড্রয়েড স্টুডিওতে একটি Google মানচিত্র প্রকল্প তৈরি করুন

অ্যান্ড্রয়েড স্টুডিওতে একটি গুগল ম্যাপ প্রকল্প তৈরি করার পদ্ধতিটি ফ্ল্যামিঙ্গো এবং পরে অ্যান্ড্রয়েড স্টুডিওর রিলিজে পরিবর্তন করা হয়েছিল।

1. অ্যান্ড্রয়েড স্টুডিও খুলুন, এবং অ্যান্ড্রয়েড স্টুডিও উইন্ডোতে স্বাগতম নতুন প্রকল্পে ক্লিক করুন।

2. নতুন প্রজেক্ট উইন্ডোতে, ফোন এবং ট্যাবলেট বিভাগের অধীনে, কোন কার্যকলাপ নির্বাচন করুন এবং তারপরে পরবর্তী ক্লিক করুন।

3. নতুন প্রকল্প ফর্মটি পূরণ করুন:

   • জাভা বা কোটলিনে ভাষা সেট করুন। উভয় ভাষাই Android এর জন্য Maps SDK দ্বারা সম্পূর্ণরূপে সমর্থিত৷ কোটলিন সম্পর্কে আরও জানতে, কোটলিনের সাথে অ্যান্ড্রয়েড অ্যাপস ডেভেলপ করুন দেখুন।

   • আপনার টেস্ট ডিভাইসের সাথে সামঞ্জস্যপূর্ণ একটি SDK সংস্করণে ন্যূনতম SDK সেট করুন৷ আপনাকে অবশ্যই Android সংস্করণ 19.0.x এর জন্য Maps SDK-এর জন্য প্রয়োজনীয় ন্যূনতম সংস্করণের চেয়ে বড় সংস্করণ নির্বাচন করতে হবে, যা Android API স্তর 21 ("ললিপপ"; Android 5.0) বা উচ্চতর। SDK সংস্করণের প্রয়োজনীয়তার সর্বশেষ তথ্যের জন্য রিলিজ নোটগুলি দেখুন৷

   • কোটলিন ডিএসএল বা গ্রোভি ডিএসএল-এ বিল্ড কনফিগারেশন ভাষা সেট করুন। উভয় বিল্ড কনফিগারেশন ভাষার স্নিপেট নিম্নলিখিত পদ্ধতিতে দেখানো হয়েছে।

4. শেষ ক্লিক করুন.

   অ্যান্ড্রয়েড স্টুডিও গ্রেডল শুরু করে এবং প্রকল্প তৈরি করে। এতে কিছুটা সময় লাগতে পারে।

5. Google Maps Views কার্যকলাপ যোগ করুন:

   1. আপনার প্রজেক্টের app ফোল্ডারে রাইট-ক্লিক করুন।

   2. নতুন > Google > Google Maps Views কার্যকলাপ নির্বাচন করুন।

      

   3. নতুন অ্যান্ড্রয়েড অ্যাক্টিভিটি ডায়ালগ বক্সে, লঞ্চার অ্যাক্টিভিটি চেকবক্স নির্বাচন করুন।

   4. সমাপ্তি নির্বাচন করুন।

      আরও তথ্যের জন্য, একটি টেমপ্লেট থেকে কোড যোগ করুন দেখুন

6. নির্মাণ শেষ হলে, Android স্টুডিও AndroidManifest.xml এবং MapsActivity ফাইল খোলে। আপনার কার্যকলাপের একটি ভিন্ন নাম থাকতে পারে, কিন্তু এটি সেটআপের সময় আপনি কনফিগার করেছেন।

আপনার Google ক্লাউড প্রকল্প সেট আপ করুন

নিম্নলিখিত ট্যাবগুলিতে ক্লিক করে প্রয়োজনীয় ক্লাউড কনসোল সেটআপ পদক্ষেপগুলি সম্পূর্ণ করুন:

gcloud projects create "PROJECT"

gcloud services enable \
    --project "PROJECT" \
    "maps-android-backend.googleapis.com"

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

আপনার অ্যাপে API কী যোগ করুন

এই বিভাগটি বর্ণনা করে কিভাবে আপনার API কী সংরক্ষণ করতে হয় যাতে এটি আপনার অ্যাপ দ্বারা নিরাপদে উল্লেখ করা যায়। আপনার সংস্করণ নিয়ন্ত্রণ সিস্টেমে আপনার API কী চেক করা উচিত নয়, তাই আমরা এটিকে আপনার প্রকল্পের রুট ডিরেক্টরিতে অবস্থিত secrets.properties ফাইলে সংরক্ষণ করার পরামর্শ দিই। secrets.properties ফাইল সম্পর্কে আরও তথ্যের জন্য, Gradle বৈশিষ্ট্য ফাইলগুলি দেখুন।

এই কাজটি স্ট্রীমলাইন করতে, আমরা আপনাকে Android এর জন্য সিক্রেটস গ্রেডল প্লাগইন ব্যবহার করার পরামর্শ দিই।

আপনার Google মানচিত্র প্রকল্পে Android এর জন্য Secrets Gradle Plugin ইনস্টল করতে:

1. অ্যান্ড্রয়েড স্টুডিওতে, আপনার শীর্ষ-স্তরের build.gradle.kts বা build.gradle ফাইল খুলুন এবং buildscript অধীনে dependencies উপাদানে নিম্নলিখিত কোডটি যোগ করুন।

   কোটলিন

   buildscript {
       dependencies {
           classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1")
       }
   }

   গ্রোভি

   buildscript {
       dependencies {
           classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1"
       }
   }

2. আপনার মডিউল-স্তরের build.gradle.kts বা build.gradle ফাইল খুলুন এবং plugins উপাদানে নিম্নলিখিত কোড যোগ করুন।

   কোটলিন

   plugins {
       // ...
       id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
   }

   গ্রোভি

   plugins {
       // ...
       id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
   }

3. আপনার মডিউল-স্তরের build.gradle.kts বা build.gradle ফাইলে, নিশ্চিত করুন যে targetSdk এবং compileSdk 34-এ সেট করা আছে।
4. ফাইলটি সংরক্ষণ করুন এবং Gradle এর সাথে আপনার প্রকল্প সিঙ্ক করুন ।
5. আপনার শীর্ষ-স্তরের ডিরেক্টরিতে secrets.properties ফাইলটি খুলুন এবং তারপরে নিম্নলিখিত কোডটি যোগ করুন। আপনার API কী দিয়ে YOUR_API_KEY প্রতিস্থাপন করুন। এই ফাইলে আপনার কী সংরক্ষণ করুন কারণ secrets.properties একটি সংস্করণ নিয়ন্ত্রণ সিস্টেমে চেক করা থেকে বাদ দেওয়া হয়েছে৷

   MAPS_API_KEY=YOUR_API_KEY

6. ফাইলটি সংরক্ষণ করুন।

7. আপনার শীর্ষ-স্তরের ডিরেক্টরিতে local.defaults.properties ফাইল তৈরি করুন, secrets.properties ফাইলের মতো একই ফোল্ডার, এবং তারপরে নিম্নলিখিত কোডটি যোগ করুন।

   MAPS_API_KEY=DEFAULT_API_KEY

   এই ফাইলটির উদ্দেশ্য হল API কীটির জন্য একটি ব্যাকআপ অবস্থান প্রদান করা যদি secrets.properties ফাইলটি না পাওয়া যায় যাতে বিল্ডগুলি ব্যর্থ না হয়৷ এটি ঘটতে পারে যদি আপনি একটি সংস্করণ নিয়ন্ত্রণ সিস্টেম থেকে অ্যাপটিকে ক্লোন করেন যা secrets.properties বাদ দেয় এবং আপনি এখনও আপনার API কী প্রদান করার জন্য স্থানীয়ভাবে একটি secrets.properties ফাইল তৈরি করেননি।

8. ফাইলটি সংরক্ষণ করুন।
9. আপনার AndroidManifest.xml ফাইলে, com.google.android.geo.API_KEY এ যান এবং android:value attribute আপডেট করুন। যদি <meta-data> ট্যাগটি বিদ্যমান না থাকে, তাহলে এটিকে <application> ট্যাগের একটি চাইল্ড হিসেবে তৈরি করুন।

   <meta-data
       android:name="com.google.android.geo.API_KEY"
       android:value="${MAPS_API_KEY}" />

   দ্রষ্টব্য: com.google.android.geo.API_KEY হল API কী-এর জন্য প্রস্তাবিত মেটাডেটা নাম। Android এর জন্য Maps SDK সহ Android প্ল্যাটফর্মে একাধিক Google Maps-ভিত্তিক API-এ প্রমাণীকরণ করতে এই নামের একটি কী ব্যবহার করা যেতে পারে। পিছনের সামঞ্জস্যের জন্য, API com.google.android.maps.v2.API_KEY নামটিকেও সমর্থন করে। এই লিগ্যাসি নামটি শুধুমাত্র Android Maps API v2 তে প্রমাণীকরণের অনুমতি দেয়। একটি অ্যাপ্লিকেশন শুধুমাত্র API কী মেটাডেটা নামের একটি নির্দিষ্ট করতে পারে। উভয় নির্দিষ্ট করা থাকলে, API একটি ব্যতিক্রম নিক্ষেপ করে।

10. অ্যান্ড্রয়েড স্টুডিওতে, আপনার মডিউল-স্তরের build.gradle.kts বা build.gradle ফাইল খুলুন এবং secrets সম্পত্তি সম্পাদনা করুন। secrets সম্পত্তি বিদ্যমান না থাকলে, এটি যোগ করুন।

    secrets.properties এ propertiesFileName সেট করতে প্লাগইনের বৈশিষ্ট্যগুলি সম্পাদনা করুন, defaultPropertiesFileName to local.defaults.properties সেট করুন এবং অন্য কোনো বৈশিষ্ট্য সেট করুন।

    কোটলিন

    secrets {
        // To add your Maps API key to this project:
        // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
        // 2. Add this line, where YOUR_API_KEY is your API key:
        //        MAPS_API_KEY=YOUR_API_KEY
        propertiesFileName = "secrets.properties"
    
        // A properties file containing default secret values. This file can be
        // checked in version control.
        defaultPropertiesFileName = "local.defaults.properties"
    
        // Configure which keys should be ignored by the plugin by providing regular expressions.
        // "sdk.dir" is ignored by default.
        ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
        ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
    }
            

    গ্রোভি

    secrets {
        // To add your Maps API key to this project:
        // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
        // 2. Add this line, where YOUR_API_KEY is your API key:
        //        MAPS_API_KEY=YOUR_API_KEY
        propertiesFileName = "secrets.properties"
    
        // A properties file containing default secret values. This file can be
        // checked in version control.
        defaultPropertiesFileName = "local.defaults.properties"
    
        // Configure which keys should be ignored by the plugin by providing regular expressions.
        // "sdk.dir" is ignored by default.
        ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
        ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
    }
            

কোডটি দেখুন

টেমপ্লেট দ্বারা সরবরাহ করা কোড পরীক্ষা করুন. বিশেষ করে, আপনার অ্যান্ড্রয়েড স্টুডিও প্রকল্পের নিম্নলিখিত ফাইলগুলি দেখুন।

মানচিত্র কার্যকলাপ ফাইল

ম্যাপ অ্যাক্টিভিটি ফাইলটি অ্যাপের প্রধান অ্যাক্টিভিটি , এবং এতে ম্যাপ পরিচালনা ও প্রদর্শনের কোড থাকে। ডিফল্টরূপে, যে ফাইলটি কার্যকলাপ সংজ্ঞায়িত করে সেটির নাম MapsActivity.java বা আপনি যদি Kotlin কে আপনার অ্যাপের ভাষা হিসেবে সেট করেন, MapsActivity.kt ।

মানচিত্র কার্যকলাপের প্রধান উপাদান:

• SupportMapFragment অবজেক্ট মানচিত্রের জীবনচক্র পরিচালনা করে এবং অ্যাপের UI এর মূল উপাদান।

• GoogleMap অবজেক্ট ম্যাপ ডেটা এবং ভিউতে অ্যাক্সেস প্রদান করে। এটি Android এর জন্য Maps SDK-এর প্রধান ক্লাস। ম্যাপ অবজেক্ট গাইড আরও বিস্তারিতভাবে SupportMapFragment এবং GoogleMap অবজেক্টের বর্ণনা করে।

• moveCamera ফাংশনটি সিডনি অস্ট্রেলিয়ার LatLng স্থানাঙ্কে মানচিত্রকে কেন্দ্র করে। একটি মানচিত্র যোগ করার সময় কনফিগার করার প্রথম সেটিংস সাধারণত মানচিত্রের অবস্থান এবং ক্যামেরা সেটিংস হয়; যেমন দেখার কোণ, মানচিত্র অভিযোজন, এবং জুম স্তর। বিস্তারিত জানার জন্য ক্যামেরা এবং ভিউ নির্দেশিকা দেখুন।

• addMarker ফাংশন সিডনির জন্য স্থানাঙ্কে একটি মার্কার যোগ করে। বিস্তারিত জানার জন্য মার্কার গাইড দেখুন।

মডিউল গ্রেডল ফাইল

মডিউল build.gradle.kts ফাইলে নিম্নলিখিত মানচিত্র নির্ভরতা রয়েছে, যা Android এর জন্য Maps SDK-এর জন্য প্রয়োজনীয়।

dependencies {

    // Maps SDK for Android
    implementation("com.google.android.gms:play-services-maps:19.0.0")
}

মানচিত্র নির্ভরতা পরিচালনা সম্পর্কে আরও জানতে, সংস্করণ দেখুন।

XML লেআউট ফাইল

activity_maps.xml ফাইল হল XML লেআউট ফাইল যা অ্যাপের UI এর গঠন সংজ্ঞায়িত করে। ফাইলটি res/layout ডিরেক্টরিতে অবস্থিত। activity_maps.xml ফাইল একটি খণ্ড ঘোষণা করে যা নিম্নলিখিত উপাদানগুলিকে অন্তর্ভুক্ত করে:

• tools:context MapsActivity তে খণ্ডটির ডিফল্ট কার্যকলাপ সেট করে, যা মানচিত্র কার্যকলাপ ফাইলে সংজ্ঞায়িত করা হয়।
• android:name ফ্র্যাগমেন্টের ক্লাসের নাম SupportMapFragment এ সেট করে, যা ম্যাপ অ্যাক্টিভিটি ফাইলে ব্যবহৃত ফ্র্যাগমেন্টের ধরন।

XML লেআউট ফাইলে নিম্নলিখিত কোড রয়েছে:

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/map"
    android:name="com.google.android.gms.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MapsActivity" />

অ্যাপটি স্থাপন করুন এবং চালান

আপনি যখন অ্যাপটি সফলভাবে চালাবেন, তখন এটি একটি মানচিত্র প্রদর্শন করবে যা সিডনি অস্ট্রেলিয়াকে কেন্দ্র করে শহরের একটি মার্কার সহ নিম্নলিখিত স্ক্রিনশটে দেখা যাবে।

অ্যাপটি স্থাপন এবং চালানোর জন্য:

1. অ্যান্ড্রয়েড স্টুডিওতে, আপনার অ্যাপ চালানোর জন্য রান মেনু বিকল্পে (বা প্লে বোতাম আইকন) ক্লিক করুন।
2. একটি ডিভাইস চয়ন করার জন্য অনুরোধ করা হলে, নিম্নলিখিত বিকল্পগুলির মধ্যে একটি চয়ন করুন:
   • আপনার কম্পিউটারের সাথে সংযুক্ত Android ডিভাইসটি নির্বাচন করুন৷
   • বিকল্পভাবে, লঞ্চ এমুলেটর রেডিও বোতামটি নির্বাচন করুন এবং আপনার সেট আপ করা ভার্চুয়াল ডিভাইসটি চয়ন করুন।
3. ওকে ক্লিক করুন। অ্যান্ড্রয়েড স্টুডিও আপনার অ্যাপ তৈরি করতে Gradle শুরু করবে এবং তারপর আপনার ডিভাইস বা এমুলেটরে ফলাফল প্রদর্শন করবে। অ্যাপটি চালু হতে কয়েক মিনিট সময় লাগতে পারে।

পরবর্তী পদক্ষেপ

• একটি মানচিত্র সেট আপ করুন : এই নথিটি বর্ণনা করে কিভাবে আপনার মানচিত্রের জন্য প্রাথমিক এবং রানটাইম সেটিংস সেট আপ করতে হয়, যেমন ক্যামেরার অবস্থান, মানচিত্রের ধরন, UI উপাদান এবং অঙ্গভঙ্গি।

• আপনার অ্যান্ড্রয়েড অ্যাপে একটি মানচিত্র যোগ করুন (কোটলিন) : এই কোডল্যাবটি আপনাকে এমন একটি অ্যাপের মাধ্যমে নিয়ে যায় যা Android এর জন্য Maps SDK-এর কিছু অতিরিক্ত বৈশিষ্ট্য প্রদর্শন করে।

• ম্যাপস অ্যান্ড্রয়েড কেটিএক্স লাইব্রেরি ব্যবহার করুন : এই কোটলিন এক্সটেনশন (কেটিএক্স) লাইব্রেরি আপনাকে অ্যান্ড্রয়েডের জন্য মানচিত্র SDK ব্যবহার করার সময় বেশ কয়েকটি কোটলিন ভাষার বৈশিষ্ট্যগুলির সুবিধা নিতে দেয়৷