Method: places.photos.getMedia

ফটো রেফারেন্স স্ট্রিং সহ একটি ফটো মিডিয়া সংগ্রহ করুন।

HTTP অনুরোধ

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
name

string

আবশ্যক। একটি ফটো মিডিয়ার রিসোর্স নামটি এই বিন্যাসে হতে হবে: places/{placeId}/photos/{photo_reference}/media ।

একটি Place অবজেক্টের photos.name ফিল্ডে ফেরত আসা ছবির রিসোর্স নামটি places/{placeId}/photos/{photo_reference} ফরম্যাটে থাকে। ছবির মিডিয়া রিসোর্স নামটি পেতে হলে, আপনাকে ফটো রিসোর্সের শেষে /media যুক্ত করতে হবে।

কোয়েরি প্যারামিটার

প্যারামিটার
maxWidthPx

integer

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

maxHeightPx অথবা maxWidthPx-এর মধ্যে অন্তত একটি অবশ্যই উল্লেখ করতে হবে। যদি maxHeightPx বা maxWidthPx কোনোটিই উল্লেখ করা না হয়, তাহলে একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হবে।

maxHeightPx

integer

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

maxHeightPx অথবা maxWidthPx-এর মধ্যে অন্তত একটি অবশ্যই উল্লেখ করতে হবে। যদি maxHeightPx বা maxWidthPx কোনোটিই উল্লেখ করা না হয়, তাহলে একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হবে।

skipHttpRedirect

boolean

ঐচ্ছিক। সেট করা থাকলে, ডিফল্ট HTTP রিডাইরেক্ট আচরণ এড়িয়ে যাওয়া হবে এবং একটি টেক্সট ফরম্যাটের (উদাহরণস্বরূপ, HTTP ব্যবহারের ক্ষেত্রে JSON ফরম্যাটে) প্রতিক্রিয়া দেখানো হবে। সেট করা না থাকলে, কলটিকে ইমেজ মিডিয়াতে রিডাইরেক্ট করার জন্য একটি HTTP রিডাইরেক্ট জারি করা হবে। নন-HTTP অনুরোধের ক্ষেত্রে এই বিকল্পটি উপেক্ষা করা হয়।

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া সংস্থা

Places API থেকে প্রাপ্ত একটি ফটো মিডিয়া।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "name": string,
  "photoUri": string
}
ক্ষেত্র
name

string

একটি ফটো মিডিয়ার রিসোর্স নামটি এই বিন্যাসে থাকে: places/{placeId}/photos/{photo_reference}/media ।

photoUri

string

একটি স্বল্পস্থায়ী ইউআরআই যা ছবিটি রেন্ডার করতে ব্যবহার করা যেতে পারে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/maps-platform.places.getphotomedia
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform