टेक्स्ट से खोजें (नई सुविधा)

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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

टेक्स्ट से खोजें (नया वर्शन) सुविधा, किसी स्ट्रिंग के आधार पर जगहों के सेट के बारे में जानकारी दिखाती है. उदाहरण के लिए, "दिल्ली में पिज़्ज़ा" या "जयपुर के आस-पास जूतों की दुकानें" या "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.Builder का इस्तेमाल करके, SearchByTextRequest ऑब्जेक्ट बनाएं. इससे खोज को तय किया जाता है.

    • टेक्स्ट क्वेरी स्ट्रिंग को "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 ऑब्जेक्ट में डेटा ऐक्सेस करने के ज़्यादा उदाहरणों के लिए, जगह की जानकारी वाले ऑब्जेक्ट के डेटा फ़ील्ड ऐक्सेस करना लेख पढ़ें

पेज पर नंबर डालना

टेक्स्ट से खोजें की SearchByTextResponse क्लास, getPagination() तरीके से टेक्स्ट से खोज के नतीजे के पेज नंबर डालने की सुविधा देती है. यह तरीका, पेज नंबर डालने वाला ऑब्जेक्ट दिखाता है.

Pagination ऑब्जेक्ट के hasNextPage() तरीके का इस्तेमाल करके, यह पता लगाएं कि नतीजों के और पेज उपलब्ध हैं या नहीं. यह तरीका, बूलियन वैल्यू (सही या गलत) दिखाता है.

जब hasNextPage(), true दिखाता है, तब नतीजों का अगला पेज पाने के लिए, fetchNextPage() तरीके को कॉल करें.

यहां दिए गए उदाहरण में, अगला पेज उपलब्ध है या नहीं, यह देखने और फिर पेज को लोड करने का तरीका बताया गया है.

Kotlin

val searchByTextRequest =
      searchByTextRequest("restaurants", Arrays.asList(Place.Field.NAME)) {
        maxResultCount = 10
      }

// using pagination object (Preferred)
placesClient.searchByText(searchByTextRequest)   
    .addOnSuccessListener {response: SearchByTextResponse ->
        val places = response.places

        val pagination = response.pagination

        if (pagination.hasNextPage()) {
            pagination.setPageSize(20)
            pagination.fetchNextPage()
                    .addOnSuccessListener { nextPageResponse ->
                          val nextPagePlaces = nextPageResponse.getPlaces()
                    }
                    .addOnFailureListener {// Handle error with given status code}
        }
}
.addOnFailureListener {
// TODO: Handle error with given status code.
exception -> {
          exception.printStackTrace();
        }
}

Java

SearchByTextRequest searchByTextRequest =
  SearchByTextRequest.builder("restaurants", Arrays.asList(Place.Field.NAME)).setMaxResultCount(10).build();

// using pagination object (Preferred)
placesClient.searchByText(searchByTextRequest)
  .addOnSuccessListener((response) -> {
    List<Place> places = response.getPlaces();
    Log.i(TAG, "Places result: " + places);

    Pagination pagination =
      response.getPagination();

    if (pagination.hasNextPage()) {
      pagination.setPageSize(20); // change the page size from 10 to 20
      pagination.fetchNextPage()
    	  .addOnSuccessListener((nextPageResponse) -> {
            List<Place> nextPagePlaces = nextPageResponse.getPlaces();
            Log.i(TAG, "Next page places result: " + nextPagePlaces);
        });
    }
  })
  .addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
    	// Handle error with given status code
    }
  });

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

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

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

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

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

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

    • इन फ़ील्ड की वजह से, टेक्स्ट से खोजें एसेंशियल आईडी ओनली एसकेयू ट्रिगर होता है:

      Place.Field.DISPLAY_NAME*
          * Place.Field.NAME के बजाय इसका इस्तेमाल करें (वर्शन 4.0 में अब काम नहीं करता).
      Place.Field.ID
      Place.Field.RESOURCE_NAME*
          * इसमें जगह के संसाधन का नाम इस फ़ॉर्मैट में होता है: places/PLACE_ID.
           जगह के नाम को टेक्स्ट के तौर पर ऐक्सेस करने के लिए, DISPLAY_NAME का इस्तेमाल करें.

      फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.

    • इन फ़ील्ड की वजह से, टेक्स्ट से खोजें प्रो एसकेयू ट्रिगर होता है:

      Place.Field.ACCESSIBILITY_OPTIONS*
          Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
      Place.Field.ADDRESS_COMPONENTS
      Place.Field.ADR_FORMAT_ADDRESS
      Place.Field.BUSINESS_STATUS
      Place.Field.FORMATTED_ADDRESS*
          Place.Field.ADDRESS (अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
      Place.Field.GOOGLE_MAPS_URI
      Place.Field.ICON_BACKGROUND_COLOR
      Place.Field.ICON_MASK_URL *
          Place.Field.ICON_URL (अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
      Place.Field.LOCATION*
          Place.Field.LAT_LNG (अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
      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

      फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.

    • इन फ़ील्ड की वजह से, टेक्स्ट सर्च एंटरप्राइज़ एसकेयू ट्रिगर होता है:

      Place.Field.CURRENT_OPENING_HOURS
      Place.Field.CURRENT_SECONDARY_OPENING_HOURS
      Place.Field.INTERNATIONAL_PHONE_NUMBER*
          * Place.Field.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.USER_RATINGS_TOTAL के बजाय इसका इस्तेमाल करें, क्योंकि अब का इस्तेमाल नहीं किया जा सकता.
      Place.Field.WEBSITE_URI

      फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.

    • इन फ़ील्ड की वजह से, टेक्स्ट से खोजें Enterprise Plus एसकेयू ट्रिगर होता है:

      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 ऑब्जेक्ट का इस्तेमाल करें.

  • शामिल किए जाने वाले टाइप

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

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

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

  • जगह के हिसाब से पक्षपात

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

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

    इलाके को रेक्टैंगल व्यूपोर्ट या सर्कल के तौर पर तय करें.

    • सर्कल को सेंटर पॉइंट और मीटर में रेडियस से तय किया जाता है. रेडियस, 0.0 से 50000.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 कोड से मिलते-जुलते होते हैं. हालांकि, कुछ कोड अलग भी हो सकते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका आईएसओ 3166-1 कोड "gb" है. तकनीकी तौर पर, यह कोड "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉर्दर्न आयरलैंड" के लिए है. लागू कानून के आधार पर, पैरामीटर से नतीजों पर असर पड़ सकता है.

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

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

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

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