जगह की फ़ोटो (नई)

अपने ऐप्लिकेशन में जगहों की फ़ोटो दिखाने के लिए, Places SDK for iOS (नया) का इस्तेमाल करके फ़ोटो का अनुरोध किया जा सकता है. फ़ोटो की सेवा से मिलने वाली फ़ोटो, कई सोर्स से आती हैं. इनमें कारोबार के मालिकों और उपयोगकर्ताओं की ओर से सबमिट की गई फ़ोटो शामिल हैं.

फ़ोटो, बिटमैप इमेज होती हैं. इन्हें a UIImage ऑब्जेक्ट के तौर पर दिखाया जाता है. बिटमैप इमेज का साइज़ ज़्यादा से ज़्यादा 4800 x 4800 पिक्सल हो सकता है.

किसी इमेज का अनुरोध करना

किसी जगह के लिए, ज़्यादा से ज़्यादा 10 फ़ोटो का अनुरोध किया जा सकता है:

1. [GMSPlacesClient lookUpPhotosForPlaceID] को कॉल करें. इसमें जगह का आईडी और GMSPlacePhotoMetadataResultCallback कॉलबैक पास करें. इस अनुरोध से, GMSPlacePhotoMetadataResultCallback कॉलबैक को GMSPlacePhotoMetadataList ऑब्जेक्ट के साथ कॉल किया जाता है.

2. कॉलबैक में मौजूद GMSPlacePhotoMetadataList ऑब्जेक्ट से, results कलेक्शन की प्रॉपर्टी में फ़ोटो शामिल होती हैं. इसमें हर फ़ोटो को GMSPlacePhotoMetadata ऑब्जेक्ट के तौर पर दिखाया जाता है.

3. GMSPlacePhotoMetadata ऑब्जेक्ट का इस्तेमाल करके, GMSFetchPhotoRequest बनाएं. इसमें अनुरोध की गई इमेज का ज़्यादा से ज़्यादा साइज़ शामिल करें.

4. कलेक्शन में मौजूद हर GMSPlacePhotoMetadata ऑब्जेक्ट के लिए, [GMSPlacesClient fetchPhotoWithRequest:callback:] को कॉल करें. इसमें GMSFetchPhotoRequest ऑब्जेक्ट पास करें. इस तरीके से, GMSFetchPhotoResultCallback कॉलबैक को UIImage के तौर पर इस्तेमाल की जा सकने वाली बिटमैप इमेज के साथ कॉल किया जाता है.

किसी जगह के लिए फ़ोटो का अनुरोध करने का एक और तरीका है. इसके लिए, Place Details (नया) का अनुरोध करें. इसमें फ़ील्ड की सूची में GMSPlacePropertyPhotos शामिल करें. Place Details को कॉल करने का फ़ायदा यह है कि जवाब में मिलने वाले GMSPlace ऑब्जेक्ट में, फ़ोटो के साथ-साथ जगह के लिए ज़रूरी अन्य डेटा फ़ील्ड भी शामिल हो सकते हैं.

सैंपल कोड

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

// First fetch place details
// A hotel in Saigon with an attribution.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"
let fetchPlaceRequest = FetchPlaceRequest(
  placeID: placeID,
  placeProperties: [ . name, .website ]
)
var fetchedPlace: Place
switch await placesClient.fetchPlace(with: fetchPlaceRequest) {
case .success(let place):
  fetchedPlace = place
case .failure(let placesError):
  // Handle error
}

// Use the place details to fetch a photo's image.
guard let photo = fetchedPlace.photos?.first else {
  // Handle place without photos.
}
let fetchPhotoRequest =
  FetchPhotoRequest(photo: photo, maxSize: CGSizeMake(4800, 4800))
switch await placesClient.fetchPhoto(with: fetchPhotoRequest) {
case .success(let uiImage):
  // Handle image.
case .failure(let placesError):
  // Handle error
}

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

// Request list of photos for a place
placesClient.lookUpPhotos(forPlaceID: placeID) { (photos, error) in

  guard let photoMetadata: GMSPlacePhotoMetadata = photos?.results[0] else {
    return }

  // Request individual photos in the response list
  let fetchPhotoRequest = GMSFetchPhotoRequest(photoMetadata: photoMetadata, maxSize: CGSizeMake(4800, 4800))
  self.client.fetchPhoto(with: fetchPhotoRequest, callback: {
    (photoImage: UIImage?, error: Error?) in
      guard let photoImage, error == nil else {
        print("Handle photo error: ")
        return }
      print("Display photo Image: ")
    }
  )
}

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

[placesClient lookUpPhotosForPlaceID:placeID callback: ^(GMSPlacePhotoMetadataList *list, NSError *error) {
  GMSPlacePhotoMetadata *photoMetadata = [list results][0];

  // Request individual photos in the response list
  GMSFetchPhotoRequest *fetchPhotoRequest = [[GMSFetchPhotoRequest alloc] initWithPhotoMetadata:photoMetadata maxSize:CGSizeMake(4800, 4800)];
  [placesClient fetchPhotoWithRequest:fetchPhotoRequest callback: ^(UIImage *_Nullable photoImage, NSError *_Nullable error) {
    if (error == nil) {
      // Display photo
    }
  }];
}];

कैश मेमोरी में सेव करना

[GMSPlacesClient loadPlacePhoto:callback:] या [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:] का इस्तेमाल करके लोड की गई फ़ोटो, डिस्क और इन-मेमोरी, दोनों में कैश की जाती हैं. ऐसा, शेयर किए गए NSURLCache में Foundation URL loading system की मदद से किया जाता है.

कैश करने के तरीके को कॉन्फ़िगर करने के लिए, अपने ऐप्लिकेशन के डेलिगेट के application:didFinishLaunchingWithOptions: तरीके में [NSURLCache setSharedURLCache:] का इस्तेमाल करके, शेयर किए गए यूआरएल कैश को बदला जा सकता है.

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

एट्रिब्यूशन

ज़्यादातर मामलों में, जगह की फ़ोटो को एट्रिब्यूशन के बिना इस्तेमाल किया जा सकता है. हालांकि, कुछ मामलों में इमेज में ज़रूरी एट्रिब्यूशन शामिल होता है. हालांकि, अगर जवाब में मिले GMSPlacePhotoMetadata इंस्टेंस में कोई attributions या authorAttribution, शामिल है, तो आपको अपने ऐप्लिकेशन में इन एट्रिब्यूशन को शामिल करना होगा. ऐसा तब करना होगा, जब आपके ऐप्लिकेशन में इमेज दिखाई जाती है. एट्रिब्यूशन के बारे में जानकारी देने वाला दस्तावेज़ देखें.