जगह की फ़ोटो

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा

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

1. [GMSPlacesClient fetchPlaceFromPlaceId] को कॉल करें और जगह का आईडी और कॉलबैक के साथ एक स्ट्रिंग पास करें. यह कॉलबैक को GMSPlacePhotoMetadataList ऑब्जेक्ट के साथ कॉल करेगा.
2. GMSPlacePhotoMetadataList ऑब्जेक्ट पर, results प्रॉपर्टी को ऐक्सेस करें और अरे से लोड करने के लिए फ़ोटो चुनें.
3. इस सूची से लोड करने के लिए, हर GMSPlacePhotoMetadata के लिए कॉल [GMSPlacesClient loadPlacePhoto:callback:] या [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]. ये कॉलबैक को इस्तेमाल करने लायक यूज़र इंटरफ़ेस (यूआई) के साथ कॉल करेंगे. फ़ोटो की चौड़ाई या ऊंचाई ज़्यादा से ज़्यादा 1600 पिक्सल हो सकती है.

ध्यान दें: किसी जगह की फ़ोटो दिखाते समय, एट्रिब्यूशन से जुड़े दिशा-निर्देशों का पालन करना न भूलें. ज़्यादा जानकारी के लिए एट्रिब्यूशन देखें.

नमूना कोड

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

Swift

// Specify the place data types to return (in this case, just photos).
let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.photos.rawValue))!

placesClient?.fetchPlace(fromPlaceID: "INSERT_PLACE_ID_HERE",
                         placeFields: fields,
                         sessionToken: nil, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    // Get the metadata for the first photo in the place photo metadata list.
    let photoMetadata: GMSPlacePhotoMetadata = place.photos![0]

    // Call loadPlacePhoto to display the bitmap and attribution.
    self.placesClient?.loadPlacePhoto(photoMetadata, callback: { (photo, error) -> Void in
      if let error = error {
        // TODO: Handle the error.
        print("Error loading photo metadata: \(error.localizedDescription)")
        return
      } else {
        // Display the first image and its attributions.
        self.imageView?.image = photo;
        self.lblText?.attributedText = photoMetadata.attributions;
      }
    })
  }
})

Objective-C

// Specify the place data types to return (in this case, just photos).
GMSPlaceField fields = (GMSPlaceFieldPhotos);

NSString *placeId = @"INSERT_PLACE_ID_HERE";

[_placesClient fetchPlaceFromPlaceID:placeId placeFields:fields sessionToken:nil callback:^(GMSPlace * _Nullable place, NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"An error occurred %@", [error localizedDescription]);
    return;
  }
  if (place != nil) {
    GMSPlacePhotoMetadata *photoMetadata = [place photos][0];
    [self->_placesClient loadPlacePhoto:photoMetadata callback:^(UIImage * _Nullable photo, NSError * _Nullable error) {
      if (error != nil) {
        NSLog(@"Error loading photo metadata: %@", [error localizedDescription]);
        return;
      } else {
        // Display the first image and its attributions.
        self->imageView.image = photo;
        self->lblText.attributedText = photoMetadata.attributions;
      }
    }];
  }
}];

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

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

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

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

एट्रिब्यूशन

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

इस्तेमाल करने की सीमा

किसी इमेज को वापस पाने में एक यूनिट की लागत आती है. फ़ोटो मेटाडेटा पाने के लिए इस्तेमाल करने की कोई सीमा नहीं है. इस्तेमाल और बिलिंग के बारे में ज़्यादा पढ़ें.