অ্যান্ড্রয়েডের জন্য প্লেস SDK প্লেস ডিটেইলস (লিগ্যাসি) সমর্থন করে। যদি আপনি প্লেস ডিটেইলস (লিগ্যাসি) এর সাথে পরিচিত হন, তাহলে প্লেস ডিটেইলস (নতুন) নিম্নলিখিত পরিবর্তনগুলি করে:
একটি নতুন মূল্য নির্ধারণ মডেল ব্যবহার করে। সমস্ত API-এর মূল্য নির্ধারণের তথ্যের জন্য, Android এর জন্য Places SDK (নতুন) দেখুন।
আপনার অ্যাপটি
Places.initializeWithNewPlacesApiEnabled()পদ্ধতিতে কল করে শুরু করতে হবে। Places API পরিষেবা নির্বাচন করার বিষয়ে আরও তথ্যের জন্য, আপনার Google ক্লাউড প্রকল্প সেট আপ করুন দেখুন।ফিল্ড মাস্কিং প্রয়োজন। প্রতিক্রিয়ায় আপনি কোন ক্ষেত্রগুলি ফেরত চান তা অবশ্যই উল্লেখ করতে হবে। ফেরত ক্ষেত্রগুলির কোনও ডিফল্ট তালিকা নেই। যদি আপনি এই তালিকাটি বাদ দেন, তাহলে পদ্ধতিগুলি একটি ত্রুটি ফেরত দেবে।
নিম্নলিখিত বিভাগগুলিতে অতিরিক্ত পরিবর্তনগুলি বর্ণনা করা হয়েছে।
নতুন ধরণের জায়গা অ্যাক্সেস করুন
প্রতিটি স্থানের সাথে এক বা একাধিক ধরণের মান যুক্ত থাকতে পারে। অ্যান্ড্রয়েড সংস্করণ 3.3.0 এবং পরবর্তী সংস্করণের জন্য Places SDK অনেক নতুন ধরণের মান যোগ করে। সম্পূর্ণ তালিকার জন্য, সম্প্রসারিত স্থানের প্রকারগুলি দেখুন।
Place.getPlaceTypes() পদ্ধতিটি স্ট্রিং মানের তালিকা হিসেবে টাইপ মানগুলি ফেরত দেয়। ফেরত দেওয়া মানগুলি Android এর জন্য Places SDK এর আপনার সংস্করণের উপর নির্ভর করে:
Places SDK for Android (New) : Place Types (New) তে দেখানো Table A এবং Table B দ্বারা সংজ্ঞায়িত স্ট্রিংগুলি ফেরত পাঠায়, যার মধ্যে 3.3.0 সংস্করণে যোগ করা সমস্ত যোগ করা স্থানের ধরণ অন্তর্ভুক্ত রয়েছে।
Places SDK for Android :
Place.Typesদ্বারা সংজ্ঞায়িত enums ফেরত পাঠায়, যার মধ্যে 3.3.0 এবং পরবর্তী সংস্করণে যোগ করা নতুন প্রকারগুলি অন্তর্ভুক্ত নয়।
স্থান পর্যালোচনা অ্যাক্সেস করুন
অ্যান্ড্রয়েডের জন্য প্লেসস এসডিকে (নতুন) Review ক্লাস যোগ করে, যেখানে একটি স্থানের পর্যালোচনা থাকে। Place অবজেক্টে সর্বাধিক পাঁচটি পর্যালোচনা থাকতে পারে।
Review ক্লাসে একটি অ্যাট্রিবিউশন এবং একটি লেখক অ্যাট্রিবিউশনও থাকতে পারে। আপনি যদি আপনার অ্যাপে পর্যালোচনাটি প্রদর্শন করেন, তাহলে আপনাকে অবশ্যই যেকোনো অ্যাট্রিবিউশন বা লেখক অ্যাট্রিবিউশনও প্রদর্শন করতে হবে। আরও তথ্যের জন্য, "একটি পর্যালোচনা প্রদর্শন করুন" দেখুন।
আরও তথ্যের জন্য, অ্যাট্রিবিউশন সম্পর্কিত ডকুমেন্টেশন দেখুন।
স্থানের নাম ভাষা কোড অ্যাক্সেস করুন
Places SDK for Android (Legacy) তে, Place.getName() পদ্ধতিতে একটি স্থানের নাম সম্বলিত একটি টেক্সট স্ট্রিং ফেরত পাঠানো হয়। স্থানের নাম দিয়ে Place অবজেক্টটি পূরণ করতে, আপনাকে স্থানের বিবরণ অনুরোধের ক্ষেত্রের তালিকায় Place.Field.DISPLAY_NAME অন্তর্ভুক্ত করতে হবে।
Place অবজেক্টে এখন নেম স্ট্রিংয়ের জন্য ভাষা কোড রয়েছে। Place অবজেক্টে ভাষা কোড পূরণ করতে, আপনাকে অবশ্যই:
অনুরোধের ক্ষেত্রের তালিকায়
Place.Field.DISPLAY_NAMEঅন্তর্ভুক্ত করুন। এই মানটিPlaceঅবজেক্টে স্থানের নাম এবং ভাষা কোড উভয়ই অন্তর্ভুক্ত করার জন্য প্রতিক্রিয়া কনফিগার করে।PlacesClient.fetchPlace()কল করুন।PlacesClient.findCurrentPlace()ভাষা কোড ক্ষেত্র সমর্থন করে না।Placeঅবজেক্টের ভাষা কোড ক্ষেত্রটি অ্যাক্সেস করতেPlace.getNameLanguageCode()পদ্ধতিটি ব্যবহার করুন।
অঞ্চল কোড সেট করুন
Places SDK for Android (নতুন) Place Details-এ রিজিওন কোড রিকোয়েস্ট প্যারামিটার যোগ করে। রিজিওন কোডটি দুই-অক্ষরের CLDR কোড মান হিসেবে নির্দিষ্ট করে প্রতিক্রিয়া ফর্ম্যাট করতে ব্যবহৃত হয়। এই প্যারামিটারটি সার্চ ফলাফলের উপরও পক্ষপাতের প্রভাব ফেলতে পারে। কোনও ডিফল্ট মান নেই। রিজিওন কোড সেট করার জন্য আপনাকে নতুন SDK সক্ষম করতে হবে।
যদি উত্তরে ঠিকানা ক্ষেত্রের দেশের নাম অঞ্চল কোডের সাথে মিলে যায়, তাহলে ঠিকানা থেকে দেশের কোড বাদ দেওয়া হবে।
বেশিরভাগ CLDR কোড ISO 3166-1 কোডের অনুরূপ, কিছু উল্লেখযোগ্য ব্যতিক্রম ছাড়া। উদাহরণস্বরূপ, যুক্তরাজ্যের ccTLD হল "uk" (.co.uk) যেখানে এর ISO 3166-1 কোড হল "gb" (প্রযুক্তিগতভাবে "The United Kingdom of Great Britain and Northern Ireland" এর সত্তার জন্য)। প্রযোজ্য আইনের উপর ভিত্তি করে প্যারামিটারটি ফলাফলকে প্রভাবিত করতে পারে।
উদাহরণ অনুরোধ
সম্পূর্ণ উদাহরণের জন্য, স্থানের বিবরণ (নতুন) দেখুন।