जगह की जानकारी पर माइग्रेट करना (नया)

Places SDK for iOS, मौजूदा जगह की जानकारी के साथ काम करता है. अगर आपको iOS के लिए मौजूदा Places SDK टूल के बारे में पता है, तो जगह की जानकारी के नए वर्शन में ये बदलाव किए गए हैं:

  • कीमत तय करने के नए मॉडल का इस्तेमाल करता है. सभी एपीआई की कीमत की जानकारी के लिए, iOS के लिए Places SDK टूल की कीमत (नया) देखें.

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

  • अनुरोध करने के लिए, नए GMSPlacesClient fetchPlaceWithRequest: तरीके को कॉल करें.

  • अनुरोध में पास करें:

    • नई GMSFetchPlaceRequest क्लास का एक इंस्टेंस, जो अनुरोध के सभी पैरामीटर तय करता है. जैसे, प्लेस आईडी और सेशन टोकन.

    • रिस्पॉन्स मैनेज करने के लिए, GMSPlaceResultCallback टाइप का कॉलबैक.

  • रिस्पॉन्स में, जगह की जानकारी देने वाला GMSPlace इंस्टेंस होता है. GMSPlace इंस्टेंस की types प्रॉपर्टी की वैल्यू, अब टेबल A और टेबल B से तय की जाती हैं.

  • जवाब के GMSPlace इंस्टेंस में, GMSPlaceReview टाइप की नई reviews प्रॉपर्टी शामिल है. जब आपका ऐप्लिकेशन, GMSPlace इंस्टेंस से मिली जानकारी दिखाता है, जैसे कि फ़ोटो और समीक्षाएं, तो ऐप्लिकेशन को ज़रूरी एट्रिब्यूशन भी दिखाने होंगे.

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

  • रिस्पॉन्स GMSPlace इंस्टेंस में ये सदस्य फ़ंक्शन शामिल होते हैं:

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

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

    ये फ़ंक्शन सिर्फ़ तब उपलब्ध होते हैं, जब आपने iOS के लिए Places SDK टूल चालू किया हो. Places SDK for iOS (नया) को चालू करने पर, ये सुविधाएं उपलब्ध नहीं होतीं. ज़्यादा जानकारी के लिए, SDK टूल का वर्शन चुनना लेख पढ़ें.

अनुरोध का उदाहरण

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

Swift

// A hotel in Saigon with an attribution.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let fields = [GMSPlaceProperty.name, GMSPlaceProperty.website].map {$0.rawValue}

// Create the GMSFetchPlaceRequest instance.
let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: fields, sessionToken: nil)

client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: {
  (place: GMSPlace?, error: Error?) in
  guard let place, error == nil else { return }
  print("Place found: \(String(describing: place.name))")
})

Objective-C

// A hotel in Saigon with an attribution.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return.
NSArray<NSString *> *fields = @[GMSPlacePropertyName, GMSPlacePropertyWebsite];

// Create the GMSFetchPlaceRequest instance.
GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: fields sessionToken:nil];

[placesClient fetchPlaceWithRequest: fetchPlaceRequest callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) {
    if (error != nil) {
      NSLog(@"An error occurred %@", [error localizedDescription]);
      return;
    } else {
    NSLog(@"Place Found: %@", place.name);
    NSLog(@"The place URL: %@", place.website);
  }
}];