স্থানের ফটোগুলি (উত্তরাধিকার), স্থানের ফটোগুলি (উত্তরাধিকার), স্থানের ফটোগুলি (উত্তরাধিকার), স্থানের ফটোগুলি (উত্তরাধিকার)

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

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

স্থানের ছবি (লিগ্যাসি) অনুরোধ

একটি স্থানের ছবি (লিগ্যাসি) অনুরোধ হল নিম্নলিখিত ফর্মের একটি HTTP URL:

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

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

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 and maxwidth properties accept an integer between 1 and 1600 .

    You must specify either maxheight , or maxwidth , or both.

ছবির রেফারেন্স

স্থানের ছবি (উত্তরাধিকার) সংক্রান্ত সমস্ত অনুরোধে একটি photo_reference অন্তর্ভুক্ত থাকতে হবে, যা স্থান খুঁজুন (উত্তরাধিকার), কাছাকাছি অনুসন্ধান (উত্তরাধিকার), পাঠ্য অনুসন্ধান (উত্তরাধিকার), অথবা স্থানের বিবরণ (উত্তরাধিকার) অনুরোধের প্রতিক্রিয়ায় ফেরত পাঠানো হবে। যদি স্থানটিতে সম্পর্কিত ফটোগ্রাফিক সামগ্রী থাকে তবে এই অনুরোধগুলির প্রতিক্রিয়ায় একটি photos[] ক্ষেত্র থাকবে।

দ্রষ্টব্য: অনুরোধ অনুসারে ফেরত পাঠানো ছবির সংখ্যা পরিবর্তিত হয়।

  • একটি Find Place (Legacy), Nearby Search (Legacy), অথবা Text Search (Legacy) অনুরোধ অ্যারেতে সর্বাধিক একটি photo উপাদান প্রদান করে।
  • একটি স্থানের বিবরণ (উত্তরাধিকার) অনুরোধ দশটি পর্যন্ত photo উপাদান ফেরত পাঠায়।

প্রতিটি photo উপাদানে নিম্নলিখিত ক্ষেত্রগুলি থাকে:

  • photo_reference — একটি স্ট্রিং যা আপনি যখন একটি Place Photos (Legacy) অনুরোধ করেন তখন ছবিটি সনাক্ত করতে ব্যবহৃত হয়।
  • 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"
       }]
    ...

স্থানের ছবি (লিগ্যাসি) উদাহরণ

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

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 মান পেতে Place Details (Legacy) , Find Place (Legacy) , Nearby Search (Legacy) , অথবা Text Search (Legacy) এ অনুরোধ করুন।