আপনি একটি নির্দিষ্ট স্থাপনা বা আগ্রহের স্থান সম্পর্কে আরও বিশদ বিবরণের অনুরোধ করতে পারেন তার স্থান আইডি ব্যবহার করে এবং একটি স্থানের বিবরণ (নতুন) অনুরোধ করে। স্থানের বিবরণ (নতুন) নির্দেশিত স্থান সম্পর্কে আরও ব্যাপক তথ্য প্রদান করে, যেমন এর সম্পূর্ণ ঠিকানা, ফোন নম্বর, ব্যবহারকারীর রেটিং এবং পর্যালোচনা।
একটি স্থান আইডি প্রাপ্ত করার অনেক উপায় আছে. আপনি ব্যবহার করতে পারেন:
স্থান বিবরণ (নতুন) অনুরোধ
আপনি 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একটি তালিকা পাস করুন। প্রতিক্রিয়ায় প্রত্যাবর্তিত ক্ষেত্রগুলির কোনও ডিফল্ট তালিকা নেই।আপনি অপ্রয়োজনীয় ডেটার অনুরোধ করবেন না তা নিশ্চিত করার জন্য ক্ষেত্র তালিকাগুলি একটি ভাল নকশা অনুশীলন, যা অপ্রয়োজনীয় প্রক্রিয়াকরণের সময় এবং বিলিং চার্জ এড়াতে সহায়তা করে৷ এই তালিকাটি একটি গুরুত্বপূর্ণ বিবেচনা কারণ এটি প্রতিটি অনুরোধের জন্য খরচকে প্রভাবিত করে৷ আরও তথ্যের জন্য, ব্যবহার এবং বিলিং দেখুন।
নিম্নলিখিত ক্ষেত্রগুলির মধ্যে এক বা একাধিক নির্দিষ্ট করুন:
নিম্নলিখিত ক্ষেত্রগুলি স্থানের বিবরণ ট্রিগার করে (শুধুমাত্র আইডি) SKU :
Place.Field.ID,Place.Field.NAME,Place.Field.PHOTO_METADATASনিম্নলিখিত ক্ষেত্রগুলি স্থানের বিবরণ ট্রিগার করে (শুধু অবস্থান) SKU :
Place.Field.ADDRESS_COMPONENTSADDRESS_COMPONENTS ,Place.Field.ADDRESSADDRESS ,Place.Field.LAT_LNG,Place.Field.PLUS_CODEPLUS_CODE ,Place.Field.TYPES,Place.Field.VIEWPORTনিম্নলিখিত ক্ষেত্রগুলি স্থানের বিবরণ (বেসিক) SKU ট্রিগার করে:
Place.Field.BUSINESS_STATUS,Place.Field.ICON_BACKGROUND_COLORICON_BACKGROUND_COLOR ,Place.Field.ICON_URL,Place.Field.UTC_OFFSET,Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCEWHEELCHAIR_ACCESSIBLE_ENTRANCEনিম্নলিখিত ক্ষেত্রগুলি স্থানের বিবরণ (উন্নত) SKU ট্রিগার করে:
Place.Field.CURRENT_OPENING_HOURSPlace.Field.SECONDARY_OPENING_HOURSPlace.Field.PHONE_NUMBERPlace.Field.PRICE_LEVELPlace.Field.RATINGPlace.Field.OPENING_HOURSPlace.Field.USER_RATINGS_TOTALPlace.Field.WEBSITE_URIনিম্নলিখিত ক্ষেত্রগুলি স্থানের বিশদ বিবরণ (পছন্দের) SKU :
Place.Field.CURBSIDE_PICKUP,Place.Field.DELIVERY,Place.Field.DINE_IN,Place.Field.EDITORIAL_SUMMARY,Place.Field.RESERVABLE,Place.Field.REVIEWSPlace.Field.SERVES_BEERPlace.Field.SERVES_BREAKFASTPlace.Field.SERVES_BRUNCHPlace.Field.SERVES_DINNERPlace.Field.SERVES_LUNCHPlace.Field.SERVES_VEGETARIAN_FOODPlace.Field.SERVES_WINEPlace.Field.TAKEOUT
ঐচ্ছিক পরামিতি
FetchPlaceRequest এর জন্য ঐচ্ছিক পরামিতি হল:
অঞ্চল কোড
উত্তর ফর্ম্যাট করতে ব্যবহৃত অঞ্চল কোড, একটি দুই-অক্ষরের CLDR কোড মান হিসাবে নির্দিষ্ট করা হয়েছে। কোন ডিফল্ট মান নেই।
যদি উত্তরে
Place.Field.ADDRESSক্ষেত্রের দেশের নামregionCodeসাথে মিলে যায়, তাহলেPlace.Field.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 , NAME এবং 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.NAME, Place.Field.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);