এই ডকুমেন্টে, আপনি নিয়ারবাই Search (নতুন) API কীভাবে ব্যবহার করতে হয় তা দেখবেন যাতে একটি সহজ এবং সাশ্রয়ী তৈরি করা যায়
স্থানীয় ডিসকভারি অভিজ্ঞতা।
স্থানীয় ডিসকভারি অভিজ্ঞতা ব্যবহারকারীদের কোনও লোকেশনের কাছাকাছি আগ্রহের মূল জায়গাগুলি দেখায় যা আপনি হোটেল বা রিয়েল এস্টেট সার্চ করার সময় উল্লেখ করেন। এতে প্রায়ই একটি ইন্টার্যাক্টিভ ম্যাপ থাকে, যার সাথে জায়গা সম্পর্কিত আরও তথ্য এবং ফটোর গ্যালারি সহ একটি অতিরিক্ত প্যানেল থাকে। ইন্টার্যাক্টিভিটির মাধ্যমে অভিজ্ঞতা উন্নত করতে আপনাকে বিভিন্ন Google Maps Platform প্রোডাক্ট ও ক্ষমতা দেখানো হবে।
ব্যবহারিক ক্ষেত্র
এখন, লোকাল ডিসকভারি ইন্টিগ্রেশনের কোন কোন এলিমেন্ট ব্যবহারকারীর জন্য ভ্যালু তৈরি করে তা বোঝা যাক:
ডিসকভারি - বিভিন্ন ধরনের প্রাসঙ্গিক জায়গা দেখিয়ে ব্যবহারকারীদের কোনও একটি লোকেশনের আশেপাশে কী আছে তার ওভারভিউ দিন।
ইন্টার্যাক্টিভিটি - ব্যবহারকারীদের কোনও জায়গা বেছে নেওয়ার এবং ডায়নামিকভাবে ডেটা রিফ্রেশ করার ক্ষমতা প্রদান করুন
সেই জায়গার সাপেক্ষে।
ভিজ্যুয়ালাইজেশন - জায়গার রিভিউ, ফটো প্রদান করুন
এবং হাঁটার সময় ও দূরত্ব যাতে ব্যবহারকারীরা দ্রুত বুঝতে পারেন যে এটি তাদের প্রয়োজনের সাথে মানানসই কিনা।
রেফারেন্স আর্কিটেকচার
স্থানীয় ডিসকভারি
স্থানীয় ডিসকভারি অভিজ্ঞতা তৈরি করার অনেক উপায় আছে। নিম্নলিখিত ইন্টিগ্রেশন হল ব্যবহারকারীর অভিজ্ঞতার একটি কাস্টম উদাহরণ যা সুপরিচিত Google Maps Platform API-এর পাশাপাশি কিছু আকর্ষণীয় নতুন ফিচারকে কাজে লাগায়। আপনি যদি স্থানীয় ডিসকভারির জন্য টেমপ্লেট ভিত্তিক পদ্ধতি ব্যবহার করতে চান, তাহলে ওয়েব কম্পোনেন্ট ব্যবহার করতে পারেন।
নমুনা অ্যাপ্লিকেশন
স্যাম্পেল ওয়াকথ্রু
নিচের সারণীতে আপনি স্যাম্পেল অ্যাপ্লিকেশনটি ধাপে ধাপে দেখতে পাবেন এবং Google Maps Platform API-এর সাথে প্রযুক্তিগত বাস্তবায়নের বিবরণও পাবেন।
১. অটোমেটিক সম্পূর্ণ করার সুবিধা সহ লোকেশন সার্চলোকেশন সার্চ করুন
- Maps Javascript API লোড করুন।
- জায়গা অটোমেটিক সম্পূর্ণ করা কোয়েরি বা ম্যাপে লোকেশন বেছে নিন।
২. Nearby Search (New) API ব্যবহার করে স্থানীয় দর্শনীয় স্থান সারফেস করুন
- জনপ্রিয়তা র্যাঙ্কিং (আরও প্রাসঙ্গিক ফলাফল) বা দূরত্ব র্যাঙ্কিং।
includedTypes,excludedTypes; আপনি হোটেল হলে, “lodging” ধরন বাদ দিয়ে শুধু উপযুক্ত ধরন যোগ করতে পারেন, যেমন: “restaurant, cafe, park, tourist_attraction”।- ফলাফলের উপর আরও বেশি নিয়ন্ত্রণ পেতে
includedPrimaryTypes,excludedPrimaryTypesব্যবহার করুন। - `locationRestriction যাতে ফলাফলের সংখ্যা কম না হয় বা খুব দূরে জায়গা না দেখায় ; ZERO ফলাফল হলে, ফলাফল দেখানোর আগে সার্কেল / আয়তক্ষেত্রের সাইজ বড় করুন।
হোটেল বুকিং করার সময় কোয়েরির নমুনা, যেখানে ডেটা ফিল্ডের অনুরোধ করা হয়েছে:
- বেসিক (
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 এবং Directions API-এর মাধ্যমে ইন্টারঅ্যাক্টিভিটি যোগ করুন
- Directions API কোয়েরি করে লেগ ও ধাপ আপ-টু-ডেট রাখুন। * পরবর্তী বিভাগে সময় ব্যবহার করুন।
৪. ইন্টার্যাক্ট করার সময় জায়গার বিস্তারিত তথ্য দেখান
বিবরণ:
displayName,types,rating,userRatingCount,priceLevel.সময়: আগের Directions API কোয়েরি থেকে পাওয়া।
রিভিউ:
reviews[i].author,reviews[i].rating,reviews[i].text.ছবি: আশেপাশের সার্চ (নতুন) API-এর আনরেস্ট্রিক্টেড প্রিভিউ চলাকালীন, আপনাকে জায়গার বিবরণ
place.id-এর সাথে কোয়েরি করতে হবে যাতে photo_reference পাওয়া যায় এবং তারপর আপনার অভিজ্ঞতায় একবারে একটি কোয়েরি করতে হবে
কোয়েরির সংখ্যা এবং সংশ্লিষ্ট খরচ
- Maps JavaScript API: অভিজ্ঞতা লোড হওয়ার সময় ১টি ম্যাপ।
- Places Autocomplete API: টাইপ করা প্রতিটি অক্ষরের জন্য ১টি কোয়েরি (যদি অটোমেটিক সম্পূর্ণ করা উইজেট ব্যবহার করা হয়), এটি কাস্টমাইজ করা যেতে পারে।
- Nearby Search (নতুন) API: প্রতি ২০টি জায়গা দেখানোর জন্য ১টি কোয়েরি। কোয়েরির উত্তরে জায়গার ডেটা অনুযায়ী আলাদা বিলিং।
- Directions API: ব্যবহারকারীর বেছে নেওয়া প্রতিটি জায়গার জন্য ১টি কোয়েরি।
- Place Photo API: দেখানো প্রতিটি ফটোর জন্য ১টি কোয়েরি।
উপসংহার
স্থানীয় ডিসকভারি অভিজ্ঞতা হল ব্যবহারকারীকে ভ্যালু প্রদান করার একটি শক্তিশালী উপায়। এই ডেমো ইমপ্লিমেন্টেশনে অনেক ফিচার আছে যা আপনি Google Maps Platform-এ এই ধরনের অভিজ্ঞতা তৈরি করার সময় অন্তর্ভুক্ত করতে পারেন। এর জন্য Nearby Search (New) API -এর বিশেষ ক্ষমতা ব্যবহার করা হয়।
পরবর্তী ধাপ
আরও পড়ার জন্য সাজেস্ট করা বই:
- Maps JavaScript API-তে ওয়েব কম্পোনেন্ট
- Places Autocomplete অপ্টিমাইজেশন
- অন্যান্য Places Services
- নিচে মতামত জানান।
অবদানকারী
প্রধান লেখক:
Thomas Anglaret | Google Maps Platform সলিউশন ইঞ্জিনিয়ার