স্থানের ছবি (নতুন)

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড আইওএস ওয়েব সার্ভিস

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

প্লেস ফটোস (নতুন) আপনাকে আপনার অ্যাপ্লিকেশনে উচ্চ মানের ফটোগ্রাফিক কন্টেন্ট যোগ করার সুযোগ দেয়। প্লেস ফটোস আপনাকে প্লেসেস ডেটাবেসে সংরক্ষিত লক্ষ লক্ষ ফটো অ্যাক্সেস করার সুবিধা দেয়। প্লেস ফটোস একটি বিটম্যাপ ইমেজের URI রিটার্ন করে। বিটম্যাপ ইমেজটির সর্বোচ্চ আকার ৪৮০০ বাই ৪৮০০ পিক্সেল।

ছবি অনুরোধ করুন

কোনো স্থানের ছবি পুনরুদ্ধার করতে:

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

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

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

  • ছবির মেটাডেটা

    ফেরত দেওয়ার জন্য ফটোটির মেটাডেটা অবজেক্ট।

  • সর্বোচ্চ উচ্চতা বা সর্বোচ্চ প্রস্থ

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

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

ছবির উদাহরণ

নিম্নলিখিত উদাহরণটি কোনো স্থানের ছবির 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 অবজেক্টে যদি কোনো ধরনের অ্যাট্রিবিউশন অন্তর্ভুক্ত থাকে, তাহলে আপনার অ্যাপ্লিকেশনে যেখানেই ছবিটি প্রদর্শন করবেন, সেখানেই আপনাকে অ্যাট্রিবিউশনটি অন্তর্ভুক্ত করতে হবে। আরও তথ্যের জন্য, অ্যাট্রিবিউশন প্রদর্শন (Displaying Attributions ) দেখুন।