टेक्स्ट सर्च (नया) सुविधा, टेक्स्ट क्वेरी को स्वीकार करके, उससे मिलती-जुलती जगहों की सूची दिखाती है.
टेक्स्ट सर्च (नया) की सुविधा, किसी स्ट्रिंग के आधार पर, जगहों के एक सेट के बारे में जानकारी दिखाती है. जैसे, "मुंबई में पिज़्ज़ा" या "दिल्ली के आस-पास के शू स्टोर" या "123 मुख्य सड़क". सेवा, टेक्स्ट स्ट्रिंग और सेट की गई जगह के हिसाब से, जगहों की सूची के साथ जवाब देती है. टेक्स्ट खोज (नया) की सुविधा की मदद से, जगहों को टाइप के हिसाब से खोजा जा सकता है. साथ ही, कारोबार के खुले होने का समय और रेटिंग जैसी शर्तों का इस्तेमाल करके, नतीजों को फ़िल्टर किया जा सकता है. इसके अलावा, नतीजों को किसी खास जगह तक सीमित किया जा सकता है या उनमें किसी खास जगह को प्राथमिकता दी जा सकती है.
टेक्स्ट सर्च (नया) का इस्तेमाल करने के लिए, आपको अपने Google Cloud प्रोजेक्ट पर "Places API (नया)" चालू करना होगा. ज़्यादा जानकारी के लिए, शुरू करना देखें.
टेक्स्ट क्वेरी की मदद से जगहें ढूंढना
टेक्स्ट क्वेरी या फ़ोन नंबर से जगहों की सूची पाने के लिए, कॉल करें searchByText
.
अनुरोध का इस्तेमाल करके खोज पैरामीटर तय करें. इसके बाद, searchByText()
को कॉल करें. नतीजे, Place
ऑब्जेक्ट की सूची के तौर पर दिखाए जाते हैं. इससे आपको जगह की जानकारी मिल सकती है. यहां दिए गए स्निपेट में, searchByText
के लिए अनुरोध और कॉल का उदाहरण दिया गया है:
TypeScript
const request = { textQuery: 'Tacos in Mountain View', fields: ['displayName', 'location', 'businessStatus'], includedType: 'restaurant', locationBias: { lat: 37.4161493, lng: -122.0812166 }, isOpenNow: true, language: 'en-US', maxResultCount: 8, minRating: 3.2, region: 'us', useStrictTypeFiltering: false, }; //@ts-ignore const { places } = await Place.searchByText(request);
JavaScript
const request = { textQuery: "Tacos in Mountain View", fields: ["displayName", "location", "businessStatus"], includedType: "restaurant", locationBias: { lat: 37.4161493, lng: -122.0812166 }, isOpenNow: true, language: "en-US", maxResultCount: 8, minRating: 3.2, region: "us", useStrictTypeFiltering: false, }; //@ts-ignore const { places } = await Place.searchByText(request);
textQuery
पैरामीटर की मदद से खोजने के लिए, कोई टेक्स्ट क्वेरी या फ़ोन नंबर डालें.- एक या एक से ज़्यादा डेटा फ़ील्ड की सूची देने के लिए,
fields
पैरामीटर (ज़रूरी है) का इस्तेमाल करें. यह सूची, कैमल केस में कॉमा लगाकर अलग की गई होनी चाहिए. - सिर्फ़ तय किए गए टाइप के नतीजे दिखाने के लिए,
includedType
पैरामीटर का इस्तेमाल करें. - टेक्स्ट खोज के नतीजों को किसी खास इलाके के हिसाब से सीमित करने या उनमें किसी खास इलाके के नतीजे दिखाने के लिए,
locationBias
याlocationRestriction
का इस्तेमाल करें.
अगर क्वेरी में फ़ोन नंबर शामिल है, तो क्षेत्र पैरामीटर सेट किया जाना चाहिए. उदाहरण के लिए, अगर आपने जापान में किसी जगह को खोजने के लिए फ़ोन नंबर का इस्तेमाल किया है और अनुरोध करने वाला डोमेन jp
है, तो आपको region
पैरामीटर को 'jp' पर सेट करना होगा. अगर अनुरोध से region
को हटाया जाता है, तो एपीआई डिफ़ॉल्ट रूप से अमेरिका ('us') इलाके पर सेट हो जाएगा.
Place
ऑब्जेक्ट की सूची के तौर पर दिखाए जाते हैं. इनसे आपको जगह की जानकारी मिल सकती है.
उदाहरण
यहां दिए गए उदाहरण में, searchByText
का इस्तेमाल करके, माउंटेन व्यू के आस-पास के टैको रेस्टोरेंट के बारे में जानकारी पाने के लिए क्वेरी की गई है. साथ ही, नतीजे दिखाने के लिए मैप पर मार्कर डाले गए हैं.
TypeScript
let map; let center; async function initMap() { const { Map } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary; center = { lat: 37.4161493, lng: -122.0812166 }; map = new Map(document.getElementById('map') as HTMLElement, { center: center, zoom: 11, mapId: 'DEMO_MAP_ID', }); findPlaces(); } async function findPlaces() { const { Place } = await google.maps.importLibrary("places") as google.maps.PlacesLibrary; const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary; const request = { textQuery: 'Tacos in Mountain View', fields: ['displayName', 'location', 'businessStatus'], includedType: 'restaurant', locationBias: { lat: 37.4161493, lng: -122.0812166 }, isOpenNow: true, language: 'en-US', maxResultCount: 8, minRating: 3.2, region: 'us', useStrictTypeFiltering: false, }; //@ts-ignore const { places } = await Place.searchByText(request); if (places.length) { console.log(places); const { LatLngBounds } = await google.maps.importLibrary("core") as google.maps.CoreLibrary; const bounds = new LatLngBounds(); // Loop through and get all the results. places.forEach((place) => { const markerView = new AdvancedMarkerElement({ map, position: place.location, title: place.displayName, }); bounds.extend(place.location as google.maps.LatLng); console.log(place); }); map.fitBounds(bounds); } else { console.log('No results'); } } initMap();
JavaScript
let map; let center; async function initMap() { const { Map } = await google.maps.importLibrary("maps"); center = { lat: 37.4161493, lng: -122.0812166 }; map = new Map(document.getElementById("map"), { center: center, zoom: 11, mapId: "DEMO_MAP_ID", }); findPlaces(); } async function findPlaces() { const { Place } = await google.maps.importLibrary("places"); const { AdvancedMarkerElement } = await google.maps.importLibrary("marker"); const request = { textQuery: "Tacos in Mountain View", fields: ["displayName", "location", "businessStatus"], includedType: "restaurant", locationBias: { lat: 37.4161493, lng: -122.0812166 }, isOpenNow: true, language: "en-US", maxResultCount: 8, minRating: 3.2, region: "us", useStrictTypeFiltering: false, }; //@ts-ignore const { places } = await Place.searchByText(request); if (places.length) { console.log(places); const { LatLngBounds } = await google.maps.importLibrary("core"); const bounds = new LatLngBounds(); // Loop through and get all the results. places.forEach((place) => { const markerView = new AdvancedMarkerElement({ map, position: place.location, title: place.displayName, }); bounds.extend(place.location); console.log(place); }); map.fitBounds(bounds); } else { console.log("No results"); } } initMap();
सीएसएस
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ #map { height: 100%; } /* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; }
एचटीएमएल
<html> <head> <title>Text Search</title> <link rel="stylesheet" type="text/css" href="./style.css" /> <script type="module" src="./index.js"></script> </head> <body> <div id="map"></div> <!-- prettier-ignore --> <script>(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: "AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg", v: "weekly"});</script> </body> </html>