অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (Places SDK for Android) প্লেস ডিটেইলস (লেগ্যাসি) (Place Details (Legacy)) সমর্থন করে। আপনি যদি প্লেস ডিটেইলস (লেগ্যাসি) (Place Details (Legacy))-এর সাথে পরিচিত হন, তবে প্লেস ডিটেইলস (নিউ) (Place Details (New)) নিম্নলিখিত পরিবর্তনগুলি এনেছে:
একটি নতুন মূল্য নির্ধারণ মডেল ব্যবহার করা হয়েছে। সমস্ত এপিআই-এর মূল্য সংক্রান্ত তথ্যের জন্য, প্লেসেস এসডিকে ফর অ্যান্ড্রয়েড (নিউ) দেখুন।
আপনাকে অবশ্যই
Places.initializeWithNewPlacesApiEnabled()মেথডটি কল করে আপনার অ্যাপটি ইনিশিয়ালাইজ করতে হবে। Places API সার্ভিস নির্বাচন করার বিষয়ে আরও তথ্যের জন্য, আপনার Google Cloud প্রজেক্ট সেট আপ করুন দেখুন।ফিল্ড মাস্কিং আবশ্যক। রেসপন্সে আপনি কোন ফিল্ডগুলো ফেরত পেতে চান, তা আপনাকে অবশ্যই নির্দিষ্ট করতে হবে। ফেরত আসা ফিল্ডগুলোর কোনো ডিফল্ট তালিকা নেই। আপনি যদি এই তালিকাটি বাদ দেন, তাহলে মেথডগুলো একটি এরর ফেরত দেবে।
পরবর্তী অনুচ্ছেদগুলিতে অতিরিক্ত পরিবর্তনগুলি বর্ণনা করা হয়েছে।
Access new place types
প্রতিটি স্থানের সাথে এক বা একাধিক টাইপ ভ্যালু যুক্ত থাকতে পারে। অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (Places SDK for Android) সংস্করণ ৩.৩.০ এবং তার পরবর্তী সংস্করণগুলোতে অনেক নতুন টাইপ ভ্যালু যোগ করা হয়েছে। সম্পূর্ণ তালিকার জন্য, ‘সম্প্রসারিত স্থানের প্রকারভেদ’ (Expanded place types ) দেখুন।
Place.getPlaceTypes() মেথডটি টাইপ ভ্যালুগুলোকে স্ট্রিং ভ্যালুর একটি লিস্ট হিসেবে রিটার্ন করে। রিটার্ন করা ভ্যালুগুলো আপনার Android-এর জন্য Places SDK-এর ভার্সনের উপর নির্ভর করে:
অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (নতুন) : প্লেস টাইপস (নতুন) -এ প্রদর্শিত টেবিল এ এবং টেবিল বি দ্বারা সংজ্ঞায়িত স্ট্রিংগুলি ফেরত দেয়, যার মধ্যে সংস্করণ ৩.৩.০-এ যোগ করা সমস্ত নতুন প্লেস টাইপ অন্তর্ভুক্ত রয়েছে।
অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে :
Place.Typesদ্বারা সংজ্ঞায়িত এনামগুলো রিটার্ন করে, যার মধ্যে সংস্করণ ৩.৩.০ এবং তার পরবর্তী সংস্করণগুলোতে যোগ করা নতুন টাইপগুলো অন্তর্ভুক্ত নয়।
Access place reviews
অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (নতুন) Review ক্লাসটি যুক্ত করেছে, যেখানে কোনো একটি স্থানের রিভিউ থাকে। ‘ Place অবজেক্টটিতে সর্বোচ্চ পাঁচটি রিভিউ থাকতে পারে।
Review ক্লাসে একটি অ্যাট্রিবিউশন এবং একটি অথর অ্যাট্রিবিউশনও থাকতে পারে। আপনি যদি আপনার অ্যাপে রিভিউটি প্রদর্শন করেন, তাহলে আপনাকে অবশ্যই যেকোনো অ্যাট্রিবিউশন বা অথর অ্যাট্রিবিউশনও প্রদর্শন করতে হবে। আরও তথ্যের জন্য, “একটি রিভিউ প্রদর্শন করুন” দেখুন।
আরও তথ্যের জন্য, অ্যাট্রিবিউশন সম্পর্কিত ডকুমেন্টেশন দেখুন।
Access place name language code
অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (লেগ্যাসি)-তে, Place.getName() মেথডটি একটি স্থানের নাম সম্বলিত একটি টেক্সট স্ট্রিং রিটার্ন করে। স্থানের নাম দিয়ে Place অবজেক্টটি পূরণ করতে, আপনাকে অবশ্যই স্থানের বিবরণ অনুরোধের ফিল্ড তালিকায় Place.Field.DISPLAY_NAME অন্তর্ভুক্ত করতে হবে।
Place অবজেক্টটিতে এখন name স্ট্রিংটির জন্য ভাষা কোড রয়েছে। Place অবজেক্টটিতে ভাষা কোড যুক্ত করতে, আপনাকে অবশ্যই:
অনুরোধের ফিল্ড তালিকায়
Place.Field.DISPLAY_NAMEঅন্তর্ভুক্ত করুন। এই মানটি প্রতিক্রিয়াকে এমনভাবে কনফিগার করে যাতেPlaceঅবজেক্টে স্থানের নাম এবং ভাষা কোড উভয়ই অন্তর্ভুক্ত থাকে।PlacesClient.fetchPlace()কল করুন।PlacesClient.findCurrentPlace()ল্যাঙ্গুয়েজ কোড ফিল্ড সমর্থন করে না।Placeঅবজেক্টের ল্যাঙ্গুয়েজ কোড ফিল্ডটি অ্যাক্সেস করতেPlace.getNameLanguageCode()মেথডটি ব্যবহার করুন।
Set region code
Places SDK for Android (New) adds the region code request parameter to Place Details. The region code is used to format the response, specified as a two-character CLDR code value. This parameter can also have a bias effect on the search results. There is no default value. You must enable the new SDK to set the region code.
রেসপন্সের অ্যাড্রেস ফিল্ডের দেশের নাম যদি রিজিওন কোডের সাথে মিলে যায়, তাহলে অ্যাড্রেস থেকে কান্ট্রি কোডটি বাদ দেওয়া হয়।
কিছু উল্লেখযোগ্য ব্যতিক্রম ছাড়া, বেশিরভাগ CLDR কোড ISO 3166-1 কোডের অনুরূপ। উদাহরণস্বরূপ, যুক্তরাজ্যের ccTLD হলো "uk" (.co.uk), যেখানে এর ISO 3166-1 কোড হলো "gb" (যা প্রযুক্তিগতভাবে "The United Kingdom of Great Britain and Northern Ireland" সত্তাটিকে বোঝায়)। প্রযোজ্য আইনের উপর ভিত্তি করে এই প্যারামিটারটি ফলাফলকে প্রভাবিত করতে পারে।
Example request
একটি সম্পূর্ণ উদাহরণের জন্য, স্থানের বিবরণ (নতুন) দেখুন।