Places API-এর অংশ, 'প্লেস ফটো' (Legacy) হল একটি রিড- অনলি API যা আপনাকে নিজের অ্যাপ্লিকেশনে খুব ভালো কোয়ালিটির ফটোগ্রাফিক কন্টেন্ট যোগ করতে দেয়। Place Photos (লিগ্যাসি) আপনাকে Places ডেটাবেসে স্টোর করা লক্ষ লক্ষ ফটো অ্যাক্সেস করার সুবিধা দেয়। আপনি যখন কোনও জায়গার বিবরণ সংক্রান্ত অনুরোধ ব্যবহার করে জায়গার তথ্য পান, তখন প্রাসঙ্গিক ফটোগ্রাফিক কন্টেন্টের জন্য ফটো রেফারেন্স ফেরত দেওয়া হবে। এছাড়াও, প্রাসঙ্গিক হলে, Find Place (Legacy), Nearby Search (Legacy) এবং Text Search (Legacy) কোয়েরির ক্ষেত্রেও প্রতি জায়গার জন্য একটি করে ফটো রেফারেন্স দেখানো হয়। Place Photos (Legacy) ব্যবহার করে আপনি রেফারেন্স ফটো অ্যাক্সেস করতে এবং আপনার অ্যাপ্লিকেশনের জন্য ছবির সাইজ অপ্টিমাইজ করতে পারবেন।
Place Photos (লিগ্যাসি) সংক্রান্ত অনুরোধ
Place Photos (Legacy) অনুরোধ হল নিম্নলিখিত ফর্মের একটি HTTP URL:
https://maps.googleapis.com/maps/api/place/photo?parameters
সার্চ অনুরোধ শুরু করার জন্য নির্দিষ্ট কিছু প্যারামিটার প্রয়োজন। URL-এ যেমন থাকে
তেমনি, সব প্যারামিটারকে অ্যামপারস্যান্ড (&) অক্ষর ব্যবহার করে আলাদা করা হয়। প্যারামিটারের
তালিকা এবং সেগুলির সম্ভাব্য ভ্যালু নিচে উল্লেখ করা হল।
প্রয়োজনীয় প্যারামিটার
-
photo_reference
একটি স্ট্রিং শনাক্তকারী যা অনন্যভাবে একটি ফটো শনাক্ত করে। ফটো রেফারেন্স প্লেস সার্চ বা প্লেস বিবরণ সংক্রান্ত অনুরোধ থেকে রিটার্ন করা হয়।
-
maxheight বা maxwidth
maxheightছবিতে সর্বাধিক পছন্দসই উচ্চতা, পিক্সেলে নির্দিষ্ট করে। যদি ছবিটি নির্দিষ্ট ভ্যালুর থেকে ছোট হয়, তাহলে আসল ছবিটি ফেরত দেওয়া হবে। ছবিটি কোনও একটি ডাইমেনশনে বড় হলে, এটিকে স্কেল করে দুটি ডাইমেনশনের মধ্যে ছোটটির সাথে ম্যাচ করানো হবে, তবে এর আসল অ্যাস্পেক্ট রেশিও বজায় রাখা হবে।maxwidthছবির সর্বাধিক পছন্দের প্রস্থ পিক্সেলে উল্লেখ করে। যদি ছবিটি নির্দিষ্ট করা ভ্যালুর থেকে ছোট হয়, তাহলে আসল ছবিটি রিটার্ন করা হবে। ছবিটি যদি কোনও একটি ডাইমেনশনে বড় হয়, তাহলে দুটি ডাইমেনশনের মধ্যে যেটি ছোট, সেটির সাথে ম্যাচ করানোর জন্য এটিকে স্কেল করা হবে। তবে, এর আসল অ্যাস্পেক্ট রেশিও বজায় রাখা হবে।maxheightওmaxwidth, দুটি প্রপার্টিতেই1থেকে1600-এর মধ্যে পূর্ণসংখ্যা গ্রহণ করা হয়।আপনাকে অবশ্যই
maxheightঅথবাmaxwidthঅথবা দুটিই উল্লেখ করতে হবে।
ফটো রেফারেন্স
প্লেস ফটো (লিগ্যাসি)-তে করা সব অনুরোধে অবশ্যই photo_reference,
Find Place (লিগ্যাসি), Nearby Search (লিগ্যাসি),
Text Search (লিগ্যাসি) বা Place Details (লিগ্যাসি) অনুরোধের উত্তরে রিটার্ন করতে হবে। এইসব অনুরোধের উত্তরে photos[] ফিল্ড থাকবে, যদি সেই জায়গার সাথে সম্পর্কিত ফটোগ্রাফিক কন্টেন্ট থাকে।
মনে রাখবেন: অনুরোধের ভিত্তিতে রিটার্ন করা ফটোর সংখ্যা আলাদা আলাদা হয়।
- Find Place (Legacy), Nearby Search (Legacy) বা Text Search (Legacy) অনুরোধ
অ্যারেতে সর্বাধিক একটি
photoএলিমেন্ট রিটার্ন করে। - একটি Place Details (Legacy) অনুরোধ সর্বাধিক দশটি
photoএলিমেন্ট রিটার্ন করে।
প্রতিটি photo এলিমেন্টে নিম্নলিখিত ফিল্ড থাকে:
photo_reference— আপনি কোনও জায়গার ফটো (লিগ্যাসি) সংক্রান্ত অনুরোধ করলে, ফটো শনাক্ত করার জন্য ব্যবহৃত স্ট্রিং।height— ছবির সর্বাধিক উচ্চতা।width— ছবির সর্বাধিক প্রস্থ।html_attributions[]— প্রয়োজনীয় অ্যাট্রিবিউশন আছে। এই ফিল্ড সবসময় থাকবে, তবে ফাঁকা থাকতে পারে।
Place Photos (Legacy) থেকে পাওয়া ফটো বিভিন্ন লোকেশন থেকে সংগ্রহ করা হয়,
এর মধ্যে ব্যবসার মালিক ও ব্যবহারকারীদের কন্ট্রিবিউট করা ফটো অন্তর্ভুক্ত। বেশিরভাগ ক্ষেত্রে, এইসব
ফটো অ্যাট্রিবিউশন ছাড়াই ব্যবহার করা যেতে পারে অথবা ছবিতে
প্রয়োজনীয় অ্যাট্রিবিউশন অন্তর্ভুক্ত করা থাকবে। তবে, ফিরে আসা photo এলিমেন্টে
html_attributions ফিল্ডে কোনও ভ্যালু থাকলে, আপনাকে অবশ্যই
আপনার অ্যাপ্লিকেশনে অতিরিক্ত অ্যাট্রিবিউশন যোগ করতে হবে, যেখানেই আপনি ছবিটি দেখান না কেন।
নিম্নলিখিত উদাহরণে স্থান সম্পর্কিত বিবরণ (Legacy) অনুরোধ দেখানো হয়েছে:
curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"
উত্তরে photos[] অ্যারের একটি উদাহরণ নিচে দেখানো হয়েছে।
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
}]
...
Place Photos (লিগ্যাসি) সংক্রান্ত উদাহরণ
নিচে অনুরোধের একটি উদাহরণ দেখানো হল। এই অনুরোধ রেফারেন্স করা ছবি ফিরিয়ে দেয়, সেটির সাইজ পরিবর্তন করে যাতে এটি সর্বাধিক ৪০০ পিক্সেল চওড়া হয়।
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q &key=YOUR_API_KEY
Place Photos (লিগ্যাসি) উত্তর
সফল Place Photos (Legacy) অনুরোধের উত্তর হল একটি ছবি। ছবির ধরন মূলত জমা দেওয়া ছবির ধরনের উপর নির্ভর করে।
আপনার অনুরোধ উপলভ্য কোটা অতিক্রম করলে, সার্ভার একটি HTTP 403 স্ট্যাটাস রিটার্ন করে এবং কোটা যে অতিক্রম করেছে তা বোঝাতে নিচের ছবিটি দেখায়:
সার্ভার আপনার অনুরোধ বুঝতে না পারলে, সেটি HTTP 400 স্ট্যাটাস রিটার্ন করে, যা একটি ভুল অনুরোধের ইঙ্গিত দেয়। অনুরোধ ভুল হওয়ার সবচেয়ে সাধারণ কারণগুলির মধ্যে পড়ে:
- জমা দেওয়া ছবির রেফারেন্স সঠিকভাবে উল্লেখ করা হয়নি।
- অনুরোধে
maxwidthবাmaxheightপ্যারামিটার অন্তর্ভুক্ত ছিল না। maxwidthবাmaxheightপ্যারামিটারের ভ্যালুnull-এ সেট করা হয়েছে।photo_reference-এর মেয়াদ শেষ হয়ে গেছে।photo_reference-এর মেয়াদ শেষ হয়ে গেলে, আপডেট করাphoto_referenceভ্যালু পেতে Place Details (Legacy), Find Place (Legacy), Nearby Search (Legacy), অথবা Text Search (Legacy)-এ অনুরোধ করুন।