আপনি কোনো নির্দিষ্ট প্রতিষ্ঠান বা দর্শনীয় স্থানের প্লেস আইডি ব্যবহার করে এবং একটি ‘প্লেস ডিটেইলস (নিউ)’ অনুরোধ করার মাধ্যমে সেটির সম্পর্কে আরও বিস্তারিত তথ্য জানতে পারেন। ‘প্লেস ডিটেইলস (নিউ)’ অনুরোধটি উল্লিখিত স্থান সম্পর্কে আরও বিশদ তথ্য প্রদান করে, যেমন এর সম্পূর্ণ ঠিকানা, ফোন নম্বর, ব্যবহারকারীর রেটিং এবং রিভিউ।
স্থান আইডি পাওয়ার অনেক উপায় আছে। আপনি ব্যবহার করতে পারেন:
স্থানের বিবরণ (নতুন) অনুরোধ
আপনি PlacesClient.fetchPlace() কল করে এবং একটি FetchPlaceRequest অবজেক্ট পাস করে স্থানের বিবরণ অনুরোধ করতে পারেন, যেটিতে একটি স্থানের আইডি এবং ক্ষেত্রের তালিকা থাকবে, সেইসাথে যেকোনো ঐচ্ছিক প্যারামিটারও দিতে পারেন ।
// Define a place ID.
final String placeId = "INSERT_PLACE_ID_HERE";
// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList("INSERT_PLACE_FIELDS_HERE");
// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);
// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);
স্থানের বিবরণ (নতুন) প্রতিক্রিয়া
স্থানের বিবরণ (নতুন) একটি Place অবজেক্ট আকারে ডেটা ফেরত দেয়, যাতে শুধুমাত্র সেই ফিল্ডগুলো অন্তর্ভুক্ত থাকে যা আপনি ফিল্ড তালিকা ব্যবহার করে অনুরোধ করেছেন। স্থানের ডেটার ফলাফল খালি হতে পারে না, তাই শুধুমাত্র ডেটাসহ স্থানের ফলাফলই ফেরত দেওয়া হয় (উদাহরণস্বরূপ, যদি অনুরোধ করা কোনো স্থানে কোনো ছবি না থাকে, তাহলে ফলাফলে ফটো ফিল্ডটি উপস্থিত থাকবে না)।
ডেটা ফিল্ড অ্যাক্সেস করতে, সংশ্লিষ্ট মেথডটি কল করুন। উদাহরণস্বরূপ, স্থানের নাম অ্যাক্সেস করতে, getName() কল করুন।
প্রয়োজনীয় প্যারামিটার
FetchPlaceRequest এর জন্য প্রয়োজনীয় প্যারামিটারগুলো হলো:
স্থান আইডি
একটি পাঠ্য শনাক্তকারী যা কোনো স্থানকে অনন্যভাবে চিহ্নিত করে এবং যা টেক্সট সার্চ (নতুন) , নিয়ারবাই সার্চ (নতুন) , বা অটোকমপ্লিট (নতুন) থেকে পাওয়া যায়। স্থান আইডি সম্পর্কে আরও তথ্যের জন্য, স্থান আইডি ওভারভিউ দেখুন।
ক্ষেত্রের তালিকা
যখন আপনি কোনো স্থানের জন্য অনুরোধ করেন, তখন আপনাকে অবশ্যই নির্দিষ্ট করে দিতে হবে কোন স্থানের ডেটা ফেরত দেওয়া হবে। এটি করার জন্য, ফেরতযোগ্য ডেটা নির্দিষ্ট করে
Place.Fieldভ্যালুগুলোর একটি তালিকা পাস করুন। রেসপন্সে ফেরত আসা ফিল্ডগুলোর কোনো ডিফল্ট তালিকা থাকে না।ফিল্ড লিস্ট একটি ভালো ডিজাইন পদ্ধতি, যা নিশ্চিত করে যে আপনি অপ্রয়োজনীয় ডেটার জন্য অনুরোধ করছেন না। এর ফলে অপ্রয়োজনীয় প্রসেসিং সময় এবং বিলিং চার্জ এড়ানো যায়। এই তালিকাটি একটি গুরুত্বপূর্ণ বিবেচ্য বিষয়, কারণ এটি প্রতিটি অনুরোধের খরচকে প্রভাবিত করে। আরও তথ্যের জন্য, ব্যবহার এবং বিলিং (Usage and Billing) দেখুন।
নিম্নলিখিত ক্ষেত্রগুলির মধ্যে এক বা একাধিক নির্দিষ্ট করুন:
নিম্নলিখিত ফিল্ডগুলি প্লেস ডিটেইলস এসেনশিয়ালস আইডি অনলি SKU সক্রিয় করে:
Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAMEনিম্নলিখিত ফিল্ডগুলি প্লেস ডিটেইলস এসেনশিয়ালস SKU সক্রিয় করে:
Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESSকরা ঠিকানা *
Place.Field.ADDRESS(অপ্রচলিত) এর পরিবর্তে ব্যবহার করুন।
Place.Field.LOCATION*
Place.Field.LAT_LNG(অপ্রচলিত)-এর পরিবর্তে ব্যবহার করুন।
Place.Field.PLUS_CODE
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.TYPES
Place.Field.VIEWPORTনিম্নলিখিত ফিল্ডগুলি প্লেস ডিটেইলস প্রো SKU সক্রিয় করে:
Place.Field.ACCESSIBILITY_OPTIONS*
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE(অপ্রচলিত)-এর পরিবর্তে ব্যবহার করুন।
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
Place.Field.NAMEএর পরিবর্তে এটি ব্যবহার করুন, যা এখন আর ব্যবহৃত হয় না।
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
Place.Field.ICON_URL(অপ্রচলিত)-এর পরিবর্তে ব্যবহার করুন।
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
Place.Field.UTC_OFFSETনিম্নলিখিত ফিল্ডগুলি প্লেস ডিটেইলস এন্টারপ্রাইজ SKU সক্রিয় করে:
Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
Place.Field.PHONE_NUMBERএর পরিবর্তে এটি ব্যবহার করুন, যা এখন আর ব্যবহৃত হয় না।
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT*
Place.Field.USER_RATINGS_TOTALএর পরিবর্তে এটি ব্যবহার করুন, যা এখন আর ব্যবহৃত হয় না।
Place.Field.WEBSITE_URIনিম্নলিখিত ফিল্ডগুলি প্লেস ডিটেইলস এন্টারপ্রাইজ প্লাস SKU সক্রিয় করে:
Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT
ঐচ্ছিক পরামিতি
FetchPlaceRequest এর জন্য ঐচ্ছিক প্যারামিটারগুলো হলো:
অঞ্চল কোড
প্রতিক্রিয়া বিন্যাস করার জন্য ব্যবহৃত অঞ্চল কোডটি একটি দুই-অক্ষরের CLDR কোড মান হিসাবে নির্দিষ্ট করা হয়। এর কোনো ডিফল্ট মান নেই।
যদি রেসপন্সের
Place.Field.FORMATTED_ADDRESSফিল্ডের দেশের নামregionCodeসাথে মিলে যায়, তাহলেPlace.Field.FORMATTED_ADDRESSথেকে কান্ট্রি কোডটি বাদ দেওয়া হয়।কিছু উল্লেখযোগ্য ব্যতিক্রম ছাড়া, বেশিরভাগ CLDR কোড ISO 3166-1 কোডের অনুরূপ। উদাহরণস্বরূপ, যুক্তরাজ্যের ccTLD হলো "uk" (.co.uk), যেখানে এর ISO 3166-1 কোড হলো "gb" (যা প্রযুক্তিগতভাবে "The United Kingdom of Great Britain and Northern Ireland" সত্তাটিকে বোঝায়)। প্রযোজ্য আইনের উপর ভিত্তি করে এই প্যারামিটারটি ফলাফলকে প্রভাবিত করতে পারে।
রিজিওন কোড প্যারামিটার সেট করতে,
FetchPlaceRequestঅবজেক্টটি তৈরি করার সময়setRegionCode()মেথডটি কল করুন।সেশন টোকেন
সেশন টোকেন হলো ব্যবহারকারী-সৃষ্ট স্ট্রিং যা অটোকমপ্লিট (নতুন) কলগুলোকে "সেশন" হিসেবে ট্র্যাক করে। বিলিংয়ের উদ্দেশ্যে, অটোকমপ্লিট (নতুন) একটি ব্যবহারকারীর অটোকমপ্লিট সার্চের কোয়েরি এবং স্থান নির্বাচনের পর্যায়গুলোকে একটি স্বতন্ত্র সেশনে একত্রিত করতে সেশন টোকেন ব্যবহার করে। অটোকমপ্লিট (নতুন) কলের পরে আসা প্লেস ডিটেইলস (নতুন) কলগুলোতে সেশন টোকেনগুলো পাস করা হয়। আরও তথ্যের জন্য, সেশন টোকেন দেখুন।
সেশন টোকেন প্যারামিটার সেট করতে,
FetchPlaceRequestঅবজেক্টটি তৈরি করার সময়setSessionToken()মেথডটি কল করুন।
স্থানের বিবরণের উদাহরণ
নিম্নলিখিত উদাহরণটি নিউ ইয়র্ক সিটির এম্পায়ার স্টেট বিল্ডিং-এর জন্য ID , DISPLAY_NAME এবং FORMATTED_ADDRESS ফিল্ডগুলির তথ্য অনুরোধ করে।
// Define a place ID.
final String placeId = "ChIJaXQRs6lZwokRY6EFpJnhNNE";
// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS);
// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);
// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);