Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

iOS के लिए Places Swift SDK पर माइग्रेट करना

Places SDK for iOS से Places Swift SDK for iOS पर माइग्रेट करना आसान है. इसे धीरे-धीरे किया जा सकता है. Places Swift SDK for iOS में मौजूद स्ट्रक्चर, Objective-C पर आधारित अपने काउंटरपार्ट के साथ काम नहीं करते. इसलिए, हमारा सुझाव है कि GMSPlacesClient में एपीआई के इस्तेमाल के आधार पर, फ़ंक्शनैलिटी के अलग-अलग हिस्सों को माइग्रेट करें.

अपने प्रोजेक्ट में Places Swift SDK for iOS जोड़ना

Places Swift SDK for iOS का इस्तेमाल करने के लिए, यह ज़रूरी है कि आपने ये काम किए हों:

Places API (नया) चालू किया हो.
Places Swift SDK को अपनी डिपेंडेंसी में जोड़ा हो. GooglePlaces, GooglePlacesSwift या दोनों को इंस्टॉल किया जा सकता है.

ध्यान दें: Google Places Swift को ऐक्सेस करने के लिए, GitHub का यूआरएल बदल गया है. अगर GooglePlacesSwift के किसी ऐसे वर्शन को अपडेट किया जा रहा है जिसे पुराने यूआरएल, https://github.com/googlemaps/ios-places-swift-sdk से ऐक्सेस किया गया था, तो उसे Xcode के पैकेज डिपेंडेंसी सेक्शन से हटाएं.
PlacesClient की मदद से, Places क्लाइंट को शुरू किया हो.

माइग्रेशन का चरण-दर-चरण उदाहरण

उदाहरण के लिए, मान लें कि Places SDK for iOS का इस्तेमाल करने वाले किसी ऐप्लिकेशन को टेक्स्ट इनपुट के आधार पर, अपने-आप पूरे होने वाले सुझाव मिलते हैं. इसके बाद, पहले प्लेस के सुझाव की जानकारी फ़ेच की जाती है. Places SDK for iOS का इस्तेमाल करने पर, मौजूदा कोड कुछ इस तरह का दिख सकता है:

// Initialize Places Client.
GMSPlacesClient.provideAPIKey(apiKey)
let client = GMSPlacesClient.shared()

// Fetch Autocomplete Request.
let center = CLLocation(latitude: 37.3913916, longitude: -122.0879074)
let northEast = CLLocationCoordinate2DMake(37.388162, -122.088137)
let southWest = CLLocationCoordinate2DMake(37.395804, -122.077023)

let filter = GMSAutocompleteFilter()
filter.types = [kGMSPlaceTypeRestaurant]
filter.origin = center
filter.locationBias = GMSPlaceRectangularLocationOption(northEast, southWest)

let request = GMSAutocompleteRequest(query: "Sicilian piz")
request.filter = filter

client.fetchAutocompleteSuggestions(from: request) { (results, error) in
  guard let results, error == nil else {
    print("Autocomplete error: \(String(describing: error))")
    return
  }

  // Fetch Place Request.
  guard let placeID = results.first?.placeSuggestion?.placeID else { return }
  let myProperties = [GMSPlaceProperty.name, GMSPlaceProperty.website].map {$0.rawValue}

  let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties, sessionToken: nil)

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

Places क्लाइंट के इनिशियलाइज़र को अपडेट करना

कोड को बेहतर बनाने और नए SDK की सुविधाओं का फ़ायदा पाने के लिए, आपको GMSPlacesClient को PlacesClient से बदलना होगा. इसके अलावा, नए तरीके में पैरामीटर के नाम बदल दिए गए हैं. इसलिए, आपको with के बजाय, पैरामीटर को from पर अपडेट करना होगा. आखिर में, the Places Swift SDK, अपग्रेड किए गए AutocompleteRequest का इस्तेमाल करता है.

अपडेट किया गया कोड

// Initialize Places Swift Client.
let _ = PlacesClient.provideAPIKey(apiKey)
let placesSwiftClient = PlacesClient.shared

ओरिजनल कोड

// Initialize Places Client.
GMSPlacesClient.provideAPIKey(apiKey)
let client = GMSPlacesClient.shared()

अपने-आप पूरे होने वाले अनुरोध को अपडेट करना

अपने-आप पूरे होने वाले अनुरोध के फ़्लो को अपडेट करके शुरुआत की जा सकती है. पुराने कोड में, अपने-आप पूरे होने वाले सुझावों का अनुरोध करने के लिए कॉलबैक का इस्तेमाल किया जाता है. वहीं, नए कोड में switch/await पैटर्न का इस्तेमाल किया जाता है. कॉलबैक की वजह से, कोड स्ट्रक्चर और गड़बड़ी को ठीक करने की प्रोसेस जटिल हो सकती है. Places Swift SDK के नए वर्शन में, एक साथ कई कार्रवाइयां करने की सुविधा है. इससे, एसिंक्रोनस कार्रवाइयों को आसान बनाया जा सकता है.

// Initialize Places Swift Client.
let _ = PlacesClient.provideAPIKey(apiKey)
let placesSwiftClient = PlacesClient.shared

// Fetch Autocomplete Request.
let center = CLLocation(latitude: 37.3913916, longitude: -122.0879074)
let northEast = CLLocationCoordinate2DMake(37.388162, -122.088137)
let southWest = CLLocationCoordinate2DMake(37.395804, -122.077023)

let bias = RectangularCoordinateRegion(northEast: northEast, southWest: southWest)
let filter = AutocompleteFilter(types: [ .restaurant ], origin: center, coordinateRegionBias: bias)

let autocompleteRequest = AutocompleteRequest(query: "Sicilian piz", filter: filter)
let placeID: String
switch await placesSwiftClient.fetchAutocompleteSuggestions(with: autocompleteRequest) {
case .success(let results):
  switch results.first {
  case .place(let placeSuggestion):
    placeID = placeSuggestion.placeID
  case .none:
    fallthrough
  @unknown default:
    return
  }
case .failure(let placesError):
  print("Autocomplete error: \(placesError)")
  return
}

// Initialize Places Client.
GMSPlacesClient.provideAPIKey(apiKey)
let placesClient = GMSPlacesClient.shared()

// Fetch Place Request.
let myProperties = [GMSPlaceProperty.name, GMSPlaceProperty.website].map {$0.rawValue}

let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties, sessionToken: nil)

placesClient.fetchPlace(with: fetchPlaceRequest) { (place: GMSPlace?, error: Error?) in
  guard let place, error == nil else { return }
  print("Place found: \(String(describing: place.name)); \(String(describing: place.website))")
}

बहिष्कृत किए गए क्लास, तरीके, और टाइपडेफ़ को बदलना

Places SDK for iOS में मौजूद ये क्लास, तरीके, और टाइपडेफ़, वर्शन 11.0 और इसके बाद के वर्शन में उपलब्ध नहीं हैं.

इस टेबल में, बहिष्कृत किए गए तरीकों और उनके रीप्लेसमेंट दिखाए गए हैं:

बहिष्कृत	रीप्लेसमेंट
`currentPlaceWithCallback` या `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields`	`searchNearbyWithRequest`
`lookUpPlaceID` या `fetchPlaceFromPlaceID`	`fetchPlaceWithRequest`
`lookUpPhotosForPlaceID` या `loadPlacePhoto`	`fetchPhotoWithRequest`
`GMSAutocompletePrediction`	`AutocompleteSuggestion`
`findAutocompletePredictionsFromQuery` या `GMSAutocompleteFetcher`	`fetchAutocompleteSuggestionsFromRequest`
`isOpenWithPlaceID` या `isOpenWithPlace`	`isOpenWithRequest`
`GMSAutocompleteResultsViewController`, `GMSAutocompleteTableDataSource` या `GMSAutocompleteViewController`	`placeAutocomplete`

तरीके और क्लास के नाम अपडेट करना

आखिर में, fetchPlace कोड को रीफ़ैक्टर करके और GMSPlacesClient के इनिशियलाइज़ेशन और GMSPlaceProperty के एलान, दोनों को हटाकर माइग्रेशन की प्रोसेस पूरी करें. Places Swift SDK में, "GMS" प्रीफ़िक्स को हटाने के लिए, तरीके और क्लास के नाम अपडेट किए गए हैं.इसलिए, इन्हें भी अपडेट करना होगा. जैसे, GMSFetchPlaceRequest बदलकर FetchPlaceRequest हो जाता है.

टाइप-हैंडलिंग

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

एक साथ कई कार्रवाइयां करना

इसके अलावा, नए तरीके में एक साथ कई कार्रवाइयां करने की सुविधा है. इससे, placesClient.fetchPlace में कॉलबैक को placesSwiftClient.fetchPlace में switch/await पैटर्न से बदला जा सकता है.

// Initialize Places Swift Client.
let _ = PlacesClient.provideAPIKey(apiKey)
let placesSwiftClient = PlacesClient.shared

// Fetch Autocomplete Request.
let center = CLLocation(latitude: 37.3913916, longitude: -122.0879074)
let northEast = CLLocationCoordinate2DMake(37.388162, -122.088137)
let southWest = CLLocationCoordinate2DMake(37.395804, -122.077023)

let bias = RectangularCoordinateRegion(northEast: northEast, southWest: southWest)
let filter = AutocompleteFilter(types: [ .restaurant ], origin: center, coordinateRegionBias: bias)

let autocompleteRequest = AutocompleteRequest(query: "Sicilian piz", filter: filter)
let placeID: String
switch await placesSwiftClient.fetchAutocompleteSuggestions(with: autocompleteRequest) {
case .success(let results):
  switch results.first {
  case .place(let placeSuggestion):
    placeID = placeSuggestion.placeID
  case .none:
    fallthrough
  @unknown default:
    return
  }
case .failure(let placesError):
  print("Autocomplete error: \(placesError)")
  return
}

// Fetch Place Request.
let fetchPlaceRequest = FetchPlaceRequest(placeID: placeID, placeProperties: [.displayName, .websiteURL])
switch await placesSwiftClient.fetchPlace(with: fetchPlaceRequest) {
case .success(let place):
  print("Place found: \(place.displayName): \(String(describing: place.description))")

case .failure(let placesError):
  print("Place not found: \(placeID); \(placesError)")
}

अप-टू-डेट रहें

नई सुविधाओं और बदलावों के बारे में जानने के लिए, Places Swift SDK for iOS के रिलीज़ नोट वाला पेज देखें.