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

टेक्स्ट सर्च (नया) की सुविधा, किसी स्ट्रिंग के आधार पर जगहों के सेट की जानकारी दिखाती है. जैसे, "न्यूयॉर्क में पिज़्ज़ा" या "ओटावा के आस-पास जूते के स्टोर" या "123 मुख्य सड़क". सेवा, टेक्स्ट स्ट्रिंग और सेट की गई जगह के हिसाब से, जगहों की सूची के साथ जवाब देती है.

यह सेवा, ऑटोमेटेड सिस्टम में पते से जुड़ी ऐसी क्वेरी बनाने के लिए खास तौर पर मददगार है जिनमें पता साफ़ तौर पर नहीं बताया गया है. साथ ही, स्ट्रिंग के ऐसे कॉम्पोनेंट जो पते से जुड़े नहीं हैं, वे कारोबारों और पतों से मेल खा सकते हैं. अस्पष्ट पते की क्वेरी के उदाहरणों में, खराब फ़ॉर्मैट वाले पते या ऐसे अनुरोध शामिल हैं जिनमें कारोबार के नाम जैसे ऐसे कॉम्पोनेंट शामिल होते हैं जो पते से जुड़े नहीं होते. पहले दो उदाहरणों जैसे अनुरोधों से शायद कोई नतीजा न मिले. ऐसा तब तक होगा, जब तक कोई जगह — जैसे कि क्षेत्र, जगह से जुड़ी पाबंदी या जगह के हिसाब से रुझान — सेट नहीं की जाती.

टेक्स्ट सर्च (नया) सुविधा, आस-पास के कारोबार खोजने की सुविधा (नई) से मिलती-जुलती है. इन दोनों के बीच मुख्य अंतर यह है कि टेक्स्ट से खोजने की सुविधा (नई) की मदद से, अपनी पसंद के मुताबिक खोज स्ट्रिंग डाली जा सकती है. वहीं, आस-पास खोजने की सुविधा (नई) के लिए, खोजने के लिए कोई खास इलाका चुनना ज़रूरी है.

टेक्स्ट खोज के अनुरोध

टेक्स्ट खोज का अनुरोध इस फ़ॉर्मैट में होता है:

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME);

// Define latitude and longitude coordinates of the search area.
LatLng southWest = new LatLng(37.38816277477739, -122.08813770258874);
LatLng northEast = new LatLng(37.39580487866437, -122.07702325966572);

// Use the builder to create a SearchByTextRequest object.
final SearchByTextRequest searchByTextRequest = SearchByTextRequest.builder("Spicy Vegetarian Food", placeFields)
  .setMaxResultCount(10)
  .setLocationRestriction(RectangularBounds.newInstance(southWest, northEast)).build();

// Call PlacesClient.searchByText() to perform the search.
// Define a response handler to process the returned List of Place objects.
placesClient.searchByText(searchByTextRequest)
    .addOnSuccessListener(response -> {
      List<Place> places = response.getPlaces();
    });

इस उदाहरण में, आपने:

• फ़ील्ड की सूची को सिर्फ़ Place.Field.ID और Place.Field.DISPLAY_NAME शामिल करने के लिए सेट करें. इसका मतलब है कि जवाब में मौजूद Place ऑब्जेक्ट में, मैच होने वाली हर जगह के बारे में बताने वाले सिर्फ़ दो फ़ील्ड होते हैं.

• खोज के बारे में बताने वाला SearchByTextRequest ऑब्जेक्ट बनाने के लिए, SearchByTextRequest.Builder का इस्तेमाल करें.

  • टेक्स्ट क्वेरी स्ट्रिंग को "Spicy Vegetarian Food" पर सेट करें.

  • नतीजों में दिखने वाली जगहों की संख्या को 10 पर सेट करें. डिफ़ॉल्ट और ज़्यादा से ज़्यादा संख्या 20 है.

  • खोज के दायरे को अक्षांश और देशांतर के निर्देशांक से तय किए गए आयताकार तक सीमित करें. इस इलाके से बाहर के मैच नहीं दिखाए जाते.

• कोई OnSuccessListener जोड़ें और SearchByTextResponse ऑब्जेक्ट से मिलती-जुलती जगहें पाएं.

टेक्स्ट से खोजने पर मिलने वाले जवाब

SearchByTextResponse क्लास, खोज अनुरोध के जवाब को दिखाती है. SearchByTextResponse ऑब्जेक्ट में ये शामिल होते हैं:

• Place ऑब्जेक्ट की सूची, जो मैच होने वाली सभी जगहों को दिखाती है. इसमें हर मैच होने वाली जगह के लिए एक Place ऑब्जेक्ट होता है.

• हर Place ऑब्जेक्ट में सिर्फ़ वे फ़ील्ड होते हैं जो अनुरोध में भेजी गई फ़ील्ड सूची में बताए गए हैं.

उदाहरण के लिए, अनुरोध में आपने फ़ील्ड की सूची को इस तरह से तय किया है:

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME);

इस फ़ील्ड की सूची का मतलब है कि जवाब में मौजूद हर Place ऑब्जेक्ट में, मैच होने वाली हर जगह का सिर्फ़ प्लेस आईडी और नाम शामिल होता है. इसके बाद, हर Place ऑब्जेक्ट में इन फ़ील्ड को ऐक्सेस करने के लिए, Place.getId() और Place.getName() तरीकों का इस्तेमाल किया जा सकता है.

Place ऑब्जेक्ट में डेटा ऐक्सेस करने के ज़्यादा उदाहरणों के लिए, जगह के ऑब्जेक्ट के डेटा फ़ील्ड ऐक्सेस करना लेख पढ़ें

ज़रूरी पैरामीटर

SearchByTextRequest के लिए ज़रूरी पैरामीटर ये हैं:

• फ़ील्ड की सूची

  बताएं कि आपको जगह के कौनसे डेटा फ़ील्ड दिखाने हैं. Place.Field वैल्यू की सूची पास करें. इससे, आपको वे डेटा फ़ील्ड मिलेंगे जिन्हें दिखाना है. रिस्पॉन्स में, रिटर्न किए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती.

  फ़ील्ड की सूचियां, डिज़ाइन के लिहाज़ से एक अच्छा तरीका है. इससे यह पक्का किया जा सकता है कि आपने अनावश्यक डेटा का अनुरोध न किया हो. इससे, डेटा प्रोसेस करने में लगने वाले समय और बिलिंग शुल्क से बचने में मदद मिलती है.

  इनमें से एक या उससे ज़्यादा फ़ील्ड डालें:

  • ये फ़ील्ड, टेक्स्ट सर्च (सिर्फ़ आईडी) SKU को ट्रिगर करते हैं:

    Place.Field.DISPLAY_NAME, Place.Field.ID, Place.Field.RESOURCE_NAME
    

  • ये फ़ील्ड, टेक्स्ट सर्च (बुनियादी) SKU को ट्रिगर करते हैं:

    Place.Field.ACCESSIBILITY_OPTIONS, Place.Field.ADDRESS_COMPONENTS, Place.Field.ADR_FORMAT_ADDRESS, Place.Field.BUSINESS_STATUS, Place.Field.FORMATTED_ADDRESS, Place.Field.GOOGLE_MAPS_URI, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_MASK_URL, Place.Field.LOCATION, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.PRIMARY_TYPE, Place.Field.PRIMARY_TYPE_DISPLAY_NAME, Place.Field.SHORT_FORMATTED_ADDRESS, Place.Field.SUB_DESTINATIONS, Place.Field.TYPES, Place.Field.UTC_OFFSET, Place.Field.VIEWPORT
    

  • ये फ़ील्ड, टेक्स्ट सर्च (बेहतर) SKU को ट्रिगर करते हैं:

    Place.Field.CURRENT_OPENING_HOURS, Place.Field.CURRENT_SECONDARY_OPENING_HOURS Place.Field.INTERNATIONAL_PHONE_NUMBER, Place.Field.NATIONAL_PHONE_NUMBER Place.Field.OPENING_HOURS, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.SECONDARY_OPENING_HOURS, Place.Field.USER_RATING_COUNT Place.Field.WEBSITE_URI
    

  • ये फ़ील्ड, टेक्स्ट सर्च (प्राथमिक) SKU को ट्रिगर करते हैं:

    Place.Field.ALLOWS_DOGS, Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.EDITORIAL_SUMMARY, Place.Field.EV_CHARGE_OPTIONS, Place.Field.FUEL_OPTIONS, Place.Field.GOOD_FOR_CHILDREN, Place.Field.GOOD_FOR_GROUPS, Place.Field.GOOD_FOR_WATCHING_SPORTS, Place.Field.LIVE_MUSIC, Place.Field.MENU_FOR_CHILDREN, Place.Field.OUTDOOR_SEATING, Place.Field.PARKING_OPTIONS, Place.Field.PAYMENT_OPTIONS, Place.Field.RESERVABLE, Place.Field.RESTROOM, Place.Field.REVIEWS, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_COCKTAILS, Place.Field.SERVES_COFFEE, Place.Field.SERVES_DESSERT, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE, Place.Field.TAKEOUT

  फ़ील्ड की सूची वाले पैरामीटर को सेट करने के लिए, SearchByTextRequest ऑब्जेक्ट बनाते समय setPlaceFields() तरीके को कॉल करें.

• टेक्स्ट क्वेरी

  वह टेक्स्ट स्ट्रिंग जिस पर खोज करनी है. उदाहरण के लिए: "रेस्टोरेंट", "123 मुख्य सड़क" या "सैन फ़्रांसिस्को में घूमने-फिरने की सबसे अच्छी जगह". एपीआई, इस स्ट्रिंग के आधार पर मैच होने वाले उम्मीदवारों की जानकारी दिखाता है. साथ ही, नतीजों को उनके काम के होने के हिसाब से क्रम में लगाता है.

  टेक्स्ट क्वेरी पैरामीटर सेट करने के लिए, SearchByTextRequest ऑब्जेक्ट बनाते समय setTextQuery() तरीके को कॉल करें.

ज़रूरी नहीं पैरामीटर

अपने अनुरोध के लिए वैकल्पिक पैरामीटर तय करने के लिए, SearchByTextRequest ऑब्जेक्ट का इस्तेमाल करें.

• शामिल किए गए टाइप

  नतीजों को उन जगहों तक सीमित करता है जो टेबल A में बताए गए टाइप से मेल खाती हैं. सिर्फ़ एक टाइप का इस्तेमाल किया जा सकता है. उदाहरण के लिए:

  • setIncludedType("bar")
  • setIncludedType("pharmacy")

  शामिल किए गए टाइप पैरामीटर को सेट करने के लिए, SearchByTextRequest ऑब्जेक्ट बनाते समय setIncludedType() तरीके को कॉल करें.

• जगह के हिसाब से बायस

  खोजने के लिए कोई इलाका तय करता है. यह जगह, खोज के नतीजों को बायस करती है. इसका मतलब है कि आपने जिस जगह की जानकारी दी है उसके आस-पास के नतीजे दिखाए जा सकते हैं. इनमें, उस जगह से बाहर के नतीजे भी शामिल हो सकते हैं.

  जगह की पाबंदी या जगह के हिसाब से रुझान, दोनों में से किसी एक के बारे में जानकारी दी जा सकती है. जगह की जानकारी से जुड़ी पाबंदी को उस इलाके के तौर पर समझें जहां नतीजे होने चाहिए. वहीं, जगह की जानकारी के आधार पर नतीजे दिखाने की सुविधा को उस इलाके के तौर पर समझें जहां नतीजे होने की संभावना है या जहां नतीजे मिल सकते हैं. ध्यान रखें कि जगह की जानकारी के आधार पर नतीजे दिखाने की सुविधा का इस्तेमाल करने पर भी, नतीजे तय किए गए इलाके से बाहर हो सकते हैं.

  क्षेत्र को आयताकार व्यूपोर्ट या सर्कल के तौर पर तय करें.

  • किसी वृत्त को उसके केंद्र बिंदु और त्रिज्या से तय किया जाता है. त्रिज्या को मीटर में दिखाया जाता है. त्रिज्या 0.0 और 50, 000.0 के बीच होनी चाहिए. उदाहरण के लिए:

    // Define latitude and longitude coordinates of the center of the search area.
    LatLng searchCenter = new LatLng(37.38816277477739, -122.08813770258874);
    
    // Use the builder to create a SearchByTextRequest object.
    // Set the radius of the search area to 500.0 meters.
    final SearchByTextRequest searchByTextRequest = SearchByTextRequest.builder("Spicy Vegetarian Food", placeFields)
      .setMaxResultCount(10)
      .setLocationBias(CircularBounds.newInstance(searchCenter, 500.0)).build();

  • रेक्टैंगल, अक्षांश-देशांतर व्यूपोर्ट होता है. इसे डायगनल के विपरीत दो कम और ज़्यादा पॉइंट के तौर पर दिखाया जाता है. सबसे कम वैल्यू, आयताकार पैनल के दक्षिण-पश्चिम कोने को दिखाती है. वहीं, सबसे ज़्यादा वैल्यू, आयताकार पैनल के उत्तर-पूर्व कोने को दिखाती है.

    व्यूपोर्ट को एक बंद क्षेत्र माना जाता है. इसका मतलब है कि इसमें उसकी सीमा भी शामिल होती है. अक्षांश की सीमाएं -90 से 90 डिग्री के बीच होनी चाहिए. साथ ही, देशांतर की सीमाएं -180 से 180 डिग्री के बीच होनी चाहिए:

    • अगर low = high है, तो व्यूपोर्ट में सिर्फ़ वह एक पॉइंट होता है.
    • अगर low.longitude > high.longitude है, तो ज्येष्ठ देशांतर की रेंज उलट जाती है (व्यूपोर्ट, ज्येष्ठ देशांतर की 180 डिग्री वाली रेखा को पार कर जाता है).
    • अगर low.longitude = -180 डिग्री और high.longitude = 180 डिग्री है, तो व्यूपोर्ट में सभी देशांतर शामिल होते हैं.
    • अगर low.longitude = 180 डिग्री और high.longitude = -180 डिग्री है, तो देशांतर की सीमा खाली होती है.
    • अगर low.latitude > high.latitude है, तो इसका मतलब है कि अक्षांश की रेंज खाली है.

    कम और ज़्यादा, दोनों वैल्यू डालना ज़रूरी है. साथ ही, दिखाया गया बॉक्स खाली नहीं होना चाहिए. खाली व्यूपोर्ट की वजह से गड़बड़ी होती है.

    उदाहरण के लिए, रेक्टैंगल व्यूपोर्ट के लिए, टेक्स्ट खोज के अनुरोध देखें.

    लोकेशन बायस पैरामीटर सेट करने के लिए, SearchByTextRequest ऑब्जेक्ट बनाते समय setLocationBias() तरीके को कॉल करें.

• जगह की जानकारी से जुड़ी पाबंदी

  खोजने के लिए कोई इलाका तय करता है. तय किए गए इलाके से बाहर के नतीजे नहीं दिखाए जाते. क्षेत्र को रेक्टैंगल व्‍यूपोर्ट के तौर पर तय करें. व्यूपोर्ट तय करने के बारे में जानकारी पाने के लिए, जगह के हिसाब से रुझान का ब्यौरा देखें.

  जगह की पाबंदी या जगह के हिसाब से रुझान, दोनों में से किसी एक के बारे में जानकारी दी जा सकती है. जगह की पाबंदी को उस इलाके के तौर पर देखें जहां के नतीजे दिखाने हैं. वहीं, जगह के हिसाब से नतीजों में पक्षपात को उस इलाके के तौर पर देखें जहां के नतीजे दिखाने हैं, लेकिन वे उस इलाके से बाहर के भी हो सकते हैं.

  जगह की पाबंदी वाला पैरामीटर सेट करने के लिए, SearchByTextRequest ऑब्जेक्ट बनाते समय setLocationRestriction() तरीके को कॉल करें.

• नतीजों की ज़्यादा से ज़्यादा संख्या

  जगह के ज़्यादा से ज़्यादा कितने नतीजे दिखाने हैं, यह तय करता है. यह वैल्यू, 1 से 20 (डिफ़ॉल्ट) के बीच होनी चाहिए.

  नतीजों की ज़्यादा से ज़्यादा संख्या का पैरामीटर सेट करने के लिए, SearchByTextRequest ऑब्जेक्ट बनाते समय setMaxResultCount() तरीका कॉल करें.

• कम से कम रेटिंग

  इससे नतीजों में सिर्फ़ वे ही जगहें दिखती हैं जिनकी औसत उपयोगकर्ता रेटिंग, इस सीमा से ज़्यादा या उसके बराबर हो. वैल्यू 0.0 और 5.0 के बीच होनी चाहिए. साथ ही, वैल्यू में 0.5 की बढ़ोतरी होनी चाहिए. उदाहरण के लिए: 0, 0.5, 1.0, ... , 5.0. वैल्यू को सबसे नज़दीकी 0.5 तक राउंड अप किया जाता है. उदाहरण के लिए, 0.6 की वैल्यू से, 1.0 से कम रेटिंग वाले सभी नतीजे हट जाते हैं.

  कम से कम रेटिंग पैरामीटर सेट करने के लिए, SearchByTextRequest ऑब्जेक्ट बनाते समय setMinRating() तरीके को कॉल करें.

• अभी खुला है

  अगर true है, तो क्वेरी भेजे जाने के समय, सिर्फ़ उन जगहों की जानकारी दिखाएं जो कारोबार के लिए खुली हैं. अगर false है, तो सभी कारोबारों की जानकारी दिखाएं. इससे कोई फ़र्क़ नहीं पड़ता कि वे खुले हैं या नहीं. इस पैरामीटर को false पर सेट करने पर, Google Places के डेटाबेस में ऐसी जगहों की जानकारी दिखती है जिनके खुले होने का समय नहीं बताया गया है.

  'अभी खोलें' पैरामीटर सेट करने के लिए, SearchByTextRequest ऑब्जेक्ट बनाते समय setOpenNow() तरीके को कॉल करें.

• कीमत के लेवल

  डिफ़ॉल्ट रूप से, नतीजों में ऐसी जगहें शामिल होती हैं जो सभी कीमत के लेवल पर सेवाएं देती हैं. नतीजों में सिर्फ़ उन जगहों को शामिल करने के लिए जिनकी कीमत एक तय सीमा के अंदर हो, उन जगहों की कीमत के लेवल के हिसाब से पूर्णांक की वैल्यू की सूची दी जा सकती है:

  • 1 - यहां कम कीमत पर सेवाएं मिलती हैं.
  • 2 - यहां मध्यम कीमत पर सेवाएं मिलती हैं.
  • 3 - जगह पर महंगी सेवाएं मिलती हैं.
  • 4 - जगह पर बहुत महंगी सेवाएं दी जाती हैं.

  कीमत के लेवल का पैरामीटर सेट करने के लिए, SearchByTextRequest ऑब्जेक्ट बनाते समय setPriceLevels() तरीके को कॉल करें.

• रैंक की प्राथमिकता

  इससे पता चलता है कि क्वेरी के टाइप के आधार पर, जवाब में नतीजों की रैंकिंग कैसे की जाती है:

  • "न्यूयॉर्क शहर के रेस्टोरेंट" जैसी कैटगरी वाली क्वेरी के लिए, SearchByTextRequest.RankPreference.RELEVANCE (खोज के हिसाब से नतीजों को रैंक करना) डिफ़ॉल्ट तौर पर लागू होता है. रैंकिंग की प्राथमिकता को SearchByTextRequest.RankPreference.RELEVANCE या SearchByTextRequest.RankPreference.DISTANCE (किसी जगह की दूरी के हिसाब से रैंकिंग) पर सेट किया जा सकता है.
  • हमारा सुझाव है कि "माउंटेन व्यू, सीए" जैसी किसी ऐसी क्वेरी के लिए, रैंक प्राथमिकता पैरामीटर को सेट न करें जिसे किसी कैटगरी में नहीं रखा गया है.

  रैंक प्राथमिकता पैरामीटर सेट करने के लिए, SearchByTextRequest ऑब्जेक्ट बनाते समय setRankPreference() तरीका कॉल करें.

• क्षेत्र कोड

  रिस्पॉन्स को फ़ॉर्मैट करने के लिए इस्तेमाल किया जाने वाला क्षेत्र कोड. इसे दो वर्णों वाले CLDR कोड की वैल्यू के तौर पर दिखाया जाता है. इस पैरामीटर का असर, खोज के नतीजों पर भी हो सकता है. कोई डिफ़ॉल्ट वैल्यू नहीं है.

  अगर जवाब में दिए गए पते के फ़ील्ड में देश का नाम, इलाके के कोड से मैच करता है, तो पते से देश का कोड हटा दिया जाता है.

  ज़्यादातर CLDR कोड, ISO 3166-1 कोड से मिलते-जुलते होते हैं. हालांकि, कुछ कोड अलग होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का सीसीटीएलडी "uk" (.co.uk) है, जबकि उसका आईएसओ 3166-1 कोड "gb" है. तकनीकी तौर पर, यह कोड "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉर्दन आयरलैंड" इकाई के लिए है. लागू कानून के आधार पर, इस पैरामीटर से नतीजों पर असर पड़ सकता है.

  क्षेत्र कोड पैरामीटर सेट करने के लिए, SearchByTextRequest ऑब्जेक्ट बनाते समय setRegionCode() तरीके को कॉल करें.

• सख्त टाइप फ़िल्टर

  इसका इस्तेमाल, शामिल करने के टाइप पैरामीटर के साथ किया जाता है. true पर सेट होने पर, सिर्फ़ वे जगहें दिखाई जाती हैं जो शामिल करने के टाइप में बताए गए टाइप से मेल खाती हैं. डिफ़ॉल्ट तौर पर, false का इस्तेमाल करने पर, जवाब में ऐसी जगहें शामिल हो सकती हैं जो बताए गए टाइप से मेल नहीं खाती हैं.

  स्ट्रिक्ट टाइप फ़िल्टरिंग पैरामीटर सेट करने के लिए, SearchByTextRequest ऑब्जेक्ट बनाते समय setStrictTypeFiltering() तरीके को कॉल करें.