আপনার SDK সংস্করণ চয়ন করুন৷

Android এর জন্য স্থান SDK সংস্করণ 3.4.0 দুটি SDK সংস্করণ সমর্থন করে: Android এর জন্য স্থান SDK হল বিদ্যমান SDK এবং Android এর জন্য স্থান SDK (নতুন) হল SDK-এর পরবর্তী প্রজন্মের সংস্করণ৷

দ্রষ্টব্য: এই রিলিজে অন্তর্ভুক্ত সমস্ত নতুন বৈশিষ্ট্যগুলি Android এর জন্য Places SDK এর অংশ (নতুন) এবং Android এর জন্য Places SDK- এ উপলব্ধ নয়৷

Android সংস্করণ 3.4.0 এর জন্য Places SDK প্রকাশের সাথে, আপনার প্রথম কাজ হল কোন SDK ব্যবহার করবেন তা নির্ধারণ করা৷ আপনি যদি একজন নতুন গ্রাহক হন বা আগে থেকেই SDK ব্যবহার করে থাকেন তাহলে এটি সত্য। দুটি SDK-এর মধ্যে মূল পার্থক্য বুঝতে এই নির্দেশিকাটি ব্যবহার করুন।

কীভাবে আপনার SDK সংস্করণ নির্বাচন করবেন

ব্যাকএন্ডে, Android এর জন্য Places SDK স্থান API পরিষেবার উপর নির্ভর করে, হয় স্থান API (নতুন) বা স্থান API। আপনি Android এর জন্য Places SDK ব্যবহার করার আগে, আপনাকে অবশ্যই আপনার Google ক্লাউড প্রকল্পে Places API পরিষেবা সক্ষম করতে হবে৷

অ্যান্ড্রয়েডের জন্য, আপনি আপনার অ্যাপে কোন API ব্যবহার করতে পারেন তা নির্ধারণ করতে আপনি দুটি পদক্ষেপ নেন:

1. আপনার প্রজেক্টে, আপনি আপনার অ্যাপে কোনটি ব্যবহার করতে চান তার উপর নির্ভর করে আপনাকে অবশ্যই আপনার API কী-তে Places API (নতুন), স্থান API বা উভয়ই সক্ষম করতে হবে।

2. Places.initializeWithNewPlacesApiEnabled() অথবা Places.initialize() পদ্ধতিতে কল করে আপনার অ্যাপ চালু করুন।

আপনি SDK নির্বাচন করুন

Places API পরিষেবার যে সংস্করণটি আপনি সক্ষম করেন সেটি আপনার অ্যাপ দ্বারা ব্যবহৃত SDK সংস্করণ নিয়ন্ত্রণ করে:

• উভয় : Android এর জন্য স্থান SDK এবং Android এর জন্য স্থান SDK (নতুন) উভয়ের জন্য সমস্ত বৈশিষ্ট্য সক্ষম করে৷ উপলব্ধ বৈশিষ্ট্যগুলি নিয়ন্ত্রণ করতে Places.initializeWithNewPlacesApiEnabled() এবং Places.initialize() পদ্ধতি ব্যবহার করুন।

• Places API : Android এর জন্য বিদ্যমান Places SDK সক্ষম করে। Android সংস্করণ 3.4.0 এর জন্য Places SDK-এ যোগ করা নতুন বৈশিষ্ট্যগুলিতে আপনার অ্যাক্সেস নেই৷

• Places API (নতুন) : Android (নতুন) এর জন্য Places SDK সক্ষম করে এবং Android (নতুন) এর জন্য Places SDK-এ যোগ করা মূল বৈশিষ্ট্যগুলিতে বর্ণিত সমস্ত নতুন বৈশিষ্ট্য সক্ষম করে কিন্তু বর্তমান স্থান এবং স্থান স্বয়ংসম্পূর্ণের মতো বিদ্যমান বৈশিষ্ট্যগুলিকে সক্ষম করে না।

স্থান API পরিষেবা নির্বাচন করার বিষয়ে আরও তথ্যের জন্য, আপনার Google ক্লাউড প্রকল্প সেট আপ করুন দেখুন।

আপনার অ্যাপ চালু করুন

আপনি যখন আপনার অ্যাপ আরম্ভ করবেন, আপনাকে অবশ্যই Places.initializeWithNewPlacesApiEnabled() অথবা Places.initialize() পদ্ধতিতে কল করতে হবে।

নিম্নলিখিত সারণী প্রতিটি SDK সক্ষম করার এবং প্রতিটি প্রাথমিক পদ্ধতিতে কল করার প্রভাবগুলি দেখায়৷ উদাহরণস্বরূপ, আপনি যদি Places SDK (নতুন) সক্ষম করেন এবং Places.initializeWithNewPlacesApiEnabled() কল করেন, তাহলে আপনি সমস্ত নতুন API এবং বিদ্যমান সমস্ত API ব্যবহার করতে পারেন৷

আপনি যদি Places SDK (নতুন) সক্ষম করেন এবং Places.initialize() কল করেন, আপনি স্থানের বিবরণ এবং স্থানের ফটোগুলির নতুন বৈশিষ্ট্যগুলি ব্যবহার করতে পারবেন না, তবে নতুন পাঠ্য অনুসন্ধানে কল করতে পারেন৷ আপনি যদি Places API সক্ষম না করেন তবে আপনি স্থানের বিবরণের পুরানো সংস্করণ অ্যাক্সেস করতে পারবেন না তবে আপনি এখনও নতুন পাঠ্য অনুসন্ধানে কল করতে পারেন৷

সংস্করণ	এপিআই	API কী-তে SDK সক্ষম		সূচনা পদ্ধতি
		স্থান API	স্থান API (নতুন)	initialize()	initializeWithNewPlacesApiEnabled()
v3.3.0	স্থান বিবরণ
	স্থানের বিবরণ (নতুন)
	ফটো মেটাডেটা (নতুন)
	পাঠ্য অনুসন্ধান (নতুন)			যে কোনো পদ্ধতি
v3.4.0	ছবি উরি (নতুন)
	ছবির বিটম্যাপ			যে কোনো পদ্ধতি
	বর্তমান স্থান			যে কোনো পদ্ধতি
	স্বয়ংসম্পূর্ণ			যে কোনো পদ্ধতি

আপনি কোন SDK নির্বাচন করবেন?

কোন সংস্করণটি চয়ন করতে হবে তা সিদ্ধান্ত নিতে সহায়তা করতে:

1. আপনি যদি একজন নতুন গ্রাহক হন তবে Android এর জন্য Places SDK দিয়ে শুরু করছেন, তাহলে Places API (নতুন) এবং নতুন SDK দিয়ে শুরু করুন৷

2. আপনি যদি একজন Kotlin ডেভেলপার হন, আপনি যেকোন একটি SDK ব্যবহার করতে পারেন তবে Android এর জন্য Places SDK-এর নতুন বৈশিষ্ট্যগুলি (নতুন) শুধুমাত্র জাভা সংস্করণ 3.4.0-এ উপলব্ধ৷

3. আপনি যদি একজন বিদ্যমান গ্রাহক হন এবং সেশন টোকেন ব্যবহার করছেন, তাহলে বিদ্যমান SDK ব্যবহার চালিয়ে যান। Android এর জন্য স্থান SDK (নতুন) বর্তমানে সেশন টোকেন সমর্থন করে না।

4. আপনি যদি একজন বিদ্যমান গ্রাহক হন, তাহলে আপনি বিদ্যমান SDK ব্যবহার চালিয়ে যেতে পারেন। যাইহোক, Android (নতুন) এর জন্য প্লেসেস SDK-এর কর্মক্ষমতা উন্নতি এবং বৈশিষ্ট্য বর্ধনের সুবিধা নিতে, আপনি নতুন SDK ব্যবহার করতে পারেন৷

   নতুন SDK-এ যাওয়ার সময় কোন মাইগ্রেশনের প্রয়োজন নেই। আপনাকে শুধুমাত্র করতে হবে:

   1. আপনার অ্যাপে ব্যবহৃত API কী-তে Places API (নতুন) সক্ষম করুন। আরও তথ্যের জন্য, API কী ব্যবহার করা দেখুন।

   2. আপনার মডিউল-স্তরের build.gradle ফাইলের dependencies বিভাগে, places নির্ভরতা আপডেট করুন এবং kotlin-bom নির্ভরতা যোগ করুন:

        dependencies {
            implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
            implementation 'com.google.android.libraries.places:places:3.3.0'
        }

      kotlin-bom নির্ভরতা সম্পর্কে আরও তথ্যের জন্য, ট্রানজিটিভ নির্ভরতায় সর্বশেষ kotlin-stdlib সংস্করণের ব্যবহার দেখুন।

   3. আপনার অ্যাপ শুরু করতে নতুন Places.initializeWithNewPlacesApiEnabled() পদ্ধতিতে কল করতে আপনার বিদ্যমান অ্যাপ আপডেট করুন। আরও তথ্যের জন্য, স্থান API ক্লায়েন্ট শুরু করুন দেখুন।

   আপনার বিদ্যমান অ্যাপ্লিকেশানগুলি অপরিবর্তিত কাজ করে চলেছে, কিন্তু আপনি এখন সমস্ত নতুন SDK বৈশিষ্ট্যগুলির সুবিধা নিতে পারেন৷

Android এর জন্য Places SDK-এ মূল বৈশিষ্ট্য যোগ করা হয়েছে (নতুন)

এই বিভাগে Android (নতুন) এর জন্য স্থান SDK-তে যোগ করা মূল বৈশিষ্ট্যগুলি কভার করে৷

Google ক্লাউড স্ট্যান্ডার্ড প্ল্যাটফর্মে প্রয়োগ করা হয়েছে

Android এর জন্য স্থান SDK (নতুন) Google ক্লাউডে পরিষেবা পরিকাঠামোতে প্রয়োগ করা হয়েছে। এই বাস্তবায়ন আরও নিরাপদ এবং বিশ্বস্ত প্ল্যাটফর্ম নিয়ে আসে। এই স্ট্যান্ডার্ড ডিজাইনটি SDK জুড়ে সামঞ্জস্যের একটি স্তর নিয়ে আসে যা Android (নতুন) এর জন্য স্থান SDK এর সাথে বিকাশের দক্ষতা উন্নত করে।

উন্নত কর্মক্ষমতা

Android এর জন্য স্থানগুলি SDK (নতুন) উন্নত কর্মক্ষমতা প্রদান করে, যা বিদ্যমান SDK ব্যবহার করে এমন অ্যাপগুলিকে প্রতিস্থাপন করা সার্থক করে তোলে৷

নতুন পাঠ্য অনুসন্ধান পরিষেবা

পাঠ্য অনুসন্ধান একটি স্ট্রিংয়ের উপর ভিত্তি করে স্থানগুলির একটি সেট সম্পর্কে তথ্য প্রদান করে — উদাহরণস্বরূপ "নিউ ইয়র্কের পিজা" বা "অটোয়ার কাছে জুতার দোকান" বা "123 প্রধান রাস্তা"। পরিষেবাটি পাঠ্য স্ট্রিংয়ের সাথে মেলে এমন স্থানগুলির একটি তালিকা এবং সেট করা যেকোন অবস্থানের পক্ষপাতের সাথে প্রতিক্রিয়া জানায়৷

স্থাপন করা বিবরণ এবং স্থান ফটোতে নতুন প্রতিক্রিয়া ডেটা যোগ করা হয়েছে৷

• স্থানের বিবরণ এখন প্রতিক্রিয়া Place অবজেক্টে নতুন পর্যালোচনা ক্লাস অন্তর্ভুক্ত করে। এই ক্ষেত্রটিকে সমর্থন করার জন্য প্লেস ক্লাসে নতুন getReviews() পদ্ধতি রয়েছে। একটি জায়গার জন্য পাঁচটি পর্যন্ত রিভিউ ফেরত দিতে getReviews() এ কল করুন।

• স্থান ফটো PhotoMetadata ক্লাসে AuthorAttributions যোগ করে। AuthorAttributions AuthorAttribution অবজেক্টের একটি List রয়েছে।

নতুন URI প্রতিক্রিয়া স্থান ফটোতে যোগ করা হয়েছে৷

আপনি এখন একটি ইমেজ বিটম্যাপে একটি URI ফেরত দিতে Place Photos ব্যবহার করতে পারেন। পূর্বে, আপনি শুধুমাত্র ইমেজ বিটম্যাপ নিজেই ফেরত দিতে পারেন।

সরলীকৃত মূল্য

Android (নতুন) এর জন্য Places SDK-এর মাধ্যমে মূল্য নির্ধারন সহজ করা হয়েছে যাতে আপনি শুধুমাত্র আপনার ব্যবহার করা ডেটার জন্য অর্থ প্রদান করেন। সরলীকৃত মূল্য ক্ষেত্র তালিকা ব্যবহার করে প্রয়োগ করা হয়, যাকে ফিল্ড মাস্কও বলা হয়।

স্থানের বিবরণ এবং পাঠ্য অনুসন্ধানের সাথে আপনি প্রতিক্রিয়াতে ফিরে আসার জন্য ক্ষেত্রগুলির তালিকা নিয়ন্ত্রণ করতে ক্ষেত্র তালিকা ব্যবহার করেন। তারপরে আপনাকে শুধুমাত্র অনুরোধ করা ডেটার জন্য বিল দেওয়া হবে। আপনি অপ্রয়োজনীয় ডেটার অনুরোধ করবেন না তা নিশ্চিত করার জন্য একটি ফিল্ড তালিকা ব্যবহার করা একটি ভাল ডিজাইন অনুশীলন, যা অপ্রয়োজনীয় প্রক্রিয়াকরণের সময় এবং বিলিং চার্জ এড়াতে সহায়তা করে।

উভয় SDK-এর বিশদ মূল্যের তথ্যের জন্য, ব্যবহার এবং বিলিং দেখুন।

দ্রষ্টব্য: নতুন মূল্যের মডেলটি শুধুমাত্র স্থানের বিবরণ, পাঠ্য অনুসন্ধান এবং স্থানের ফটোতে প্রযোজ্য। স্থান স্বয়ংসম্পূর্ণ এবং বর্তমান স্থান উভয় SDK-এর জন্য মূল্য একই।

প্রসারিত স্থান প্রকার

নতুন SDK নিম্নলিখিত সারণীতে দেখানো স্থানের ধরনগুলি যোগ করে৷ এই প্রকারগুলি স্থানের বিবরণ এবং পাঠ্য অনুসন্ধান প্রতিক্রিয়ার অংশ হিসাবে ফেরত দেওয়া হয়। আপনি পাঠ্য অনুসন্ধানের সাথে অনুসন্ধানে এই নতুন প্রকারগুলি এবং বিদ্যমান প্রকারগুলিও ব্যবহার করতে পারেন৷ নতুন প্রকারগুলি সারণি A- তে অন্তর্ভুক্ত করা হয়েছে।

টাইপ
আমেরিকান_রেস্তোরাঁ	ডিসকাউন্ট দোকান	আইসক্রিমের দোকান	স্যান্ডউইচ_শপ
বিনোদন_কেন্দ্র	কুকুর_পার্ক	ভারতীয় রেস্তোরাঁয়	জেলা স্কুল
খেলাধুলার ক্ষেত্র	বৈদ্যুতিক_যান_চার্জিং_স্টেশন	ইন্দোনেশিয়ান_রেস্তোরাঁ	সীফুড_রেস্তোরাঁ
auto_parts_store	অনুষ্ঠান স্থল	ইতালিয়ান রেস্টুরেন্ট	ski_resort
ভোজ হল	বর্ধিত_থাকার_হোটেল	জাপানি রেস্তোরা	স্প্যানিশ_রেস্তোরাঁ
বারবিকিউ_রেস্তোরাঁ	খামার	Korean_restaurant	খেলার সামগ্রীর দোকান
সেলুন	খামার	লেবানিজ_রেস্তোরাঁ	ক্রীড়া ক্লাব
বিছানা ও নাস্তা	ফাস্ট ফুড রেস্টুরেন্ট	মেরিনা	ক্রীড়া কমপ্লেক্স
ব্রাজিলিয়ান_রেস্তোরাঁ	ফেরি ঘাট	বাজার	কাবাব ঘর
ব্রেকফাস্ট_রেস্তোরাঁ	ফিটনেস_সেন্টার	মেডিকেল_ল্যাব	সুশি_রেস্তোরাঁ
brunch_restaurant	ফ্রেঞ্চ রেস্টুরেন্ট	ভূমধ্যসাগরীয়_রেস্তোরাঁ	সুইমিংপুল
বাস স্টপ	উপহারের দোকান	মেক্সিকান রেষ্টুরেন্ট	দর্জি
ক্যাম্পিং_কেবিন	গলফ কোর্স	মধ্য_পূর্ব_রেস্তোরাঁ	টেলিকমিউনিকেশন_সার্ভিস_প্রোভাইডার
সেল_ফোন_স্টোর	গ্রীক_রেস্তোরাঁ	মোটেল	থাই_রেস্তোরাঁ
চাইল্ড_কেয়ার_এজেন্সি	মুদি দোকান	জাতীয়_পার্ক	ট্রানজিট_ডিপো
চাইনিজ রেস্টুরেন্ট	অতিথিশালা	পার্ক_এন্ড_রাইড	ট্রাক স্টপ
কাফির দোকান	চুল কাটানোর দোকান	পারফর্মিং_আর্টস_থিয়েটার	তুর্কি_রেস্তোরাঁ
কমিউনিটি কেন্দ্র	হ্যামবার্গার_রেস্তোরাঁ	পিজা_রেস্তোরাঁ	নিরামিষ_রেস্তোরাঁ
পরামর্শদাতা	হেলিপোর্ট	খেলার মাঠ	নিরামিষ_রেস্তোরাঁ
সম্মেলন কেন্দ্র	হাইকিং_এরিয়া	প্রিস্কুল	ভিয়েতনামী_রেস্তোরাঁ
কুটির	ঐতিহাসিক ল্যান্ডমার্ক	ব্যক্তিগত_অতিথি_রুম	দর্শক কেন্দ্র
কুরিয়ার সার্ভিস	বাড়ির_উন্নতি_স্টোর	ramen_restaurant	বিবাহের স্থান
সাংস্কৃতিক কেন্দ্র	ছাত্রাবাস	রিসোর্ট হোটেল	পাইকারী বিক্রেতা
দাতের চিকিৎসাকেন্দ্র	হোটেল	বিশ্রাম বন্ধ

এই নতুন ধরনেরগুলির সাথে, Places API (নতুন) টেবিল A ​​থেকে টেবিল B থেকে নিম্নলিখিত প্রকারগুলি সরানো হয়েছে। তার মানে আপনি এখন অনুসন্ধানের অংশ হিসাবে এই প্রকারগুলি ব্যবহার করতে পারেন:

• country
• administrative_area_level_1
• administrative_area_level_2
• postal_code
• locality