Nearby Search (নতুন) এক বা একাধিক জায়গার ধরন নেয় এবং মিলে যাওয়া জায়গার তালিকা দেখায়। নিচের উদাহরণে, আপনি কোনও জায়গার ধরন বেছে নিতে এবং ম্যাপে ফলাফল দেখতে পারবেন। জায়গা সম্পর্কে আরও তথ্য দেখতে মার্কারগুলিতে ক্লিক করুন।
নিয়ারবাই Search (নতুন) আপনার উল্লেখ করা জায়গার ধরনের উপর ভিত্তি করে
এক সেট জায়গা সম্পর্কে তথ্য প্রদান করে — যেমন restaurant বা book_store
বা bowling_alley। পরিষেবাটি নির্দিষ্ট locationRestriction-এর ব্যাসার্ধের মধ্যে নির্দিষ্ট স্থানের প্রকারের সাথে মেলে এমন স্থানগুলির একটি তালিকা সহ প্রতিক্রিয়া জানায়।
নিয়ারবাই Search (নতুন) ব্যবহার করতে, আপনার Google Cloud প্রোজেক্টে "Places API (নতুন)" চালু করতে হবে। বিস্তারিত জানতে শুরু করা যাক বিকল্প দেখুন।
কাছাকাছি জায়গা খুঁজুন
নির্দিষ্ট জায়গার ধরন, লোকেশন ও ব্যাসার্ধের উপর ভিত্তি করে জায়গার তালিকা পেতে
searchNearby() কল করুন। অনুরোধ ব্যবহার করে
সার্চ প্যারামিটার নির্দিষ্ট করুন এবং তারপর searchNearby() কল করুন। ফলাফল Placeটি অবজেক্টের তালিকা হিসেবে
দেখানো হয়, যেখান থেকে আপনি
জায়গার বিবরণ পেতে পারেন।
নিচের স্নিপেট থেকে searchNearby()-এ অনুরোধ ও কল করার উদাহরণ দেখানো হয়েছে:
TypeScript
// Get bounds and radius to constrain search. center = mapElement.center!; const ne = innerMap.getBounds()!.getNorthEast(); const sw = innerMap.getBounds()!.getSouthWest(); const diameter = spherical.computeDistanceBetween(ne, sw); const radius = Math.min(diameter / 2, 50000); // Radius cannot be more than 50000. const request = { // required parameters fields: [ 'displayName', 'location', 'formattedAddress', 'googleMapsURI', ], locationRestriction: { center, radius, }, // optional parameters includedPrimaryTypes: [typeSelect.value], maxResultCount: 5, rankPreference: SearchNearbyRankPreference.POPULARITY, }; const { places } = await Place.searchNearby(request);
জাভাস্ক্রিপ্ট
// Get bounds and radius to constrain search. center = mapElement.center; const ne = innerMap.getBounds().getNorthEast(); const sw = innerMap.getBounds().getSouthWest(); const diameter = spherical.computeDistanceBetween(ne, sw); const radius = Math.min(diameter / 2, 50000); // Radius cannot be more than 50000. const request = { // required parameters fields: [ 'displayName', 'location', 'formattedAddress', 'googleMapsURI', ], locationRestriction: { center, radius, }, // optional parameters includedPrimaryTypes: [typeSelect.value], maxResultCount: 5, rankPreference: SearchNearbyRankPreference.POPULARITY, }; const { places } = await Place.searchNearby(request);
- এক বা একাধিক ডেটা ফিল্ডের কমা দিয়ে আলাদা করা তালিকা উল্লেখ করতে
fieldsপ্যারামিটার (প্রয়োজনীয়) ব্যবহার করুন। আপনি যে ফিল্ডের জন্য অনুরোধ করেন সেটি অনুরোধের দাম সেট করে। ডেটা ফিল্ড বেছে নিন বিকল্প দেখুন। - ৫০,০০০ মিটার পর্যন্ত ব্যাসার্ধ নির্দিষ্ট করতে
locationRestrictionপ্যারামিটার (প্রয়োজনীয়) ব্যবহার করুন। - সার্চ করার জন্য এক বা একাধিক জায়গার ধরন নির্দিষ্ট করতে
includedPrimaryTypesপ্যারামিটার ব্যবহার করুন। POPULARITYবাDISTANCE-এরSearchNearbyRankPreferenceনির্দিষ্ট করতেrankPreferenceপ্যারামিটার ব্যবহার করুন।- প্যারামিটারের সম্পূর্ণ তালিকা দেখুন।
উদাহরণ
নিম্নলিখিত উদাহরণে searchNearby() ব্যবহার করে ম্যাপ বাউন্ডের মধ্যে বেছে নেওয়া ধরনের জায়গা কোয়েরি করা হয়
এবং ফলাফল দেখানোর জন্য মার্কার সহ ম্যাপে তথ্য দেখানো হয়।
TypeScript
const mapElement = document.querySelector('gmp-map')!; let innerMap: google.maps.Map; let center: google.maps.LatLngLiteral | google.maps.LatLng; let typeSelect: HTMLSelectElement; let infoWindow: google.maps.InfoWindow; async function init() { const [{ InfoWindow }, { event }] = await Promise.all([ google.maps.importLibrary('maps'), google.maps.importLibrary('core'), ]); innerMap = mapElement.innerMap; innerMap.setOptions({ mapTypeControl: false, }); typeSelect = document.querySelector('.type-select')!; typeSelect.addEventListener('change', () => { void nearbySearch(); }); infoWindow = new InfoWindow(); // Kick off an initial search once map has loaded. event.addListenerOnce(innerMap, 'idle', () => { void nearbySearch(); }); } async function nearbySearch() { const [ { Place, SearchNearbyRankPreference }, { AdvancedMarkerElement }, { spherical }, ] = await Promise.all([ google.maps.importLibrary('places'), google.maps.importLibrary('marker'), google.maps.importLibrary('geometry'), ]); // Get bounds and radius to constrain search. center = mapElement.center!; const ne = innerMap.getBounds()!.getNorthEast(); const sw = innerMap.getBounds()!.getSouthWest(); const diameter = spherical.computeDistanceBetween(ne, sw); const radius = Math.min(diameter / 2, 50000); // Radius cannot be more than 50000. const request = { // required parameters fields: [ 'displayName', 'location', 'formattedAddress', 'googleMapsURI', ], locationRestriction: { center, radius, }, // optional parameters includedPrimaryTypes: [typeSelect.value], maxResultCount: 5, rankPreference: SearchNearbyRankPreference.POPULARITY, }; const { places } = await Place.searchNearby(request); if (places.length) { const { LatLngBounds } = await google.maps.importLibrary('core'); const bounds = new LatLngBounds(); // First remove all existing markers. for (const marker of mapElement.querySelectorAll('gmp-advanced-marker')) marker.remove(); // Loop through and get all the results. places.forEach((place) => { if (!place.location) return; bounds.extend(place.location); const marker = new AdvancedMarkerElement({ map: innerMap, position: place.location, title: place.displayName, gmpClickable: true, }); // Build the content of the InfoWindow safely using DOM elements. const content = document.createElement('div'); const address = document.createElement('div'); address.textContent = place.formattedAddress || ''; const placeId = document.createElement('div'); placeId.textContent = place.id; content.append(address, placeId); if (place.googleMapsURI) { const link = document.createElement('a'); link.href = place.googleMapsURI; link.target = '_blank'; link.textContent = 'View Details on Google Maps'; content.appendChild(link); } marker.addEventListener('gmp-click', () => { innerMap.panTo(place.location!); updateInfoWindow(place.displayName!, content, marker); }); }); innerMap.fitBounds(bounds, 100); } else { console.log('No results'); } } function updateInfoWindow( title: string | Element | null, content: string | Element | null, anchor: google.maps.marker.AdvancedMarkerElement ) { infoWindow.setContent(content); infoWindow.setHeaderContent(title); infoWindow.open({ anchor, }); } void init();
জাভাস্ক্রিপ্ট
const mapElement = document.querySelector('gmp-map'); let innerMap; let center; let typeSelect; let infoWindow; async function init() { const [{ InfoWindow }, { event }] = await Promise.all([ google.maps.importLibrary('maps'), google.maps.importLibrary('core'), ]); innerMap = mapElement.innerMap; innerMap.setOptions({ mapTypeControl: false, }); typeSelect = document.querySelector('.type-select'); typeSelect.addEventListener('change', () => { void nearbySearch(); }); infoWindow = new InfoWindow(); // Kick off an initial search once map has loaded. event.addListenerOnce(innerMap, 'idle', () => { void nearbySearch(); }); } async function nearbySearch() { const [ { Place, SearchNearbyRankPreference }, { AdvancedMarkerElement }, { spherical }, ] = await Promise.all([ google.maps.importLibrary('places'), google.maps.importLibrary('marker'), google.maps.importLibrary('geometry'), ]); // Get bounds and radius to constrain search. center = mapElement.center; const ne = innerMap.getBounds().getNorthEast(); const sw = innerMap.getBounds().getSouthWest(); const diameter = spherical.computeDistanceBetween(ne, sw); const radius = Math.min(diameter / 2, 50000); // Radius cannot be more than 50000. const request = { // required parameters fields: [ 'displayName', 'location', 'formattedAddress', 'googleMapsURI', ], locationRestriction: { center, radius, }, // optional parameters includedPrimaryTypes: [typeSelect.value], maxResultCount: 5, rankPreference: SearchNearbyRankPreference.POPULARITY, }; const { places } = await Place.searchNearby(request); if (places.length) { const { LatLngBounds } = await google.maps.importLibrary('core'); const bounds = new LatLngBounds(); // First remove all existing markers. for (const marker of mapElement.querySelectorAll('gmp-advanced-marker')) marker.remove(); // Loop through and get all the results. places.forEach((place) => { if (!place.location) return; bounds.extend(place.location); const marker = new AdvancedMarkerElement({ map: innerMap, position: place.location, title: place.displayName, gmpClickable: true, }); // Build the content of the InfoWindow safely using DOM elements. const content = document.createElement('div'); const address = document.createElement('div'); address.textContent = place.formattedAddress || ''; const placeId = document.createElement('div'); placeId.textContent = place.id; content.append(address, placeId); if (place.googleMapsURI) { const link = document.createElement('a'); link.href = place.googleMapsURI; link.target = '_blank'; link.textContent = 'View Details on Google Maps'; content.appendChild(link); } marker.addEventListener('gmp-click', () => { innerMap.panTo(place.location); updateInfoWindow(place.displayName, content, marker); }); }); innerMap.fitBounds(bounds, 100); } else { console.log('No results'); } } function updateInfoWindow(title, content, anchor) { infoWindow.setContent(content); infoWindow.setHeaderContent(title); infoWindow.open({ anchor, }); } void init();
CSS
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ gmp-map { height: 100%; } #map-container { display: flex; flex-direction: row; height: 100%; } /* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; } .type-select { width: 400px; height: 32px; border: 1px solid #000; border-radius: 10px; flex-grow: 1; padding: 0 10px; margin-left: 10px; margin-top: 10px; }
HTML
<html>
<head>
<title>Nearby Search</title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
<script>
// prettier-ignore
(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
key: "GOOGLE_MAPS_API_KEY"
});
</script>
</head>
<body>
<gmp-map center="45.438646,12.327573" zoom="14" map-id="DEMO_MAP_ID"
><!-- Map id is required for Advanced Markers. -->
<gmp-advanced-marker></gmp-advanced-marker>
<div id="controls" slot="control-inline-start-block-start">
<select name="types" class="type-select">
<option value="cafe" selected>Cafe</option>
<option value="restaurant">Restaurant</option>
<option value="museum">Museum</option>
<option value="monument">Monument</option>
<option value="park">Park</option>
</select>
</div>
</gmp-map>
</body>
</html>ডেটা ফিল্ড বেছে নিন
আপনি যেসব ফিল্ডের জন্য অনুরোধ করেন, সেগুলি প্রতিটি সার্চ অনুরোধের দাম সেট করে। অনুরোধের জন্য
একবার বিল করা হয়,
অনুরোধ করা ফিল্ডের মধ্যে
সর্বোচ্চ SKU-তে। যেমন,
fields
-এ
reviews
যোগ করলে,
সম্পূর্ণ অনুরোধের জন্য নিয়ারবাই Search Enterprise + Atmosphere হিসেবে বিল করা হয়।
Nearby Search Pro-তে সার্চের অনুরোধ রাখতে, শুধুমাত্র সেইসব ফিল্ডের জন্য অনুরোধ করুন
যেগুলি আপনার সার্চ ফলাফলে দেখানো হয়, যেমন
id,
displayName,
formattedAddress,
এবং
location।
কোনও ব্যবহারকারী কোনও জায়গা বেছে নিলে,
fetchFields()
কল করুন
সেই জায়গায় যাতে
reviews,
nationalPhoneNumber,
বা
websiteURI-এর মতো ফিল্ড পাওয়া যায়।
প্রতিটি fetchFields()
কল হল একটি পৃথক জায়গার বিবরণ সংক্রান্ত অনুরোধ, যা অনুরোধ করা ফিল্ডগুলির মধ্যে
সর্বোচ্চ SKU-তে বিল করা হয়। এই পদ্ধতি টাকা সাশ্রয় করে কিনা তা নির্ভর করে আপনার ব্যবহারকারীরা কতগুলি
জায়গা খোলেন তার উপর।
প্রতিটি SKU ট্রিগার করে এমন ফিল্ড
নিম্নলিখিত ফিল্ডগুলি Nearby Search Pro SKU ট্রিগার করে:
accessibilityOptions
addressComponents
adrFormatAddress
businessStatus
displayName
formattedAddress
googleMapsUri
iconBackgroundColor
id
location
photos
plusCode
svgIconMaskURI
types
utcOffsetMinutes
viewport
নিম্নলিখিত ফিল্ডগুলি নিয়ারবাই Search Enterprise SKU ট্রিগার করে:
internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteURIনিম্নলিখিত ফিল্ডগুলি Nearby Search Enterprise + Atmosphere SKU ট্রিগার করে:
allowsDogs
editorialSummary
evChargeOptions
fuelOptions
hasCurbsidePickup
hasDelivery
hasDineIn
hasLiveMusic
hasMenuForChildren
hasOutdoorSeating
hasRestroom
hasTakeout
hasWifi
isGoodForChildren
isGoodForGroups
isGoodForWatchingSports
isReservable
parkingOptions
paymentOptions
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
প্রতিটি ফিল্ডের SKU-এর জন্য, জায়গা ক্লাস ডেটা ফিল্ড দেখুন।