অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (লেগ্যাসি) প্লেস ডিটেইলস (লেগ্যাসি) সমর্থন করে। আপনি যদি প্লেস ডিটেইলস (লেগ্যাসি)-এর সাথে পরিচিত হন, তাহলে প্লেস ডিটেইলস (নিউ) নিম্নলিখিত পরিবর্তনগুলি এনেছে:
নতুন মূল্য নির্ধারণ মডেল ব্যবহার করা হয়েছে। সমস্ত এপিআই-এর মূল্য সংক্রান্ত তথ্যের জন্য, ব্যবহার ও বিলিং দেখুন।
আপনাকে অবশ্যই
Places.initializeWithNewPlacesApiEnabled()মেথডটি কল করে আপনার অ্যাপটি ইনিশিয়ালাইজ করতে হবে। Places API সার্ভিস নির্বাচন করার বিষয়ে আরও তথ্যের জন্য, আপনার Google Cloud প্রজেক্ট সেট আপ করুন দেখুন।ফিল্ড মাস্কিং আবশ্যক। রেসপন্সে আপনি কোন ফিল্ডগুলো ফেরত পেতে চান, তা আপনাকে অবশ্যই নির্দিষ্ট করতে হবে। ফেরত আসা ফিল্ডগুলোর কোনো ডিফল্ট তালিকা নেই। আপনি যদি এই তালিকাটি বাদ দেন, তাহলে মেথডগুলো একটি এরর ফেরত দেবে।
পরবর্তী অনুচ্ছেদগুলিতে অতিরিক্ত পরিবর্তনগুলি বর্ণনা করা হয়েছে।
নতুন ধরনের স্থান অ্যাক্সেস করুন
প্রতিটি স্থানের সাথে এক বা একাধিক টাইপ ভ্যালু যুক্ত থাকতে পারে। অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (Places SDK for Android) সংস্করণ ৩.৩.০ এবং তার পরবর্তী সংস্করণগুলোতে অনেক নতুন টাইপ ভ্যালু যোগ করা হয়েছে। সম্পূর্ণ তালিকার জন্য, ‘সম্প্রসারিত স্থানের প্রকারভেদ’ (Expanded place types ) দেখুন।
Place.getPlaceTypes() মেথডটি টাইপ ভ্যালুগুলোকে স্ট্রিং ভ্যালুর একটি লিস্ট হিসেবে রিটার্ন করে। রিটার্ন করা ভ্যালুগুলো আপনার Android-এর জন্য Places SDK-এর ভার্সনের উপর নির্ভর করে:
অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (নতুন) : প্লেস টাইপস (নতুন) -এ প্রদর্শিত টেবিল এ এবং টেবিল বি দ্বারা সংজ্ঞায়িত স্ট্রিংগুলি ফেরত দেয়, যার মধ্যে সংস্করণ ৩.৩.০-এ যোগ করা সমস্ত নতুন প্লেস টাইপ অন্তর্ভুক্ত রয়েছে।
অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (লেগ্যাসি) :
Place.Typesদ্বারা সংজ্ঞায়িত এনামগুলো রিটার্ন করে, যার মধ্যে সংস্করণ ৩.৩.০ এবং তার পরবর্তী সংস্করণগুলোতে যোগ করা নতুন টাইপগুলো অন্তর্ভুক্ত নয়।
স্থান পর্যালোচনা অ্যাক্সেস করুন
অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (নতুন) Review ক্লাসটি যুক্ত করেছে, যেখানে কোনো একটি স্থানের রিভিউ থাকে। ‘ Place অবজেক্টটিতে সর্বোচ্চ পাঁচটি রিভিউ থাকতে পারে।
Review ক্লাসে একটি অ্যাট্রিবিউশন এবং একটি অথর অ্যাট্রিবিউশনও থাকতে পারে। আপনি যদি আপনার অ্যাপে রিভিউটি প্রদর্শন করেন, তাহলে আপনাকে অবশ্যই যেকোনো অ্যাট্রিবিউশন বা অথর অ্যাট্রিবিউশনও প্রদর্শন করতে হবে। আরও তথ্যের জন্য, “একটি রিভিউ প্রদর্শন করুন” দেখুন।
আরও তথ্যের জন্য, অ্যাট্রিবিউশন সম্পর্কিত ডকুমেন্টেশন দেখুন।
অ্যাক্সেস স্থানের নামের ভাষা কোড
অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (লেগ্যাসি)-তে, Place.getName() মেথডটি একটি স্থানের নাম সম্বলিত একটি টেক্সট স্ট্রিং রিটার্ন করে। স্থানের নাম দিয়ে Place অবজেক্টটি পূরণ করতে, আপনাকে অবশ্যই স্থানের বিবরণ অনুরোধের ফিল্ড তালিকায় Place.Field.DISPLAY_NAME অন্তর্ভুক্ত করতে হবে।
Place অবজেক্টটিতে এখন name স্ট্রিংটির জন্য ভাষা কোড রয়েছে। Place অবজেক্টটিতে ভাষা কোড যুক্ত করতে, আপনাকে অবশ্যই:
অনুরোধের ফিল্ড তালিকায়
Place.Field.DISPLAY_NAMEঅন্তর্ভুক্ত করুন। এই মানটি প্রতিক্রিয়াকে এমনভাবে কনফিগার করে যাতেPlaceঅবজেক্টে স্থানের নাম এবং ভাষা কোড উভয়ই অন্তর্ভুক্ত থাকে।PlacesClient.fetchPlace()কল করুন।PlacesClient.findCurrentPlace()ল্যাঙ্গুয়েজ কোড ফিল্ড সমর্থন করে না।Placeঅবজেক্টের ল্যাঙ্গুয়েজ কোড ফিল্ডটি অ্যাক্সেস করতেPlace.getNameLanguageCode()মেথডটি ব্যবহার করুন।
অঞ্চল কোড সেট করুন
অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (নতুন) প্লেস ডিটেইলস-এ রিজিওন কোড রিকোয়েস্ট প্যারামিটার যোগ করেছে। রেসপন্স ফরম্যাট করার জন্য রিজিওন কোড ব্যবহার করা হয়, যা একটি দুই-অক্ষরের CLDR কোড ভ্যালু হিসেবে নির্দিষ্ট করা থাকে। এই প্যারামিটারটি সার্চ রেজাল্টের উপর পক্ষপাতমূলক প্রভাবও ফেলতে পারে। এর কোনো ডিফল্ট ভ্যালু নেই। রিজিওন কোড সেট করার জন্য আপনাকে অবশ্যই নতুন এসডিকে-টি এনাবল করতে হবে।
রেসপন্সের অ্যাড্রেস ফিল্ডের দেশের নাম যদি রিজিওন কোডের সাথে মিলে যায়, তাহলে অ্যাড্রেস থেকে কান্ট্রি কোডটি বাদ দেওয়া হয়।
কিছু উল্লেখযোগ্য ব্যতিক্রম ছাড়া, বেশিরভাগ CLDR কোড ISO 3166-1 কোডের অনুরূপ। উদাহরণস্বরূপ, যুক্তরাজ্যের ccTLD হলো "uk" (.co.uk), যেখানে এর ISO 3166-1 কোড হলো "gb" (যা প্রযুক্তিগতভাবে "The United Kingdom of Great Britain and Northern Ireland" সত্তাটিকে বোঝায়)। প্রযোজ্য আইনের উপর ভিত্তি করে এই প্যারামিটারটি ফলাফলকে প্রভাবিত করতে পারে।
উদাহরণ অনুরোধ
একটি পূর্ণাঙ্গ উদাহরণের জন্য, স্থানের বিবরণ (লেগ্যাসি) দেখুন।