टेक्स्ट सर्च (नया)

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा

टेक्स्ट सर्च (नया) एक टेक्स्ट क्वेरी लेता है और उससे मेल खाने वाली जगहों की सूची दिखाता है.

टेक्स्ट सर्च (नया) किसी स्ट्रिंग के आधार पर जगहों के सेट के बारे में जानकारी दिखाता है — उदाहरण के लिए, "न्यूयॉर्क में पिज़्ज़ा" या "ओटावा के पास जूतों की दुकान" या "123 मेन स्ट्रीट". सेवा, टेक्स्ट स्ट्रिंग से मेल खाने वाली जगहों की सूची के साथ जवाब देती है. साथ ही, जगह के लिए सेट किए गए पूर्वाग्रह के बारे में भी जानकारी मिलती है. टेक्स्ट सर्च (नई सुविधा) की मदद से, टाइप के हिसाब से जगहें खोजी जा सकती हैं. साथ ही, कारोबार के खुले होने का समय और रेटिंग जैसी शर्तों का इस्तेमाल करके जगहों को फ़िल्टर किया जा सकता है. इसके अलावा, नतीजों को किसी खास जगह तक सीमित किया जा सकता है या उनके साथ भेदभाव किया जा सकता है.

टेक्स्ट सर्च (नया) का इस्तेमाल करने के लिए, आपको अपने Google Cloud प्रोजेक्ट पर "Locations 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);
index.ts

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);

index.js
  • 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();
index.ts

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();
index.js

सीएसएस

/* 
 * 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;
}

style.css

एचटीएमएल

<html>
  <head>
    <title>Text Search</title>
    <script src="https://polyfill.io/v3/polyfill.min.js?features=default"></script>

    <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>
index.html

सैंपल आज़माएं