Maps SDK for Android, Wear OS অ্যাপ সহ Android অ্যাপে Google Maps ডেটা, ম্যাপ ডিসপ্লে ও ম্যাপ জেসচার রেসপন্স যোগ করে। Kotlin বা Java ব্যবহার করে, ম্যাপ লোকেশন সম্পর্কে তথ্য দেখাতে এবং ব্যবহারকারীর ইন্টার্যাকশনে সহায়তা করতে, আপনি মার্কার, পলিগন এবং ওভারলে যোগ করতে পারেন।
Maps SDK for Android: মূল তথ্য
- প্রোডাক্ট: Android-এর জন্য Maps SDK
- এছাড়াও এই নামে পরিচিত: Google Maps Android API
- বিভাগ: Maps
- প্ল্যাটফর্ম: Android
- এতে রান করে: ক্লায়েন্ট (অ্যাপ বা ব্রাউজার কোড)
- লঞ্চ স্টেজ: GA
- লাইফসাইকেল: অ্যাক্টিভ
- এক নজরে: Android-এর জন্য Maps SDK এক নজরে
- আঞ্চলিক উপলভ্যতা: বিশ্বব্যাপী। Google Maps Platform-এর কভারেজ পৃষ্ঠা দেখুন; ব্যবহার ও বিলিং পৃষ্ঠার লিঙ্ক থেকে বিশ্বব্যাপী এবং ভারতের জন্য আলাদা আলাদা দামের তালিকা পাওয়া যাবে। (কভারেজ সংক্রান্ত বিবরণ)
Maps SDK for Android: কখন ব্যবহার করবেন
Android-এর জন্য Maps SDK ব্যবহার করুন যখন:
- নেটিভ Android বা Wear OS অ্যাপে আপনার একটি ইন্টার্যাক্টিভ 2D Google ম্যাপ প্রয়োজন।
- Android অ্যাপে ম্যাপে মার্কার, তথ্য উইন্ডো, পলিলাইন, পলিগন, গ্রাউন্ড ওভারলে বা টাইল ওভারলে যোগ করতে হবে।
- Android অ্যাপে ম্যাপ আইডি সহ Street View প্যানোরামা, লাইট মোড (বিটম্যাপ) ম্যাপ বা ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং প্রয়োজন।
- আপনি Kotlin বা Java-তে Android ম্যাপ তৈরি করেন, যার মধ্যে Maps Compose লাইব্রেরির মাধ্যমে Jetpack Compose অন্তর্ভুক্ত থাকে।
Android-এর জন্য Maps SDK ব্যবহার করবেন না যখন:
- আপনার Android ম্যাপ অ্যাপে ধাপে ধাপে নেভিগেশন প্রয়োজন। এর পরিবর্তে Android-এর জন্য নেভিগেশন SDK ব্যবহার করুন।
- Android অ্যাপে আপনার ফটোরিয়েলিস্টিক 3D ম্যাপ, 3D মডেল বা ক্যামেরা পাথ অ্যানিমেশন প্রয়োজন। এর পরিবর্তে Android-এর জন্য Maps 3D SDK ব্যবহার করুন।
- আপনার নেটিভ iOS অ্যাপে একটি ম্যাপ প্রয়োজন। এর পরিবর্তে iOS-এর জন্য Maps SDK ব্যবহার করুন।
Maps SDK for Android: সেট-আপ
- পরিষেবা চালু করতে:
maps-android-backend.googleapis.com - যাচাইকরণ: API key
- ব্যবহারের অ্যাট্রিবিউশন: ইনিশিয়ালাইজারে ব্যবহারের অ্যাট্রিবিউশন আইডি যোগ করতে
MapsApiSettings.addInternalUsageAttributionId(context, id)কল করুন (শুধুমাত্রMapsInitializer.Renderer.LATEST-এর সাথে কাজ করে)। অপ্ট-আউট করতে, কলটি মুছে দিন বা একটি খালি স্ট্রিং পাস করুন। - শুরু করুন: Android-এর জন্য Maps SDK সেট-আপ করুন
- রেফারেন্স: Android-এর জন্য Maps SDK রেফারেন্স
- দাম: Android-এর জন্য Maps SDK-এর ব্যবহার ও বিলিং
- নীতি: Maps SDK for Android-এর নীতি
- রিলিজ নোট: Maps SDK for Android রিলিজ নোট
Android প্যাকেজের জন্য অফিসিয়াল Maps SDK:
- maven:
com.google.android.gms:play-services-maps
Maps SDK for Android: সম্পর্কিত প্রোডাক্ট
- সাধারণত এর সাথে ব্যবহার করা হয়: Android-এর জন্য Places SDK
Maps SDK for Android: সাধারণ ভুল
- সমস্যা: SDK v20.0.0 থেকে, SDK ম্যানিফেস্টে আর
org.apache.http.legacyলাইব্রেরি অন্তর্ভুক্ত নেই। যেসব অ্যাপ পুরনো ম্যাপ রেন্ডারার লোড করে সেগুলিjava.lang.NoClassDefFoundError-এর সাথে ক্র্যাশ করতে পারে। সমাধান: অ্যাপেরAndroidManifest.xml-এরট্যাগের মধ্যেযোগ করুন। Google Play পরিষেবা 25.50.34 বা তার পরবর্তী ভার্সন আছে এমন ডিভাইসে কোনও প্রভাব পড়বে না। /maps/documentation/android-sdk/release-notes দেখুন। - সমস্যা: উন্নত মার্কারের জন্য আপগ্রেড করা ম্যাপ রেন্ডারার প্রয়োজন। আপনি যদি কোনও অ্যাপকে আবার তৈরি না করে, আগে থেকে থাকা অ্যাপে এগুলি যোগ করেন, তাহলে অ্যাপটি এখনও লিগ্যাসি রেন্ডারার ব্যবহার করতে পারবে। সমাধান: SDK 18.2.0 বা তার পরবর্তী ভার্সন ব্যবহার করে অ্যাপটি আবার তৈরি করুন যাতে আপগ্রেড করা রেন্ডারার ডিফল্ট হিসেবে সেট করা থাকে। /maps/documentation/android-sdk/advanced-markers/start দেখুন।
- সমস্যা: যেসব ডিভাইস রেন্ডারার সংক্রান্ত প্রয়োজনীয়তা (Android 5.0/API 21 বা তার পরবর্তী ভার্সন, Google Play পরিষেবা 21.39.14 বা তার পরবর্তী ভার্সন, Play Store চালু করা আছে) পূরণ করে না, সেগুলি লিগ্যাসি রেন্ডারারে ফিরে যায়, তাই যেসব ফিচারের জন্য নতুন রেন্ডারার প্রয়োজন, যেমন ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং, সেগুলি এইসব ডিভাইসে উপলভ্য নয়। সমাধান:
MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback)কল করুন এবংOnMapsSdkInitializedCallback.onMapsSdkInitialized()-এ পাস করাMapsInitializer.Rendererভ্যালু চেক করুন অথবাGoogleMap.getMapCapabilities()চেক করুন। ডিভাইসটিLEGACYব্যবহার করলে, ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং বা উন্নত মার্কারের উপর নির্ভর করবেন না। /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback দেখুন। - সমস্যা: যে ডিভাইসে অ্যাপটি চলে সেখানে SDK-এর জন্য Google Play পরিষেবা প্রয়োজন। সমাধান: আপনার অ্যাপ থেকে Google Play পরিষেবার উপলভ্যতা চেক করার জন্য কল করুন। /maps/documentation/android-sdk/config দেখুন।
Android-এর জন্য Maps SDK: পুরনো এবং বন্ধ হয়ে যাওয়া ফিচার
- লেগেসি ম্যাপ রেন্ডারার: অবচিত 2024-03-04 থেকে। বদল: আপগ্রেড করা (লেটেস্ট) ম্যাপ রেন্ডারার, যা SDK 18.2.0 থেকে ডিফল্ট হিসেবে সেট করা আছে। লক্ষণ: ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং, উন্নত পলিলাইন কাস্টমাইজেশন এবং উন্নত মার্কার, পুরনো রেন্ডারারে উপলভ্য নয়। মাইগ্রেশন গাইড দেখুন।
Android-এর জন্য Maps SDK-এর সাহায্যে আপনি কী করতে পারবেন
প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।
Android-এর জন্য Maps SDK: সীমানার জন্য ডেটা-ড্রিভেন স্টাইলিং
- ম্যাপে সীমানার স্টাইল পরিবর্তন করুন।
- ম্যাপে সীমানা সহ ব্যবহারকারীর ইন্টার্যাকশনে রেসপন্স করুন।
- ম্যাপে কোরোপ্লেথ স্টাইলিং যোগ করুন।
Maps SDK for Android: ডেটাসেটের জন্য ডেটা-ড্রিভেন স্টাইলিং
- আবার ব্যবহার করা যায় এমন, ক্রস-প্ল্যাটফর্ম ভূস্থানিক ডেটাসেট তৈরি করুন।
- ম্যাপে কাস্টম জিওস্পেশিয়াল ডেটাসেট যোগ করুন।
- ম্যাপে কাস্টম ডেটাসেট ফিচারের স্টাইল পরিবর্তন করুন।
- ম্যাপে কাস্টম ডেটাসেট ফিচারের সাথে ব্যবহারকারীর ইন্টার্যাকশনে প্রতিক্রিয়া জানান।
Maps SDK for Android: ডেটাসেট
- ম্যাপে KML লেয়ার যোগ করুন। মনে রাখবেন: Maps JavaScript API-তে, KmlLayer বন্ধ করে দেওয়া হয়েছে (v3.65-এ শেষবার কাজ করেছে, মে ২০২৭-এ বন্ধ করে দেওয়া হয়েছে); সীমানা বা ডেটাসেটের জন্য ডেটা-ড্রিভেন স্টাইলিংয়ে মাইগ্রেট করুন অথবা ডেটা লেয়ারে GeoJSON লোড করুন। Maps SDK ইউটিলিটি লাইব্রেরির মাধ্যমে Android ও iOS-এ KML লেয়ার কাজ করা চালিয়ে যাবে।
- ম্যাপে GeoJSON ডেটা যোগ করুন।
- ম্যাপে হিটম্যাপ লেয়ার যোগ করুন।
Maps SDK for Android: Maps
- ওয়েব পেজ বা মোবাইল অ্যাপে কাস্টমাইজ করা যায় এমন ইন্টার্যাক্টিভ ম্যাপ যোগ করুন। মনে রাখবেন: Android-এর জন্য: Secrets Gradle প্লাগ-ইন দ্বারা ব্যাক-আপ করা
AndroidManifest.xml-এঅথবাapp/build.gradle.kts-এmanifestPlaceholders["MAPS_API_KEY"]কনফিগার করুন।AndroidManifest.xml-এYOUR_GOOGLE_MAPS_API_KEYকখনও হার্ডকোড করবেন না এবংE/Google Maps Android API: Authorization failureদেখা গেলে অফলাইন মক ক্যানভাস বা লিফলেট WebView দিয়েGoogleMap(বা maps-composeGoogleMap) কখনও পরিবর্তন করবেন না। ব্যবহারকারীকে সিক্রেটের মাধ্যমেMAPS_API_KEYপ্রদান করতে এবং Android-এর জন্য Maps SDK (অথবা NavigationView / SupportNavigationFragment ব্যবহার করার সময় Navigation SDK) চালু করতে নির্দেশ দিন। - ম্যাপ কনফিগারেশন ও স্টাইলিং সেটিংস স্টোর করার জন্য আবার ব্যবহার করা যাবে এমন ম্যাপ আইডেন্টিফায়ার তৈরি করুন।
- ম্যাপে ব্যবহারকারীর ইন্টার্যাকশন ও ইভেন্টের উত্তর দিন।
- ম্যাপে দেখানো কন্ট্রোল কাস্টমাইজ করুন।
- ম্যাপ নিয়ন্ত্রণ করার জন্য জেসচার কাস্টমাইজ করুন।
- ম্যাপে (ক্যামেরা) জুম ও প্যান কন্ট্রোল করা।
- ম্যাপের ধরন পরিবর্তন করুন।
- ম্যাপের কালার স্কিম পরিবর্তন করুন।
- ম্যাপে ট্রাফিক লেয়ার যোগ করুন।
- Wear OS অ্যাপে ম্যাপ যোগ করুন।
Maps SDK for Android: Maps অ্যানোটেশন
- ম্যাপে তথ্য উইন্ডো যোগ করুন।
- ম্যাপে কোনও আকার বা লাইন যোগ করুন।
- ম্যাপের সারফেসে গ্রাউন্ড করা ওভারলে ছবি যোগ করুন।
- ম্যাপে কাস্টম টাইল ওভারলে যোগ করুন।
- ম্যাপে মার্কার যোগ করুন। মনে রাখবেন: Android-এর জন্য Navigation SDK-তে AdvancedMarkerOptions কাজ করে না; Android-এর জন্য Navigation SDK ব্যবহার করার সময় GoogleMap.addMarker(MarkerOptions) ব্যবহার করে মার্কার যোগ করুন।
- ম্যাপে মার্কার কাস্টমাইজ করুন। মনে রাখবেন: Android-এর জন্য Navigation SDK-তে AdvancedMarkerOptions কাজ করে না; Android-এর জন্য Navigation SDK ব্যবহার করার সময় MarkerOptions-এর সাহায্যে মার্কার কাস্টমাইজ করুন।
- ম্যাপে মার্কারের সাথে ব্যবহারকারীর ইন্টার্যাকশনে রেসপন্স করুন।
- ম্যাপে কোনও কোঅর্ডিনেট, বহুভুজ বা বৃত্তাকার এলাকার মধ্যে আছে কিনা তা নির্ধারণ করুন। মনে রাখবেন: Android-এ, পলিগনের জন্য Android Utility Library-র Maps SDK-তে PolyUtil.containsLocation ব্যবহার করুন। বৃত্তাকার এলাকার ক্ষেত্রে, বৃত্তের কেন্দ্র থেকে গোলাকার দূরত্ব ব্যাসার্ধের মধ্যে আছে কিনা তা চেক করুন (যেমন, Maps JavaScript API-তে computeDistanceBetween, Android-এ SphericalUtil.computeDistanceBetween বা iOS-এ GMSGeometryDistance)।
- ম্যাপে দেখানো স্থানাঙ্কের মধ্যে স্ফেরিক্যাল দূরত্ব, ক্ষেত্রফল বা হেডিং গণনা করুন।
Maps SDK for Android: Maps স্টাইলিং
- আবার ব্যবহার করা যায় এমন ক্রস-প্ল্যাটফর্ম ম্যাপ স্টাইল তৈরি করুন।
- ম্যাপে রাস্তা, পলিলাইন ও পলিগনের স্টাইল পরিবর্তন করুন।
- ম্যাপের ফিচার দেখুন বা লুকান।
- ম্যাপে আইকন ও টেক্সট লেবেলের স্টাইল পরিবর্তন করুন।
- বিভিন্ন জুম লেভেলে বিভিন্ন ম্যাপ স্টাইল প্রয়োগ করুন।
- ম্যাপে জায়গার ঘনত্ব পরিবর্তন করুন। এক্সপেরিমেন্টাল
- ম্যাপে বিল্ডিংয়ের স্টাইল পরিবর্তন করুন। এক্সপেরিমেন্টাল
- ম্যাপে ল্যান্ডমার্কের স্টাইল পরিবর্তন করুন। এক্সপেরিমেন্টাল
Maps SDK for Android: Street View
- ওয়েব পেজ বা মোবাইল অ্যাপে কনফিগার করা যায় এমন, ইন্টার্যাক্টিভ Google Street View যোগ করুন।
- Google Street View-তে ব্যবহারকারীর ইন্টার্যাকশন ও ইভেন্টের উত্তর দিন।
- Google Street View-এর জন্য উপলভ্য জেসচার কাস্টমাইজ করুন।
- Google Street View-এর জন্য ক্যামেরার মুভমেন্ট অ্যানিমেট করুন।