এই ডকুমেন্টে, আপনি জানতে পারবেন কিভাবে Nearby Search (New) API ব্যবহার করে একটি সহজ এবং সাশ্রয়ী সমাধান তৈরি করা যায়।
স্থানীয় আবিষ্কারের অভিজ্ঞতা।
হোটেল বা রিয়েল এস্টেট খোঁজার সময়, লোকাল ডিসকভারি এক্সপেরিয়েন্স ব্যবহারকারীদেরকে আপনার নির্দিষ্ট করা অবস্থানের কাছাকাছি গুরুত্বপূর্ণ দর্শনীয় স্থানগুলো দেখায়। এতে প্রায়শই একটি ইন্টারেক্টিভ ম্যাপ থাকে, যার সাথে একটি অতিরিক্ত প্যানেলে স্থান বাছাই করার সুবিধা এবং ছবির গ্যালারি থাকে। ইন্টারঅ্যাক্টিভিটির মাধ্যমে অভিজ্ঞতাটিকে আরও উন্নত করতে আপনাকে গুগল ম্যাপস প্ল্যাটফর্মের বিভিন্ন প্রোডাক্ট এবং সক্ষমতা দেখানো হবে।

ব্যবহারের ক্ষেত্র
এখন চলুন বোঝা যাক, লোকাল ডিসকভারি ইন্টিগ্রেশনের কোন উপাদানগুলো ব্যবহারকারীর জন্য সুবিধা বয়ে আনে:
আবিষ্কার - বিভিন্ন ধরণের প্রাসঙ্গিক স্থান প্রদর্শনের মাধ্যমে ব্যবহারকারীদের একটি নির্দিষ্ট স্থানের আশেপাশে কী আছে তার একটি সামগ্রিক ধারণা দিন।
মিথস্ক্রিয়াশীলতা - ব্যবহারকারীদের একটি স্থান নির্বাচন করতে এবং গতিশীলভাবে ডেটা রিফ্রেশ করার ক্ষমতা প্রদান করা।
সেই স্থানের সাপেক্ষে।
ভিজ্যুয়ালাইজেশন - স্থানগুলির পর্যালোচনা, ছবি প্রদান করুন
এবং হাঁটার সময় ও দূরত্ব, যাতে ব্যবহারকারীরা দ্রুত বুঝতে পারেন এটি তাদের প্রয়োজনের জন্য উপযুক্ত কিনা।
রেফারেন্স আর্কিটেকচার

স্থানীয় আবিষ্কার
স্থানীয় তথ্য খুঁজে বের করার অভিজ্ঞতা তৈরি করার অনেক উপায় আছে। নিম্নলিখিত ইন্টিগ্রেশনটি একটি কাস্টম ইউজার এক্সপেরিয়েন্সের উদাহরণ , যা সুপরিচিত গুগল ম্যাপস প্ল্যাটফর্ম এপিআই (API)-এর পাশাপাশি কিছু আকর্ষণীয় নতুন ফিচারও ব্যবহার করে। আপনি যদি স্থানীয় তথ্য খুঁজে বের করার জন্য একটি টেমপ্লেট-ভিত্তিক পদ্ধতি চান, তাহলে ওয়েব কম্পোনেন্টস (Web Components) ব্যবহার করতে পারেন।
নমুনা অ্যাপ্লিকেশন
নমুনা ওয়াকথ্রু
নিচের টেবিলে আপনি নমুনা অ্যাপ্লিকেশনটি ধাপে ধাপে বিভক্ত করে পাবেন, সাথে গুগল ম্যাপস প্ল্যাটফর্ম এপিআই ব্যবহার করে এর প্রযুক্তিগত বাস্তবায়নের বর্ণনাও থাকবে।
১. স্বয়ংক্রিয় সম্পূর্ণতার সাহায্যে অবস্থান অনুসন্ধান করুন
- ম্যাপ জাভাস্ক্রিপ্ট এপিআই লোড করুন।
- স্থান অনুসন্ধানে স্বয়ংক্রিয়ভাবে পূরণ করুন অথবা মানচিত্র থেকে অবস্থান বাছাই করুন।

২. নিয়ারবাই সার্চ (নতুন) এপিআই ব্যবহার করে স্থানীয় আকর্ষণীয় স্থানগুলো খুঁজে বের করুন।
- জনপ্রিয়তার ক্রম (আরও প্রাসঙ্গিক ফলাফল) অথবা দূরত্বের ক্রম।
-
includedTypes,excludedTypes; আপনি যদি একটি হোটেল হন, তাহলে আপনি “lodging” টাইপটি বাদ দিতে পারেন এবং শুধুমাত্র উপযুক্ত টাইপগুলো অন্তর্ভুক্ত করতে পারেন, যেমন: “restaurant, cafe, park, tourit_attraction”। - ফলাফলের উপর আরও বেশি নিয়ন্ত্রণ পেতে
includedPrimaryTypesএবংexcludedPrimaryTypesব্যবহার করুন। - ফলাফলের সংখ্যা অপর্যাপ্ত হওয়া বা স্থান অনেক দূরে হওয়া এড়ানোর জন্য অবস্থান সীমাবদ্ধতা; কোনো ফলাফল না পাওয়া গেলে, ফলাফল প্রদর্শনের আগে বৃত্ত / আয়তক্ষেত্রের আকার বড় করা হয়।

ডেটা ফিল্ড অনুরোধ করে হোটেল বুক করার সময় কোয়েরির নমুনা:
- বেসিক (
displayName,types,openingHours,formattedAddress) - যোগাযোগ (
websiteUri,nationalPhoneNumber,internationalPhoneNumber) - পছন্দের (
reviews,priceLevel,userRatingCount)
{ "includedTypes": ["restaurant","cafe","park"], "excludedTypes":
["lodging","convenience_store"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }ডেটা ফিল্ড অনুরোধ করে রিয়েল এস্টেট অনুসন্ধানের সময় কোয়েরির নমুনা:
- বেসিক (
displayName,types,openingHours,formattedAddress)
{ "includedTypes": ["school","transport","bus","convenience_store"],
"excludedTypes": ["lodging"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }৩. ডাইনামিক ম্যাপস অ্যান্ড ডিরেকশনস এপিআই (Dynamic Maps and Directions API) ব্যবহার করে ইন্টারঅ্যাকটিভিটি যোগ করুন।
- Directions API থেকে তথ্য নিয়ে আপনার যাত্রাপথ ও পদক্ষেপের সংখ্যা হালনাগাদ করুন। * পরবর্তী বিভাগে সময় ব্যবহার করুন।

৪. মিথস্ক্রিয়ার পর স্থানটির বিস্তারিত তথ্য প্রদর্শন করুন।
বিবরণ :
displayName,types,rating,userRatingCount,priceLevel।সময় : পূর্ববর্তী Directions API কোয়েরি থেকে প্রাপ্ত।
পর্যালোচনা :
reviews[i].author,reviews[i].rating,reviews[i].text.ছবি : নিয়ারবাই সার্চ (নতুন) এপিআই-এর আনরেস্ট্রিকটেড প্রিভিউ চলাকালীন, আপনাকে photo_reference পাওয়ার জন্য
place.idদিয়ে প্লেসের বিবরণ কোয়েরি করতে হবে, এবং তারপর আপনার এক্সপেরিয়েন্সে একটি একটি করে ছবি কোয়েরি করতে হবে।

কোয়েরির সংখ্যা এবং সংশ্লিষ্ট খরচ
- ম্যাপস জাভাস্ক্রিপ্ট এপিআই : অভিজ্ঞতা লোড হওয়ার সময় ১টি ম্যাপ।
- প্লেসেস অটোকমপ্লিট এপিআই: টাইপ করা প্রতিটি অক্ষরের জন্য ১টি কোয়েরি (যদি অটোকমপ্লিট উইজেট ব্যবহার করা হয়), এটি কাস্টমাইজ করা যায়।
- নিকটবর্তী অনুসন্ধান (নতুন) এপিআই : প্রতি ২০টি স্থান প্রদর্শনের জন্য ১টি কোয়েরি। কোয়েরি প্রতিক্রিয়ার অংশ হিসেবে থাকা স্থানের তথ্য অনুযায়ী ভিন্ন বিলিং।
- দিকনির্দেশনা এপিআই : ব্যবহারকারীর নির্বাচিত প্রতিটি স্থান সম্পর্কে জিজ্ঞাসা করে।
- প্লেস ফটো এপিআই : প্রদর্শিত প্রতিটি ছবির জন্য ১টি কোয়েরি।
উপসংহার
স্থানীয় আবিষ্কারের অভিজ্ঞতা ব্যবহারকারীকে সুবিধা প্রদানের একটি শক্তিশালী উপায়। এই প্রদর্শনী বাস্তবায়নে এমন অনেক বৈশিষ্ট্য রয়েছে যা আপনি সম্ভবত গুগল ম্যাপস প্ল্যাটফর্মে নিয়ারবাই সার্চ (নতুন) এপিআই- এর বিশেষ সক্ষমতা ব্যবহার করে এই ধরনের অভিজ্ঞতা তৈরি করার সময় অন্তর্ভুক্ত করবেন।
পরবর্তী পদক্ষেপ
আরও পড়ার জন্য পরামর্শ:
- Maps জাভাস্ক্রিপ্ট এপিআই-এর ওয়েব উপাদানসমূহ
- স্থান স্বয়ংসম্পূর্ণ অপ্টিমাইজেশন
- অন্যান্য স্থানের পরিষেবা
- নিচে আপনার মতামত জানান।
অবদানকারীরা
প্রধান লেখকগণ:
টমাস অ্যাংলারেট | গুগল ম্যাপস প্ল্যাটফর্ম সলিউশনস ইঞ্জিনিয়ার