Place Photos (লিগ্যাসি)

আপনার অ্যাপ্লিকেশনে দেখানোর জন্য Places SDK for iOS (Legacy) ব্যবহার করে জায়গার ফটো দেখানোর অনুরোধ করতে পারেন। ফটো পরিষেবা থেকে পাওয়া ফটো বিভিন্ন সোর্স থেকে আসে, এর মধ্যে ব্যবসার মালিক ও ব্যবহারকারীর কন্ট্রিবিউট করা ফটো অন্তর্ভুক্ত। কোনও জায়গার ফটো ফিরিয়ে আনতে, আপনাকে নিম্নলিখিত ধাপগুলি অনুসরণ করতে হবে:

1. [GMSPlacesClient fetchPlaceFromPlaceId]-এ কল করুন, একটি প্লেস আইডি ও কলব্যাক সহ স্ট্রিং পাস করুন। এটি GMSPlacePhotoMetadataList অবজেক্টের সাথে কলব্যাক কল করবে।
2. GMSPlacePhotoMetadataList অবজেক্টে results প্রপার্টি অ্যাক্সেস করুন এবং অ্যারে থেকে লোড করার জন্য ফটো বেছে নিন।
3. এই তালিকা থেকে প্রতিটি GMSPlacePhotoMetadata লোড করতে [GMSPlacesClient loadPlacePhoto:callback:] অথবা [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:] কল করুন। এগুলি ব্যবহারযোগ্য UIImage সহ কলব্যাককে কল করবে। ছবির সর্বাধিক প্রস্থ বা দৈর্ঘ্য ১৬০০ পিক্সেল হতে পারে।

মনে রাখবেন: আপনি যখনই কোনও জায়গার ফটো দেখাবেন, তখন অ্যাট্রিবিউশন নির্দেশিকা মেনে চলতে ভুলবেন না। আরও তথ্যের জন্য অ্যাট্রিবিউশন দেখুন।

নমুনা কোড

নিচের উদাহরণ পদ্ধতিতে একটি প্লেস আইডি নেওয়া হয় এবং রিটার্ন করা তালিকায় প্রথম ফটোটি পাওয়া যায়। আপনি এই পদ্ধতিটি আপনার নিজের অ্যাপে তৈরি করা পদ্ধতির টেমপ্লেট হিসেবে ব্যবহার করতে পারবেন।

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-এ Foundation URL লোডিং সিস্টেম-এর মাধ্যমে ডিস্ক ও ইন-মেমরি, দুটিতেই ক্যাশে করা হয়।

ক্যাশিং আচরণ কনফিগার করতে, আপনি নিজের অ্যাপ্লিকেশন ডেলিগেটের application:didFinishLaunchingWithOptions: পদ্ধতিতে [NSURLCache setSharedURLCache:] ব্যবহার করে শেয়ার করা URL ক্যাশে পরিবর্তন করতে পারবেন।

আপনি যদি চান যে আপনার অ্যাপ্লিকেশনটি iOS-এর জন্য Places SDK-এর সাথে NSURLCache শেয়ার না করুক, তাহলে আপনি একটি নতুন NSURLCache তৈরি করতে পারেন এবং এটিকে শেয়ার করা ক্যাশে হিসেবে সেট না করেই আপনার অ্যাপের মধ্যে এক্সক্লুসিভভাবে ব্যবহার করতে পারেন।

অ্যাট্রিবিউশন

বেশিরভাগ ক্ষেত্রে, জায়গার ফটো অ্যাট্রিবিউশন ছাড়াই ব্যবহার করা যেতে পারে অথবা ছবির অংশ হিসেবে প্রয়োজনীয় অ্যাট্রিবিউশন অন্তর্ভুক্ত করা থাকবে। তবে, ফেরত পাওয়া GMSPlacePhotoMetadata ইনস্ট্যান্সে অ্যাট্রিবিউশন থাকলে, আপনাকে অবশ্যই নিজের অ্যাপ্লিকেশনে অতিরিক্ত অ্যাট্রিবিউশন যোগ করতে হবে, যেখানেই আপনি ছবিটি দেখান না কেন। মনে রাখবেন যে অ্যাট্রিবিউশনে লিঙ্কে ক্লিক করতে হবে। অ্যাট্রিবিউশন সংক্রান্ত ডকুমেন্টেশন দেখুন।

ব্যবহারের সীমা

একটি ছবি ফিরিয়ে আনার জন্য কোটার একটি ইউনিট খরচ হয়; ফটো মেটাডেটা ফিরিয়ে আনার জন্য ব্যবহারের কোনও সীমা নেই। ব্যবহার ও বিলিং সম্পর্কে আরও জানুন।