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

ইউরোপিয়ান ইকোনমিক এরিয়া (EEA) ডেভেলপার

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

স্থান ফটো (উত্তরাধিকার) অনুরোধ

একটি স্থান ফটো (উত্তরাধিকার) অনুরোধ নিম্নলিখিত ফর্মের একটি 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 and maxwidth properties accept an integer between 1 and 1600 .

    You must specify either maxheight , or maxwidth , 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 স্ট্যাটাস প্রদান করে, যা একটি অবৈধ অনুরোধ নির্দেশ করে। একটি অবৈধ অনুরোধের সবচেয়ে সাধারণ কারণগুলির মধ্যে রয়েছে: