Place Photos (নতুন) আপনাকে আপনার অ্যাপ্লিকেশনে উচ্চমানের ফটোগ্রাফিক কন্টেন্ট যোগ করতে দেয়। Place Photos আপনাকে Places ডাটাবেসে সংরক্ষিত লক্ষ লক্ষ ছবির অ্যাক্সেস দেয়। Place Photos একটি বিটম্যাপ ছবিতে একটি URI ফেরত দেয়। বিটম্যাপ ছবির সর্বোচ্চ আকার 4800 বাই 4800 পিক্সেল।
ছবি রাখার অনুরোধ
কোনও জায়গার ছবি উদ্ধার করতে:
-
fetchPlace()ব্যবহার করে একটিPlaceঅবজেক্ট আনতে Place Details (New) ব্যবহার করুন। প্রতিক্রিয়াPlaceঅবজেক্টে অন্তর্ভুক্ত করার জন্য ক্ষেত্রগুলির তালিকায়Place.Field PHOTO_METADATASক্ষেত্রটি অন্তর্ভুক্ত করতে ভুলবেন না। - আপনার
FetchPlaceResponseএরOnSuccessListenerএ,Place.getPhotoMetadas()কল করে রেসপন্সPlaceঅবজেক্ট থেকেPhotoMetadataধরণের ফটো মেটাডেটা অবজেক্টটি পান। - অনুরোধটি করার জন্য একটি
FetchResolvedPhotoUriRequestঅবজেক্ট তৈরি করুন এবং ছবির মেটাডেটা অবজেক্ট, সেইসাথে সর্বোচ্চ উচ্চতা, সর্বোচ্চ প্রস্থ, অথবা উভয়ের মান পাস করুন। - ছবির URI অনুরোধ করতে
PlacesClient.fetchResolvedPhotoUri()ব্যবহার করুন। - একটি
OnSuccessListenerযোগ করুন এবংFetchResolvedPhotoUriResponseঅবজেক্ট থেকে ছবির URI পান।
প্রয়োজনীয় পরামিতি
FetchResolvedPhotoUriRequest এর জন্য প্রয়োজনীয় প্যারামিটারগুলি হল:
ছবির মেটাডেটা
ছবির মেটাডেটা অবজেক্ট যা ফেরত পাঠানো হবে।
সর্বোচ্চ উচ্চতা বা সর্বোচ্চ প্রস্থ
যে ছবিটি ফেরত পাঠানো হবে তার সর্বোচ্চ উচ্চতা এবং প্রস্থ পিক্সেলের মাধ্যমে নির্দিষ্ট করে। যদি ছবিটি নির্দিষ্ট মানের চেয়ে ছোট হয়, তাহলে মূল ছবিটি ফেরত পাঠানো হবে। যদি ছবিটি উভয় মাত্রায় বড় হয়, তাহলে এটি দুটি মাত্রার ছোটটির সাথে মিলে স্কেল করা হবে, যা এর মূল আকৃতির অনুপাতের মধ্যে সীমাবদ্ধ থাকবে। সর্বোচ্চ উচ্চতা এবং সর্বোচ্চ প্রস্থ উভয় বৈশিষ্ট্যই 1 এবং 4800 এর মধ্যে একটি পূর্ণসংখ্যা গ্রহণ করে। আপনাকে সর্বোচ্চ উচ্চতা, সর্বোচ্চ প্রস্থ, অথবা উভয়ই নির্দিষ্ট করতে হবে।
- সর্বোচ্চ উচ্চতা প্যারামিটার সেট করতে,
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.getAttributions()দ্বারা অ্যাক্সেস করা হয়। - AuthorAttributions , একটি
AuthorAttributionsঅবজেক্ট যাPhotoMetadata.getAuthorAttributions()দ্বারা অ্যাক্সেস করা হয়।
যদি ফেরত পাঠানো PhotoMetadata অবজেক্টে যেকোনো ধরণের অ্যাট্রিবিউশন থাকে, তাহলে আপনার অ্যাপ্লিকেশনে যেখানেই ছবিটি প্রদর্শিত হবে সেখানেই অ্যাট্রিবিউশনটি অন্তর্ভুক্ত করতে হবে। আরও তথ্যের জন্য, Displaying Atributions দেখুন।