Place Photos (লিগ্যাসি)

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

Place Photos (Legacy), Places API-এর অংশ, এটি একটি রিড- অনলি API যা আপনাকে আপনার অ্যাপ্লিকেশনে উচ্চ মানের ফটোগ্রাফিক কন্টেন্ট যোগ করতে দেয়। Place Photos (Legacy) আপনাকে Places ডেটাবেসে স্টোর করা লক্ষ লক্ষ ফটো অ্যাক্সেস করার সুবিধা দেয়। আপনি যখন কোনও জায়গার বিবরণ সংক্রান্ত অনুরোধ ব্যবহার করে জায়গার তথ্য পান, তখন প্রাসঙ্গিক ফটোগ্রাফিক কন্টেন্টের জন্য ফটো রেফারেন্স ফেরত দেওয়া হবে। Find Place (Legacy), Nearby Search (Legacy) এবং Text Search (Legacy) অনুরোধের ক্ষেত্রেও প্রাসঙ্গিক হলে, প্রতিটি জায়গার জন্য একটি করে ফটো রেফারেন্স দেখানো হয়। Place Photos (Legacy) ব্যবহার করে আপনি রেফারেন্স করা ফটো অ্যাক্সেস করতে এবং আপনার অ্যাপ্লিকেশনের জন্য ছবির সাইজ পরিবর্তন করে উপযুক্ত সাইজে আনতে পারবেন।

Place Photos (Legacy) সংক্রান্ত অনুরোধ

Place Photos (Legacy) অনুরোধ হল নিম্নলিখিত ফর্মের একটি HTTP URL:

https://maps.googleapis.com/maps/api/place/photo?parameters

সার্চের অনুরোধ শুরু করার জন্য নির্দিষ্ট কিছু প্যারামিটার প্রয়োজন। URL-এর স্ট্যান্ডার্ড অনুযায়ী, সব প্যারামিটারকে অ্যামপারস্যান্ড (&) অক্ষর ব্যবহার করে আলাদা করা হয়। প্যারামিটারের তালিকা এবং সেগুলির সম্ভাব্য ভ্যালু নিচে উল্লেখ করা হল।

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

photo_reference

একটি স্ট্রিং শনাক্তকারী যা অনন্যভাবে একটি ফটো শনাক্ত করে। ফটো রেফারেন্স জায়গা সার্চ করা বা জায়গার বিবরণ সংক্রান্ত অনুরোধ থেকে পাওয়া যায়।

সর্বাধিক উচ্চতা বা সর্বাধিক প্রস্থ

maxheight পিক্সেলে ছবির সর্বাধিক পছন্দের উচ্চতা নির্দিষ্ট করে। যদি ছবিটি নির্দিষ্ট করা মানের থেকে ছোট হয়, তাহলে আসল ছবিটি ফেরত দেওয়া হবে। কোনও একটি ডাইমেনশনে ছবি বড় হলে, সেটিকে স্কেল করে দুটি ডাইমেনশনের মধ্যে যেটি ছোট সেটির সাথে ম্যাচ করানো হবে, তবে আসল অ্যাস্পেক্ট রেশিও পরিবর্তন করা হবে না।

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

maxheight এবং maxwidth প্রপার্টি দুটিতেই 1 এবং 1600-এর মধ্যে পূর্ণসংখ্যা লিখতে হবে।

আপনাকে অবশ্যই maxheight, অথবা maxwidth, অথবা দুটিই উল্লেখ করতে হবে।

ফটো রেফারেন্স

Place Photos (লিগ্যাসি)-এর জন্য সব অনুরোধে অবশ্যই একটি photo_reference অন্তর্ভুক্ত থাকতে হবে, যা Find Place (লিগ্যাসি), নিয়ারবাই Search (লিগ্যাসি), টেক্সট সার্চ (লিগ্যাসি) বা জায়গার বিবরণ (লিগ্যাসি) অনুরোধের উত্তরে ফেরত পাঠানো হয়। এইসব অনুরোধের উত্তরে একটি photos[] ফিল্ড থাকবে, যদি সেই জায়গার সাথে সম্পর্কিত ফটোগ্রাফিক কন্টেন্ট থাকে।

  • Find Place (Legacy), নিয়ারবাই Search (Legacy) বা টেক্সট সার্চ (Legacy) সংক্রান্ত অনুরোধ অ্যারেতে সর্বাধিক একটি photo এলিমেন্ট রিটার্ন করে।
  • কোনও Place Details (Legacy) অনুরোধ সর্বাধিক দশটি photo এলিমেন্ট রিটার্ন করে।

প্রতিটি photo এলিমেন্টে নিম্নলিখিত ফিল্ড থাকে:

  • photo_reference — আপনি যখন কোনও জায়গার ফটো (লিগ্যাসি) সংক্রান্ত অনুরোধ করেন, তখন ফটো শনাক্ত করার জন্য ব্যবহৃত একটি স্ট্রিং।
  • height — ছবির সর্বাধিক উচ্চতা।
  • width — ছবির সর্বাধিক প্রস্থ।
  • html_attributions[] — এতে প্রয়োজনীয় অ্যাট্রিবিউশন আছে। এই ফিল্ডটি সবসময় থাকবে, তবে খালি থাকতে পারে।

Place Photos (Legacy) থেকে পাওয়া ফটো বিভিন্ন লোকেশন থেকে সোর্স করা হয়, যার মধ্যে ব্যবসার মালিক ও ব্যবহারকারীর কন্ট্রিবিউট করা ফটোও অন্তর্ভুক্ত। বেশিরভাগ ক্ষেত্রে, এইসব ফটো অ্যাট্রিবিউশন ছাড়াই ব্যবহার করা যেতে পারে অথবা ছবির অংশ হিসেবে প্রয়োজনীয় অ্যাট্রিবিউশন অন্তর্ভুক্ত করা থাকবে। তবে, ফেরত আসা 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"
       }]
    ...

Place Photos (লিগ্যাসি) সংক্রান্ত উদাহরণ

অনুরোধের একটি উদাহরণ নিচে দেখানো হয়েছে। এই অনুরোধ রেফারেন্স করা ছবি ফিরিয়ে দেয়, এটি রিসাইজ করে যাতে এটি সর্বাধিক ৪০০ পিক্সেল চওড়া হয়।

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

Place Photos (Legacy) রেসপন্স

কোনও জায়গার ফটো (লিগ্যাসি) সংক্রান্ত অনুরোধের উত্তর হিসেবে একটি ছবি পাওয়া যায়। ছবির ধরন আসল জমা দেওয়া ফটোর ধরনের উপর নির্ভর করে।

আপনার অনুরোধ উপলভ্য কোটা অতিক্রম করলে, সার্ভার একটি HTTP 403 স্ট্যাটাস রিটার্ন করে এবং কোটা অতিক্রম করা হয়েছে তা বোঝাতে নিচের ছবি দেখায়:

কোটার সীমা ছাড়িয়ে যাওয়া সম্পর্কিত ছবি

সার্ভার আপনার অনুরোধ বুঝতে না পারলে, এটি HTTP 400 স্ট্যাটাস দেখায়, যা ভুল অনুরোধের ইঙ্গিত দেয়। অনুরোধ ভুল হওয়ার সবচেয়ে সাধারণ কারণগুলি হল:

  • জমা দেওয়া ফটো রেফারেন্স সঠিকভাবে উল্লেখ করা হয়নি।
  • অনুরোধে maxwidth বা maxheight প্যারামিটার অন্তর্ভুক্ত ছিল না।
  • maxwidth বা maxheight প্যারামিটারের ভ্যালু null-এ সেট করা হয়েছে।
  • photo_reference-এর মেয়াদ শেষ হয়ে গেছে। photo_reference-এর মেয়াদ শেষ হয়ে গেলে, আপডেট করা photo_reference ভ্যালু পেতে জায়গার বিবরণ (Legacy), জায়গা খুঁজুন (Legacy), নিয়ারবাই Search (Legacy), অথবা টেক্সট সার্চ (Legacy) করার অনুরোধ করুন।