স্থানের ছবি (নতুন)

প্লেস ফটো (নতুন) পরিষেবা হল একটি পঠনযোগ্য API যা আপনাকে আপনার অ্যাপ্লিকেশনে উচ্চ মানের ফটোগ্রাফিক সামগ্রী যোগ করতে দেয়৷ প্লেস ফটো পরিষেবা আপনাকে স্থান ডেটাবেসে সঞ্চিত লক্ষ লক্ষ ফটোতে অ্যাক্সেস দেয়৷

যখন আপনি স্থানের বিবরণ, কাছাকাছি অনুসন্ধান, বা পাঠ্য অনুসন্ধান অনুরোধ ব্যবহার করে স্থানের তথ্য পান, আপনি প্রাসঙ্গিক ফটোগ্রাফিক সামগ্রীর জন্য ফটো সংস্থানগুলির জন্য অনুরোধ করতে পারেন৷ ফটো পরিষেবা ব্যবহার করে, আপনি তারপরে উল্লেখিত ফটোগুলি অ্যাক্সেস করতে পারেন এবং আপনার অ্যাপ্লিকেশনের জন্য সর্বোত্তম আকারে চিত্রটির আকার পরিবর্তন করতে পারেন।

API এক্সপ্লোরার আপনাকে লাইভ অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পগুলির সাথে পরিচিত হতে পারেন:

এটা চেষ্টা করুন!

ফটো অনুরোধ রাখুন

একটি স্থানের ছবির অনুরোধ হল একটি URL-এর জন্য একটি HTTP GET অনুরোধ ফর্মে:

https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS

যেখানে নিম্নলিখিত পরামিতিগুলির প্রয়োজন হয়:

• NAME ছবির সম্পদের নাম রয়েছে৷
• API_KEY API কী রয়েছে।
• PARAMETERS হয় maxHeightPx প্যারামিটার, maxWidthPx প্যারামিটার বা উভয়ই থাকে।

প্রয়োজনীয় এবং ঐচ্ছিক পরামিতিগুলির সম্পূর্ণ তালিকা নীচে বর্ণিত হয়েছে।

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

ছবির নাম

একটি স্ট্রিং শনাক্তকারী যা একটি ফটোকে অনন্যভাবে সনাক্ত করে। ছবির নাম স্থানের বিবরণ (নতুন) , কাছাকাছি অনুসন্ধান (নতুন) বা টেক্সট অনুসন্ধান (নতুন) অনুরোধ থেকে photos[] অ্যারের প্রতিটি উপাদানের name বৈশিষ্ট্যে ফেরত দেওয়া হয়।

একটি উদাহরণের জন্য, একটি ছবির নাম পান দেখুন।

maxHeightPx এবং maxWidthPx

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

আপনাকে অবশ্যই maxHeightPx , বা maxWidthPx , বা উভয়ই নির্দিষ্ট করতে হবে৷

ঐচ্ছিক পরামিতি

skipHttpRedirect

false (ডিফল্ট) হলে, চিত্রটি ফেরত দিতে ছবিতে একটি HTTP পুনঃনির্দেশ করুন। true হলে, পুনঃনির্দেশ এড়িয়ে যান এবং একটি JSON প্রতিক্রিয়া প্রদান করুন যাতে চিত্রটি ব্যর্থ হয়। উদাহরণ স্বরূপ:

{
  "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media",
  "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo"
}

এই বিকল্পটি নন-HTTP অনুরোধের জন্য উপেক্ষা করা হয়।

একটি ছবির নাম পান

স্থান ফটো পরিষেবার সমস্ত অনুরোধে অবশ্যই একটি ফটো রিসোর্সের নাম অন্তর্ভুক্ত করতে হবে, যা একটি কাছাকাছি অনুসন্ধান, পাঠ্য অনুসন্ধান বা স্থানের বিবরণের অনুরোধের প্রতিক্রিয়াতে ফিরে এসেছে৷ এই অনুরোধের প্রতিক্রিয়াতে একটি photos[] অ্যারে থাকে যদি জায়গাটিতে ফটোগ্রাফিক সামগ্রী থাকে।

দ্রষ্টব্য: প্রতিক্রিয়াতে photos[] অ্যারে অন্তর্ভুক্ত করতে, অনুরোধের ফিল্ড মাস্কে photos (স্থানের বিশদ বিবরণ) বা places.photos (আশেপাশের অনুসন্ধান এবং পাঠ্য অনুসন্ধান) অন্তর্ভুক্ত করতে ভুলবেন না। প্রতিটি API একটি স্থান অবস্থানের জন্য 10টি ফটো পর্যন্ত ফেরত দিতে পারে৷

photo[] নিম্নলিখিত ক্ষেত্রগুলি ধারণ করে:

• name — যখন আপনি একটি ফটো অনুরোধ করেন তখন ছবির রিসোর্স নাম ধারণকারী একটি স্ট্রিং। এই স্ট্রিংটি আকারে রয়েছে:

  places/PLACE_ID/photos/PHOTO_RESOURCE

• heightPx — ছবির সর্বোচ্চ উচ্চতা, পিক্সেলে।
• widthPx — ছবির সর্বোচ্চ প্রস্থ, পিক্সেলে।
• authorAttributions[] — যেকোনো প্রয়োজনীয় অ্যাট্রিবিউশন। এই ক্ষেত্রটি সর্বদা উপস্থিত থাকে, তবে খালি হতে পারে।

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

সতর্কতা: আপনি একটি ছবির নাম ক্যাশে করতে পারবেন না। এছাড়াও, নামের মেয়াদ শেষ হতে পারে। নিশ্চিত করুন যে আপনি সর্বদা স্থানের বিবরণ (নতুন) , কাছাকাছি অনুসন্ধান (নতুন) বা পাঠ্য অনুসন্ধান (নতুন) এর অনুরোধের প্রতিক্রিয়া থেকে নাম পেয়েছেন। আরও তথ্যের জন্য, Google মানচিত্র প্ল্যাটফর্ম পরিষেবার শর্তাবলীর অধ্যায় 3.2.3(b)(কোনও ক্যাশিং নেই) উল্লেখ করা ক্যাশিং বিধিনিষেধগুলি দেখুন৷

নিম্নলিখিত উদাহরণটি একটি স্থানের বিবরণের অনুরোধ দেখায় যাতে ফিল্ড মাস্কে photos অন্তর্ভুক্ত থাকে যাতে প্রতিক্রিয়া প্রতিক্রিয়াতে photos[] অ্যারে অন্তর্ভুক্ত করে:

curl -X GET \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,photos" \
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E

প্রতিক্রিয়াতে photos[] অ্যারের একটি উদাহরণ নীচে দেখানো হয়েছে।

    ...
    "photos" : [
      {
        "name": "places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1",
        "widthPx": 6000,
        "heightPx": 4000,
        "authorAttributions": [
          {
            "displayName": "John Smith",
            "uri": "//maps.google.com/maps/contrib/101563",
            "photoUri": "//lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo"
          }
        ]
      },    ...

একটি জায়গা ছবির অনুরোধ করুন

নীচের উদাহরণের অনুরোধটি তার রিসোর্স name ব্যবহার করে একটি চিত্র ফেরত দেয়, এটিকে আকার পরিবর্তন করে যাতে এটি সর্বোচ্চ 400 পিক্সেল লম্বা এবং চওড়া হয়:

https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY

একটি সফল স্থান ফটো অনুরোধের প্রতিক্রিয়া একটি ছবি. ছবির ধরন মূলত জমা দেওয়া ছবির ধরনের উপর নির্ভর করে।

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

সার্ভার আপনার অনুরোধ বুঝতে অক্ষম হলে, এটি HTTP 400 স্ট্যাটাস প্রদান করে, যা একটি অবৈধ অনুরোধ নির্দেশ করে। একটি অবৈধ অনুরোধের সবচেয়ে সাধারণ কারণগুলির মধ্যে রয়েছে:

• জমা দেওয়া ছবির নাম সঠিকভাবে উল্লেখ করা হয়নি।
• অনুরোধে maxHeightPx বা maxWidthPx প্যারামিটার অন্তর্ভুক্ত করা হয়নি।
• maxHeightPx বা maxWidthtPx প্যারামিটারের মান null এ সেট করা হয়েছে।
• name মেয়াদ শেষ হয়ে গেছে। যদি name মেয়াদ শেষ হয়ে যায়, একটি নতুন name পেতে স্থানের বিবরণ (নতুন) , কাছাকাছি অনুসন্ধান (নতুন) বা পাঠ্য অনুসন্ধান (নতুন) করার জন্য একটি অনুরোধ করুন।

এটা চেষ্টা করুন!

API এক্সপ্লোরার আপনাকে নমুনা অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পগুলির সাথে পরিচিত হতে পারেন।

একটি অনুরোধ করতে:

1. API আইকন নির্বাচন করুন, , পৃষ্ঠার ডানদিকে।
2. name প্যারামিটারটি এতে সেট করুন:

   places/PLACE_ID/photos/PHOTO_RESOURCE/media

   দ্রষ্টব্য: নিশ্চিত করুন যে আপনি একটি সাম্প্রতিক স্থানের বিবরণ অনুরোধ থেকে একটি name ব্যবহার করছেন কারণ name মেয়াদ শেষ হতে পারে৷
3. skipHttpRedirect কে true সেট করুন যাতে অনুরোধটি একটি JSON প্রতিক্রিয়া প্রদান করে। ডিফল্টরূপে, অনুরোধটি চিত্রটি ফেরত দেয়, যা API এক্সপ্লোরার দ্বারা প্রদর্শিত হতে পারে না।
4. এক্সিকিউট বোতাম নির্বাচন করুন। পপ-আপে, আপনি অনুরোধ করতে যে অ্যাকাউন্টটি ব্যবহার করতে চান সেটি বেছে নিন।

5. API এক্সপ্লোরার প্যানেলে, প্রসারিত আইকন নির্বাচন করুন, , API এক্সপ্লোরার উইন্ডো প্রসারিত করতে।