প্লেস ফটো সার্ভিস, প্লেস এপিআই-এর অংশ, একটি পঠনযোগ্য API যা আপনাকে আপনার অ্যাপ্লিকেশনে উচ্চ মানের ফটোগ্রাফিক সামগ্রী যোগ করতে দেয়। প্লেস ফটো পরিষেবা আপনাকে স্থান ডেটাবেসে সঞ্চিত লক্ষ লক্ষ ফটোতে অ্যাক্সেস দেয়৷ যখন আপনি স্থানের বিবরণের অনুরোধ ব্যবহার করে স্থানের তথ্য পান, তখন প্রাসঙ্গিক ফটোগ্রাফিক সামগ্রীর জন্য ছবির রেফারেন্স ফেরত দেওয়া হবে। স্থান খুঁজুন, কাছাকাছি অনুসন্ধান, এবং পাঠ্য অনুসন্ধান অনুরোধগুলি প্রাসঙ্গিক হলে প্রতি স্থানের জন্য একটি একক ছবির রেফারেন্স প্রদান করে। ফটো পরিষেবা ব্যবহার করে আপনি তারপরে উল্লেখিত ফটোগুলি অ্যাক্সেস করতে পারেন এবং আপনার অ্যাপ্লিকেশনের জন্য সর্বোত্তম আকারে চিত্রটির আকার পরিবর্তন করতে পারেন৷
ফটো অনুরোধ রাখুন
একটি স্থান ফটো অনুরোধ নিম্নলিখিত ফর্মের একটি HTTP URL:
https://maps.googleapis.com/maps/api/place/photo?parameters
একটি অনুসন্ধান অনুরোধ শুরু করার জন্য নির্দিষ্ট পরামিতি প্রয়োজন। ইউআরএল-এ স্ট্যান্ডার্ড হিসাবে, অ্যাম্পারস্যান্ড ( &
) অক্ষর ব্যবহার করে সমস্ত প্যারামিটার আলাদা করা হয়। পরামিতিগুলির তালিকা এবং তাদের সম্ভাব্য মানগুলি নীচে গণনা করা হয়েছে।
Required parameters
photo_reference
A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.
maxheight or maxwidth
maxheight
specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.maxwidth
specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.You must specify either
maxheight
, ormaxwidth
, or both.
ছবির রেফারেন্স
স্থান ফটো পরিষেবার সমস্ত অনুরোধে অবশ্যই একটি photo_reference
অন্তর্ভুক্ত করতে হবে, একটি স্থান খুঁজুন, কাছাকাছি অনুসন্ধান, পাঠ্য অনুসন্ধান, বা স্থানের বিশদ বিবরণের অনুরোধের প্রতিক্রিয়ায় ফিরে এসেছে। এই অনুরোধের প্রতিক্রিয়াতে একটি photos[]
ফিল্ড থাকবে যদি জায়গাটিতে ফটোগ্রাফিক বিষয়বস্তু থাকে।
দ্রষ্টব্য: ফেরত দেওয়া ছবির সংখ্যা অনুরোধ অনুসারে পরিবর্তিত হয়।
- একটি স্থান খুঁজুন, কাছাকাছি অনুসন্ধান, বা পাঠ্য অনুসন্ধান অনুরোধ অ্যারেতে সর্বাধিক একটি
photo
উপাদান প্রদান করে৷ - একটি স্থানের বিবরণ অনুরোধ দশটি
photo
উপাদান পর্যন্ত ফেরত দেয়।
প্রতিটি photo
উপাদান নিম্নলিখিত ক্ষেত্র ধারণ করে:
-
photo_reference
— একটি স্ট্রিং যা ফটো সনাক্ত করার জন্য ব্যবহৃত হয় যখন আপনি একটি ছবির অনুরোধ করেন। -
height
- ছবির সর্বোচ্চ উচ্চতা। -
width
— ছবির সর্বোচ্চ প্রস্থ। -
html_attributions[]
— যেকোন প্রয়োজনীয় অ্যাট্রিবিউশন রয়েছে। এই ক্ষেত্রটি সর্বদা উপস্থিত থাকবে, তবে খালি হতে পারে।
ফটো পরিষেবা দ্বারা প্রত্যাবর্তিত ফটোগুলি ব্যবসার মালিক এবং ব্যবহারকারীর অবদানের ফটোগুলি সহ বিভিন্ন অবস্থান থেকে নেওয়া হয়৷ বেশিরভাগ ক্ষেত্রে, এই ফটোগুলি অ্যাট্রিবিউশন ছাড়াই ব্যবহার করা যেতে পারে, বা ছবির একটি অংশ হিসাবে প্রয়োজনীয় অ্যাট্রিবিউশন অন্তর্ভুক্ত থাকবে৷ যাইহোক, যদি প্রত্যাবর্তিত photo
উপাদানটিতে html_attributions
ক্ষেত্রে একটি মান অন্তর্ভুক্ত থাকে, আপনি যেখানেই ছবিটি প্রদর্শন করবেন সেখানে আপনাকে অবশ্যই আপনার অ্যাপ্লিকেশনে অতিরিক্ত বৈশিষ্ট্য অন্তর্ভুক্ত করতে হবে।
নিম্নলিখিত উদাহরণ একটি স্থান বিবরণ অনুরোধ দেখায়:
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"
}
...
স্থান ফটো উদাহরণ
একটি উদাহরণ অনুরোধ নীচে দেখানো হয়েছে. এই অনুরোধটি রেফারেন্সকৃত চিত্রটি ফিরিয়ে দেবে, এটির আকার পরিবর্তন করবে যাতে এটি সর্বাধিক 400 পিক্সেল চওড়া হয়।
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q &key=YOUR_API_KEY
স্থান ফটো প্রতিক্রিয়া
একটি সফল স্থান ফটো অনুরোধের প্রতিক্রিয়া একটি ছবি হবে. ছবির ধরন নির্ভর করবে আসল জমা দেওয়া ছবির ধরনের উপর।
যদি আপনার অনুরোধ আপনার উপলব্ধ কোটা অতিক্রম করে, সার্ভার একটি HTTP 403 স্থিতি ফেরত দেবে এবং কোটা অতিক্রম করা হয়েছে তা নির্দেশ করতে নীচের চিত্রটি প্রদর্শন করবে:
সার্ভার আপনার অনুরোধ বুঝতে অক্ষম হলে, এটি HTTP 400 স্ট্যাটাস প্রদান করে, যা একটি অবৈধ অনুরোধ নির্দেশ করে। একটি অবৈধ অনুরোধের সবচেয়ে সাধারণ কারণগুলির মধ্যে রয়েছে:
- জমা দেওয়া ছবির রেফারেন্স সঠিকভাবে উল্লেখ করা হয়নি।
- অনুরোধে
maxwidth
বাmaxheight
পরামিতি অন্তর্ভুক্ত করা হয়নি। -
maxwidth
বাmaxheight
প্যারামিটারের মানnull
এ সেট করা হয়েছে। -
photo_reference
মেয়াদ শেষ হয়েছে।photo_reference
মেয়াদ শেষ হলে, আপডেট করাphoto_reference
মান পেতে স্থানের বিশদ বিবরণ , স্থান খুঁজুন , কাছাকাছি অনুসন্ধান বা পাঠ্য অনুসন্ধানের জন্য একটি অনুরোধ করুন।