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

टेक्स्ट खोज की मदद से, जगहों के किसी सेट के बारे में जानकारी दिखती है जो कि. उदाहरण के लिए, "दिल्ली में पिज़्ज़ा", "आस-पास के जूते की दुकान ओटावा" या "123 Main Street". सेवा, जगहों की सूची के साथ जवाब देती है का मिलान होता है.

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

टेक्स्ट से खोज के हिसाब से जगहों की सूची पाएं

GMSPlacesClient searchByTextWithRequest: पर कॉल करके टेक्स्ट खोज का अनुरोध करें. पास GMSPlaceSearchByTextRequest ऑब्जेक्ट है, जो अनुरोध पैरामीटर और कॉलबैक मेथड को तय करता है. GMSPlaceSearchByTextResultCallback, का इस्तेमाल करें.

GMSPlaceSearchByTextRequest ऑब्जेक्ट ज़रूरी है और ज़रूरी नहीं पैरामीटर . ज़रूरी पैरामीटर में ये शामिल हैं:

• GMSPlace ऑब्जेक्ट में दिखाए जाने वाले फ़ील्ड की सूची भी जिसे फ़ील्ड मास्क कहा जाता है, जैसा कि GMSPlaceProperty. अगर आप फ़ील्ड सूची में कम से कम एक फ़ील्ड को शामिल नहीं करते हैं या अगर आप फ़ील्ड को छोड़ देते हैं फ़ील्ड सूची का इस्तेमाल करने देता है, तो कॉल एक गड़बड़ी दिखाता है.
• टेक्स्ट क्वेरी.

टेक्स्ट खोजने के अनुरोध के इस उदाहरण में बताया गया है कि रिस्पॉन्स GMSPlace ऑब्जेक्ट खोज में हर GMSPlace ऑब्जेक्ट के लिए, जगह का नाम और जगह का आईडी शामिल हो नतीजे. यह रिस्पॉन्स को सिर्फ़ टाइप की जगहें दिखाने के लिए भी फ़िल्टर करता है "रेस्टोरेंट".

// Create the GMSPlaceSearchByTextRequest object.
let myProperties = [GMSPlaceProperty.name, GMSPlaceProperty.placeID].map {$0.rawValue}
let request = GMSPlaceSearchByTextRequest(textQuery:"pizza in New York", placeProperties:myProperties)
request.isOpenNow = true
request.includedType = "restaurant"
request.maxResultCount = 5
request.minRating = 3.5
request.rankPreference = .distance
request.isStrictTypeFiltering = true
request.locationBias =  GMSPlaceCircularLocationOption(CLLocationCoordinate2DMake(40.7, -74.0), 200.0)

// Array to hold the places in the response
var placeResults: [GMSPlace] = []

let callback: GMSPlaceSearchByTextResultCallback = { [weak self] results, error in
  guard let self, error == nil else {
    if let error {
      print(error.localizedDescription)
    }
    return
  }
  guard let results = results as? [GMSPlace] else {
    return
  }
  placeResults = results
}

GMSPlacesClient.shared().searchByText(with: request, callback: callback)

// Create the GMSPlaceSearchByTextRequest object.
GMSPlaceSearchByTextRequest *request =
    [[GMSPlaceSearchByTextRequest alloc] initWithTextQuery:@"pizza in New York" placeProperties:@[GMSPlacePropertyName, GMSPlacePropertyPlaceID]];
request.isOpenNow = YES;
request.includedType = @"restaurant";
request.maxResultCount = 5;
request.minRating = 3.5;
request.rankPreference = GMSPlaceSearchByTextRankPreferenceDistance;
request.isStrictTypeFiltering = YES;
request.priceLevels = @[ @(kGMSPlacesPriceLevelFree), @(kGMSPlacesPriceLevelCheap) ];
request.locationBias = GMSPlaceCircularLocationOption(CLLocationCoordinate2DMake(40.7, -74.0), 200.0);

// Array to hold the places in the response
_placeResults = [NSArray array];

// Create the GMSPlaceSearchByTextRequest object.
[_placesClient searchByTextWithRequest:request
    callback:^(NSArray<GMSPlace *> *_Nullable placeResults, NSError * _Nullable error) {
      if (error != nil) {
        NSLog(@"An error occurred %@", [error localizedDescription]);
        return;
      } else {
        if (placeResults.count > 0) {
          // Get list of places.
          _placeResults = placeResults;
      }
    }
  }
];

let restriction = RectangularLocationRestriction(
      northEast: CLLocationCoordinate2D(latitude: 20, longitude: 30),
      southWest: CLLocationCoordinate2D(latitude: 40, longitude: 50)
)
let searchByTextRequest = SearchByTextRequest(
        textQuery: "pizza in New York",
        placeProperties: [ .name, .placeID ],
        locationRestriction: restriction,
        includedType: .restaurant,
        maxResultCount: 5,
        minRating: 3.5,
        priceLevels: [ .moderate, .inexpensive ],
        isStrictTypeFiltering: true
)
switch await placesClient.searchByText(with: searchByTextRequest) {
case .success(let places):
  // Handle places
case .failure(let placesError):
  // Handle error
}

टेक्स्ट से जुड़े खोज के जवाब

Text Search API, इसका रूप GMSPlace ऑब्जेक्ट हैं, जिनमें मेल खाने वाली हर जगह की एक GMSPlace ऑब्जेक्ट है.

डेटा फ़ील्ड के साथ, इसमें GMSPlace ऑब्जेक्ट रिस्पॉन्स में ये मेंबर फ़ंक्शन शामिल होते हैं:

• isOpen यह हिसाब लगाता है कि कोई जगह दिए गए समय पर खुली है या नहीं.
• isOpenAtDate यह कैलकुलेट करता है कि दी गई तारीख पर कोई जगह खुली है या नहीं.

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

ज़रूरी जानकारी देने के लिए, GMSPlaceSearchByTextRequest ऑब्जेक्ट का इस्तेमाल करें पैरामीटर का इस्तेमाल करें.

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

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

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

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

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

    GMSPlacePropertyPlaceID, GMSPlacePropertyName

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

    GMSPlacePropertyAddressComponents, GMSPlacePropertyBusinessStatus, GMSPlacePropertyFormattedAddress, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyCoordinate, GMSPlacePropertyPhotos, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyViewport, GMSPlacePropertyWheelchairAccessibleEntrance

  • ये फ़ील्ड Text Search (ऐडवांस) SKU को ट्रिगर करते हैं:

    GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours, GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel, GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

  • ये फ़ील्ड Text Search (पसंदीदा) SKU को ट्रिगर करते हैं:

    GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

• textQuery

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

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

विकल्प के बारे में बताने के लिए, GMSPlaceSearchByTextRequest ऑब्जेक्ट का इस्तेमाल करें पैरामीटर का इस्तेमाल करें.

• includedType

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

  • request.includedType = "bar"
  • request.includedType = "pharmacy"

• isOpenNow

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

• isStrictTypeFiltering

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

• locationBias

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

  आपके पास locationRestriction या locationBias बताने का विकल्प है, लेकिन दोनों नहीं. locationRestriction के बारे में सोचें कि वह क्षेत्र जिसमें परिणाम होने चाहिए और locationBias इस रूप में वह क्षेत्र तय करते हुए जिसमें नतीजे इसके पास होने चाहिए, लेकिन उसके बाहर भी हो सकते हैं क्षेत्र.

  इलाके की जानकारी एक आयताकार व्यूपोर्ट या सर्कल के तौर पर दें.

  • सर्कल को सेंटर पॉइंट और मीटर में रेडियस से तय किया जाता है. दायरा यह 0.0 और 50000.0 के बीच होना चाहिए. डिफ़ॉल्ट दायरा 0.0 है. उदाहरण के लिए:

    request.locationBias =  GMSPlaceCircularLocationOption(CLLocationCoordinate2DMake(40.7, -74.0), 200.0)
    

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

    व्यूपोर्ट को बंद क्षेत्र है, जिसका मतलब है इसकी सीमा शामिल है. अक्षांश की सीमाएं यह -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, अक्षांश रेंज खाली है.

• locationRestriction

  यह बताता है कि किसी इलाके को किस इलाके में खोजा जाना है. चुने गए इलाके से बाहर के नतीजे नहीं दिखाए जा सकते वापस किया गया. इलाके की जानकारी एक आयताकार व्यूपोर्ट के तौर पर दें. ब्यौरा देखें locationBias में से देखें.

  आपके पास locationRestriction या locationBias बताने का विकल्प है, लेकिन दोनों नहीं. locationRestriction के बारे में सोचें कि वह क्षेत्र जिसमें परिणाम होने चाहिए और locationBias इस रूप में वह क्षेत्र तय करते हुए जिसमें नतीजे इसके पास होने चाहिए, लेकिन उसके बाहर भी हो सकते हैं क्षेत्र.

• maxResultCount

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

• minRating

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

• priceLevels

  खोज को उन जगहों तक सीमित करें जिन्हें कीमत के किसी खास लेवल पर मार्क किया गया है. डिफ़ॉल्ट रूप से, कीमत के सभी लेवल को चुना जाता है.

  से तय किए गए एक या ज़्यादा मानों की श्रेणी तय करें PriceLevel.

  उदाहरण के लिए:

  request.priceLevels = [GMSPlacesPriceLevel.moderate.rawValue, GMSPlacesPriceLevel.cheap.rawValue]

• rankPreference

  यह बताता है कि रिस्पॉन्स में नतीजों को किस तरह के क्वेरी:

  • कैटगरी से जुड़ी क्वेरी के लिए, जैसे कि "रेस्टोरेंट इन न्यू यॉर्क सिटी" के लिए, .relevance (खोज प्रासंगिकता के आधार पर रैंक नतीजे) डिफ़ॉल्ट है. rankPreference को .relevance पर सेट किया जा सकता है या .distance (दूरी के हिसाब से नतीजों को रैंक करें).
  • हमारा सुझाव है कि आप "माउंटेन व्यू, सीए" जैसी कैटगरी से जुड़ी अन्य क्वेरी के लिए जवाब दें सेट न करें, rankPreference को सेट न करें.

• regionCode

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

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

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

अपने ऐप्लिकेशन में एट्रिब्यूशन दिखाएं

जब आपका ऐप्लिकेशन इनसे मिली जानकारी को दिखाता है GMSPlacesClient जैसे कि फ़ोटो और समीक्षाएं, ऐप्लिकेशन को ज़रूरी एट्रिब्यूशन भी दिखाने चाहिए.

उदाहरण के लिए, GMSPlacesClient ऑब्जेक्ट की reviews प्रॉपर्टी में ज़्यादा से ज़्यादा पाँच डेटा का अरे होता है GMSPlaceReview ऑब्जेक्ट हैं. हर GMSPlaceReview ऑब्जेक्ट में एट्रिब्यूशन और लेखक के एट्रिब्यूशन शामिल हो सकते हैं. अगर आपके ऐप्लिकेशन में समीक्षा दिखाई जाती है, तो आपको कोई एट्रिब्यूशन या लेखक भी दिखाना होगा एट्रिब्यूशन.

ज़्यादा जानकारी के लिए, यहां दिया गया दस्तावेज़ देखें एट्रिब्यूशन.