Autocomplete Data

AutocompleteSuggestion class

google.maps.places.AutocompleteSuggestion ক্লাস
লাইব্রেরি "places"

অটোকমপ্লিট সাজেশনের ফলাফল।

const {AutocompleteSuggestion} = await google.maps.importLibrary("places");
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
প্যারামিটার:
রিটার্ন ভ্যালু: Promise<{suggestions:Array<AutocompleteSuggestion>}>
AutocompleteSuggestions-এর তালিকা নিয়ে আসে।

অনুরোধে AutocompleteRequest.sessionToken প্রদান করা হলে, প্রথমবার Place.fetchFields কল করার সময় সেই সেশন টোকেন অটোমেটিক অন্তর্ভুক্ত করা হবে, প্রতিটি Place-এ যা PlacePrediction.toPlace-এর মাধ্যমে ফলাফল হিসেবে পাওয়া PlacePrediction-এ ফেরত পাঠানো হয়।
placePrediction
readonly
ধরন: PlacePrediction optional
ফেরত পাঠানো ফলাফলের জন্য মানুষের-পঠনযোগ্য নাম থাকে। প্রতিষ্ঠানের ফলাফলের জন্য, এটি সাধারণত ব্যবসার নাম এবং ঠিকানা।

এই AutocompleteSuggestion আনার জন্য ব্যবহৃত AutocompleteRequest-এ যদি কোনও AutocompleteRequest.sessionToken প্রদান করা হয়ে থাকে, তাহলে PlacePrediction.toPlace-এ কল করার মাধ্যমে ফেরত আসা Place-এ প্রথমবার Place.fetchFields কল করার সময় একই টোকেন অটোমেটিক অন্তর্ভুক্ত করা হবে।

AutocompleteRequest ইন্টারফেস

google.maps.places.AutocompleteRequest ইন্টারফেস

AutocompleteSuggestion.fetchAutocompleteSuggestions-এর জন্য ইন্টারফেসের অনুরোধ করুন।

input
ধরন: string
যে টেক্সট স্ট্রিংয়ে সার্চ করতে হবে।
futureOpeningBusinessesIncluded
ঐচ্ছিক
ধরন: boolean optional
এখনও খোলা হয়নি কিন্তু ভবিষ্যতে খোলা হবে বলে আশা করা হচ্ছে এমন ব্যবসার জন্য জায়গার পূর্বাভাস অন্তর্ভুক্ত করুন।
includedPrimaryTypes
ঐচ্ছিক
ধরন: Array<string> optional
অন্তর্ভুক্ত করা প্রাথমিক জায়গার ধরন (যেমন, "রেস্তোরাঁ" বা "gas_station")।

কোনও জায়গার প্রাথমিক ধরন এই তালিকায় অন্তর্ভুক্ত থাকলে তবেই সেটি দেখানো হয়। সর্বাধিক ৫টি ভ্যালু উল্লেখ করা যেতে পারে। কোনও ধরন উল্লেখ করা না থাকলে, সব ধরনের জায়গা দেখানো হয়।
includedRegionCodes
ঐচ্ছিক
ধরন: Array<string> optional
শুধুমাত্র নির্দিষ্ট অঞ্চলে ফলাফল অন্তর্ভুক্ত করুন, যা সর্বাধিক ১৫টি CLDR দুই-অক্ষরের অঞ্চল কোড হিসেবে নির্দিষ্ট করা হয়েছে। ফাঁকা সেট ফলাফলকে সীমাবদ্ধ করবে না। locationRestriction এবং includedRegionCodes, দুটিই সেট করা থাকলে, ইন্টারসেকশন এলাকায় ফলাফল দেখানো হবে।
inputOffset
ঐচ্ছিক
ধরন: number optional
input-এর শূন্য-ভিত্তিক ইউনিকোড ক্যারেক্টার অফসেট যা input-এ কার্সারের পজিশন নির্দেশ করে। কার্সারের পজিশন, কী ধরনের অনুমান দেখানো হবে তা প্রভাবিত করতে পারে। উল্লেখ করা না থাকলে, ডিফল্ট হিসেবে input-এর দৈর্ঘ্য ব্যবহার করা হয়।
language
ঐচ্ছিক
ধরন: string optional
যে ভাষায় ফলাফল দেখানো হবে। ডিফল্ট হিসেবে ব্রাউজারের পছন্দের ভাষা সেট করা হবে। input-এ ব্যবহৃত ভাষা language-এর থেকে আলাদা হলে অথবা স্থানীয় ভাষা থেকে language-এ জায়গার নাম অনুবাদ করা না থাকলে, ফলাফল মিশ্র ভাষায় দেখানো হতে পারে।
locationBias
ঐচ্ছিক
ধরন: LocationBias optional
নির্দিষ্ট লোকেশনের জন্য পক্ষপাতদুষ্ট ফলাফল।

locationBias অথবা locationRestriction-এর মধ্যে সর্বাধিক একটি সেট করতে হবে। দুটির কোনওটিই সেট করা না থাকলে, IP অ্যাড্রেসের ভিত্তিতে ফলাফল দেখানো হবে, অর্থাৎ IP অ্যাড্রেসকে একটি আনুমানিক লোকেশনের সাথে ম্যাপ করা হবে এবং বায়াসিং সিগন্যাল হিসেবে ব্যবহার করা হবে।
locationRestriction
ঐচ্ছিক
ধরন: LocationRestriction optional
নির্দিষ্ট লোকেশনে ফলাফল সীমাবদ্ধ করুন।

locationBias অথবা locationRestriction-এর মধ্যে সর্বাধিক একটি সেট করতে হবে। দুটির কোনওটিই সেট করা না থাকলে, IP অ্যাড্রেসের ভিত্তিতে ফলাফল দেখানো হবে, অর্থাৎ IP অ্যাড্রেসকে একটি আনুমানিক লোকেশনের সাথে ম্যাপ করা হবে এবং বায়াসিং সিগন্যাল হিসেবে ব্যবহার করা হবে।
origin
ঐচ্ছিক
ধরন: LatLng|LatLngLiteral optional
গন্তব্যের জিওডেসিক দূরত্ব গণনা করার জন্য উৎস বিন্দু (PlacePrediction.distanceMeters হিসেবে ফেরত দেওয়া হয়েছে)। এই মান বাদ দেওয়া হলে, জিওডেসিক দূরত্ব ফেরত দেওয়া হবে না।
pureServiceAreaBusinessesIncluded
ঐচ্ছিক
ধরন: boolean optional
ফিল্ডটি true-তে সেট করা থাকলে, শুধুমাত্র পরিষেবা প্রদানকারী ব্যবসার এলাকা অন্তর্ভুক্ত করুন। শুধুমাত্র পরিষেবা প্রদানকারী ব্যবসা হল এমন ব্যবসা যা সরাসরি গ্রাহকদের লোকেশনে পরিষেবা প্রদান করে কিন্তু ব্যবসার ঠিকানায় গ্রাহকদের পরিষেবা প্রদান করে না। যেমন, ক্লিনিং সার্ভিস বা প্লাম্বারের মতো ব্যবসার ক্ষেত্রে Google Maps-এ কোনও ফিজিক্যাল ঠিকানা বা লোকেশন নাও থাকতে পারে।
region
ঐচ্ছিক
ধরন: string optional
অঞ্চলের কোড, CLDR দুই-অক্ষরের অঞ্চল কোড হিসেবে উল্লেখ করা হয়েছে। এটি ঠিকানা ফর্ম্যাটিং, ফলাফল র‍্যাংকিংকে প্রভাবিত করে এবং কোন ফলাফল দেখানো হবে তা প্রভাবিত করতে পারে। এটি নির্দিষ্ট অঞ্চলে ফলাফল সীমাবদ্ধ করে না।
sessionToken
ঐচ্ছিক
ধরন: AutocompleteSessionToken optional
বিলিংয়ের উদ্দেশ্যে অটোমেটিক সম্পূর্ণ করার সেশন শনাক্ত করে এমন টোকেন। AutocompleteSessionToken-এর মাধ্যমে নতুন সেশন টোকেন জেনারেট করুন।

ব্যবহারকারী কোনও কোয়েরি টাইপ করা শুরু করলে সেশন শুরু হয় এবং তিনি কোনও জায়গা বেছে নিয়ে কল করলে সেশন শেষ হয় Place.fetchFields। প্রতিটি সেশনে একাধিক কোয়েরি থাকতে পারে, যার পরে একটি fetchFields কল থাকে। সেশনের মধ্যে প্রতিটি অনুরোধের জন্য ব্যবহৃত ক্রেডেনশিয়াল অবশ্যই একই Google Cloud Console প্রোজেক্টের হতে হবে। সেশন শেষ হয়ে গেলে, টোকেন আর বৈধ থাকে না; আপনার অ্যাপকে প্রতিটি সেশনের জন্য নতুন টোকেন জেনারেট করতে হবে। sessionToken প্যারামিটার বাদ দেওয়া হলে অথবা আপনি সেশন টোকেন আবার ব্যবহার করলে, সেশনের জন্য এমনভাবে চার্জ করা হয় যেন কোনও সেশন টোকেন প্রদান করা হয়নি (প্রতিটি অনুরোধের জন্য আলাদাভাবে বিল করা হয়)।

AutocompleteSuggestion.fetchAutocompleteSuggestions-এ অনুরোধে সেশন টোকেন প্রদান করা হলে, একই টোকেন অটোমেটিক প্রথম কলে অন্তর্ভুক্ত করা হবে যাতে Place-এ fetchFields পাওয়া যায়, যা ফলাফল হিসেবে পাওয়া AutocompleteSuggestion-এর মধ্যে একটিতে PlacePrediction.toPlace কল করার মাধ্যমে রিটার্ন করা হয়।

আমরা নিম্নলিখিত নির্দেশিকা সাজেস্ট করি:
  • সব 'জায়গা অটোমেটিক সম্পূর্ণ করা' কলের জন্য সেশন টোকেন ব্যবহার করুন।
  • প্রতিটি সেশনের জন্য নতুন টোকেন জেনারেট করুন।
  • প্রতিটি নতুন সেশনের জন্য একটি অনন্য সেশন টোকেন পাস করতে ভুলবেন না। একাধিক সেশনের জন্য একই টোকেন ব্যবহার করলে, প্রতিটি অনুরোধের জন্য আলাদাভাবে বিল করা হবে।

AutocompleteSessionToken ক্লাস

google.maps.places.AutocompleteSessionToken ক্লাস
লাইব্রেরি "places"

অটোকমপ্লিট সেশন ট্র্যাক করার জন্য ব্যবহৃত সেশন টোকেনকে দেখায়।

const {AutocompleteSessionToken} = await google.maps.importLibrary("places");
AutocompleteSessionToken
AutocompleteSessionToken()
প্যারামিটার: কিছু নেই
AutocompleteSessionToken-এর নতুন ইনস্ট্যান্স তৈরি করে।

PlacePrediction ক্লাস

google.maps.places.PlacePrediction ক্লাস
লাইব্রেরি "places"

কোনও জায়গা অটোমেটিক সম্পূর্ণ করার পূর্বাভাসের জন্য পূর্বাভাসের ফলাফল।

const {PlacePrediction} = await google.maps.importLibrary("places");
distanceMeters
readonly
ধরন: number optional
origin উল্লেখ করা থাকলে, origin থেকে মিটারে জিওডেসিকের দৈর্ঘ্য।
mainText
readonly
ধরন: FormattableText optional
জায়গার নাম দেখায়।
placeId
readonly
ধরন: string
সাজেস্ট করা জায়গার অনন্য শনাক্তকারী। এই শনাক্তকারীটি অন্যান্য API-তে ব্যবহার করা যেতে পারে যা স্থান আইডি গ্রহণ করে।
secondaryText
readonly
ধরন: FormattableText optional
জায়গাটি আরও ভালোভাবে শনাক্ত করার জন্য অতিরিক্ত দ্ব্যর্থতা নিরসনকারী ফিচার (যেমন, শহর বা অঞ্চল) দেখায়।
text
readonly
ধরন: FormattableText
ফেরত পাঠানো ফলাফলের জন্য মানুষের-পঠনযোগ্য নাম থাকে। প্রতিষ্ঠানের ফলাফলের জন্য, এটি সাধারণত ব্যবসার নাম এবং ঠিকানা।

text সেইসব ডেভেলপারদের জন্য সাজেস্ট করা হয় যারা একটিমাত্র UI এলিমেন্ট দেখাতে চান। যেসব ডেভেলপার দুটি আলাদা, কিন্তু সম্পর্কিত, UI এলিমেন্ট দেখাতে চান, তারা এর পরিবর্তে PlacePrediction.mainText এবং PlacePrediction.secondaryText ব্যবহার করতে চাইতে পারেন।
types
readonly
ধরন: Array<string>
https://developers.google.com/maps/documentation/places/web-service/place-types লিঙ্কে গিয়ে সারণী ক বা সারণী খ থেকে এই জায়গার ক্ষেত্রে প্রযোজ্য প্রকারের তালিকা।
BetafetchAddressValidation
fetchAddressValidation(request)
প্যারামিটার:
রিটার্ন ভ্যালু: Promise<AddressValidation>
এই স্বয়ংসম্পূর্ণ সেশনের সাথে যুক্ত একটি Address Validation অনুরোধ পাঠায় (স্বয়ংসম্পূর্ণ সেশন টোকেন সহ অনুরোধটি অভ্যন্তরীণভাবে পূরণ করে)। PlacePrediction থেকে কোনও জায়গার তথ্য অটোমেটিক অন্তর্ভুক্ত করা হয় না - এটি অটোমেটিক সম্পূর্ণ করার সেশন ম্যানেজমেন্টে সাহায্য করার জন্য একটি সুবিধাজনক পদ্ধতি।
toPlace
toPlace()
প্যারামিটার: কিছু নেই
রিটার্ন ভ্যালু: Place
এই PlacePrediction-এর Place উপস্থাপনা রিটার্ন করে। জায়গার সম্পূর্ণ বিবরণ পেতে Place.fetchFields-এ পরবর্তী কল করতে হবে।

এই PlacePrediction আনার জন্য ব্যবহৃত AutocompleteRequest-এ AutocompleteRequest.sessionToken প্রদান করা হলে, fetchFields কল করার সময় একই টোকেন অটোমেটিক অন্তর্ভুক্ত করা হবে।

অন্যভাবে, PlaceAutocompleteElement ব্যবহার করার সময় PlacePrediction.toPlace-এর মাধ্যমে ফেরত পাঠানো Place-এ Place.fetchFields-এর প্রথম কলে সেশন টোকেন অটোমেটিক অন্তর্ভুক্ত করা হবে।

StringRange ক্লাস

google.maps.places.StringRange ক্লাস
লাইব্রেরি "places"

প্রদত্ত টেক্সটের মধ্যে সাবস্ট্রিং শনাক্ত করে।

const {StringRange} = await google.maps.importLibrary("places");
endOffset
readonly
ধরন: number
সাবস্ট্রিংয়ের শেষ ইউনিকোড অক্ষরের জিরো-বেসড অফসেট (এক্সক্লুসিভ)।
startOffset
readonly
ধরন: number
সাবস্ট্রিংয়ের প্রথম ইউনিকোড অক্ষরের জিরো-বেসড অফসেট (ইনক্লুসিভ)।

FormattableText ক্লাস

google.maps.places.FormattableText ক্লাস
লাইব্রেরি "places"

জায়গার পূর্বাভাস দেখায় এমন টেক্সট। টেক্সটটি যেমন আছে তেমন বা ফর্ম্যাট করে ব্যবহার করা হতে পারে।

const {FormattableText} = await google.maps.importLibrary("places");
matches
readonly
ধরন: Array<StringRange>
ইনপুট অনুরোধ FormattableText.text-এর কোথায় ম্যাচ করেছে তা শনাক্তকারী স্ট্রিং রেঞ্জের তালিকা। text-এর নির্দিষ্ট অংশ ফর্ম্যাট করতে রেঞ্জ ব্যবহার করা যেতে পারে। স্ট্রিং ম্যাচিং ছাড়া অন্য কোনও মাপকাঠির (যেমন, বানান সংশোধন বা লিপ্যন্তর) ভিত্তিতে ম্যাচিং নির্ধারণ করা হলে, সাবস্ট্রিংগুলি AutocompleteRequest.input-এর সাথে সম্পূর্ণ নাও মিলতে পারে। এইসব ভ্যালু হল FormattableText.text-এর ইউনিকোড ক্যারেক্টার অফসেট। রেঞ্জগুলি ক্রমবর্ধমান অফসেট মানগুলিতে অর্ডার করার গ্যারান্টি দেওয়া হয়।
text
readonly
ধরন: string
টেক্সট যা আছে সেইভাবেই ব্যবহার করা যেতে পারে অথবা FormattableText.matches দিয়ে ফর্ম্যাট করা যেতে পারে।