Place Photos (নতুন)

প্ল্যাটফর্ম বেছে নিন: Android iOS ওয়েব পরিষেবা

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর ডেভেলপার

Place Photos (New) আপনাকে নিজের অ্যাপ্লিকেশনে খুব ভালো কোয়ালিটির ফটোগ্রাফিক কন্টেন্ট যোগ করতে দেয়। Place Photos আপনাকে Places ডেটাবেসে স্টোর করা লক্ষ লক্ষ ফটোতে অ্যাক্সেস দেয়। Place Photos বিটম্যাপ ছবির URI রিটার্ন করে। বিটম্যাপ ইমেজের সর্বাধিক সাইজ হল ৪৮০০ বাই ৪৮০০ পিক্সেল।

Place Photos সংক্রান্ত অনুরোধ

কোনও জায়গার ছবি ফিরিয়ে আনতে:

  1. fetchPlace() ব্যবহার করে Place অবজেক্ট ফেচ করতে জায়গার বিবরণ (নতুন) ব্যবহার করুন। Place.Field PHOTO_METADATAS ফিল্ডটি ফিল্ডের তালিকায় অন্তর্ভুক্ত করতে ভুলবেন না, যাতে Place অবজেক্টের উত্তরে অন্তর্ভুক্ত করা যায়।
  2. আপনার FetchPlaceResponse-এর OnSuccessListener-এ, Place অবজেক্টের রেসপন্স থেকে PhotoMetadata ধরনের ফটো মেটাডেটা অবজেক্ট পেতে Place.getPhotoMetadas() কল করুন।
  3. অনুরোধ করতে এবং ফটো মেটাডেটা অবজেক্ট পাস করতে, একটি FetchResolvedPhotoUriRequest অবজেক্ট তৈরি করুন, সেইসাথে সর্বাধিক উচ্চতা, সর্বাধিক প্রস্থ বা উভয়ের মান পাস করুন।
  4. ফটো URI-এর জন্য অনুরোধ করতে PlacesClient.fetchResolvedPhotoUri() ব্যবহার করুন।
  5. OnSuccessListener যোগ করুন এবং FetchResolvedPhotoUriResponse অবজেক্ট থেকে ফটো URI পান।

প্রয়োজনীয় প্যারামিটার

FetchResolvedPhotoUriRequest এর জন্য প্রয়োজনীয় প্যারামিটারগুলি হল:

  • ফটো মেটাডেটা

    ফটো থেকে মেটাডেটা অবজেক্ট ফিরিয়ে আনা।

  • সর্বাধিক উচ্চতা বা সর্বাধিক প্রস্থ

    ফেরত পাঠানোর জন্য ছবির সর্বাধিক দৈর্ঘ্য ও প্রস্থ পিক্সেলে উল্লেখ করে। ছবিটি নির্দিষ্ট করা ভ্যালুর থেকে ছোট হলে, আসল ছবিটি ফেরত দেওয়া হবে। কোনও একটি ডাইমেনশনে ছবি বড় হলে, সেটিকে ছোট ডাইমেনশনের সাথে ম্যাচ করার জন্য স্কেল করা হবে এবং আসল অ্যাস্পেক্ট রেশিওতে সীমাবদ্ধ করা হবে। সর্বাধিক দৈর্ঘ্য ও সর্বাধিক প্রস্থ, এই দুটি প্রপার্টিতেই ১ থেকে ৪৮০০-এর মধ্যে পূর্ণসংখ্যা ব্যবহার করা যায়। আপনাকে অবশ্যই সর্বাধিক উচ্চতা, সর্বাধিক প্রস্থ বা দুটিই উল্লেখ করতে হবে।

    • সর্বাধিক উচ্চতার প্যারামিটার সেট করতে, FetchResolvedPhotoUriRequest অবজেক্ট তৈরি করার সময় setMaxHeight() মেথড কল করুন।
    • সর্বাধিক প্রস্থের প্যারামিটার সেট করতে, FetchResolvedPhotoUriRequest অবজেক্ট তৈরি করার সময় setMaxWidth() মেথড কল করুন।

Place Photos-এর উদাহরণ

নিচের উদাহরণে দেখানো হয়েছে কীভাবে কোনও জায়গার ফটো URI পাওয়া যায়।

// Define a Place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify fields. Requests for photos must always have the PHOTO_METADATAS field.
final List<Place.Field> fields = Collections.singletonList(Place.Field.PHOTO_METADATAS);

// Get a Place object
final FetchPlaceRequest placeRequest = FetchPlaceRequest.newInstance(placeId, fields);

placesClient.fetchPlace(placeRequest).addOnSuccessListener((response) -> {
    final Place place = response.getPlace();

    // Get the photo metadata.
    final List<PhotoMetadata> metadata = place.getPhotoMetadatas();
    if (metadata == null || metadata.isEmpty()) {
        Log.w(TAG, "No photo metadata.");
        return;
    }
    final PhotoMetadata photoMetadata = metadata.get(0);

    // Get the attribution text and author attributions.
    final String attributions = photoMetadata.getAttributions();
    final AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions();

    // Create a FetchResolvedPhotoUriRequest.
    final FetchResolvedPhotoUriRequest photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata)
        .setMaxWidth(500)
        .setMaxHeight(300)
        .build();

    // Request the photo URI
    placesClient.fetchResolvedPhotoUri(photoRequest).addOnSuccessListener((fetchResolvedPhotoUriResponse) -> {
        Uri uri = fetchResolvedPhotoUriResponse.getUri();
        RequestOptions requestOptions = new RequestOptions().override(Target.SIZE_ORIGINAL);
        Glide.with(this).load(uri).apply(requestOptions).into(imageView);
    }).addOnFailureListener((exception) -> {
        if (exception instanceof ApiException) {
            final ApiException apiException = (ApiException) exception;
            Log.e(TAG, "Place not found: " + exception.getMessage());
            final int statusCode = apiException.getStatusCode();
            // TODO: Handle error with given status code.
        }
    });
});

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

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

ফেরত পাঠানো PhotoMetadata অবজেক্টে যেকোনও ধরনের অ্যাট্রিবিউশন থাকলে, আপনি যেখানেই ছবি দেখাবেন সেখানেই আপনার অ্যাপ্লিকেশনে অ্যাট্রিবিউশন অন্তর্ভুক্ত করতে হবে। আরও তথ্যের জন্য, অ্যাট্রিবিউশন দেখানো দেখুন।