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

Places API (लेगसी) जगह के बारे में ज़्यादा जानकारी (लेगसी) के साथ काम करता है. अगर आपको Places API (लेगसी) के बारे में जानकारी है, तो जगह की जानकारी (नया) में ये बदलाव किए गए हैं:

  • कीमत तय करने के नए मॉडल का इस्तेमाल करता है. सभी एपीआई की कीमत की जानकारी के लिए, इस्तेमाल और बिलिंग देखें.

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

  • अनुरोध करने के लिए, new GMSPlacesClient fetchPlaceWithRequest: तरीके का इस्तेमाल करें.

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

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

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

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

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

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

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

    • isOpen यह फ़ंक्शन, यह पता लगाता है कि दी गई जगह, दिए गए समय पर खुली है या नहीं.

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

    ये फ़ंक्शन सिर्फ़ तब उपलब्ध होते हैं, जब आपने Places SDK for iOS चालू किया हो. iOS के लिए Places 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);
  }
}];