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

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড আইওএস ওয়েব সার্ভিস

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

আপনার বিলিং ঠিকানা যদি ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) হয়, তবে ৮ জুলাই ২০২৫ থেকে আপনার পরিষেবা ব্যবহারের ক্ষেত্রে গুগল ম্যাপস প্ল্যাটফর্ম EEA-এর পরিষেবার শর্তাবলী প্রযোজ্য হবে। কার্যকারিতা অঞ্চলভেদে ভিন্ন হতে পারে। আরও জানুন ।

গুরুত্বপূর্ণ: এই এন্ডপয়েন্ট থেকে প্রাপ্ত ডেটা ব্যবহার করা Places API-এর প্রযোজ্য নীতিমালা এবং স্বত্বাধিকারের অধীন।

ভূমিকা

প্লেস ফটোস (নিউ) সার্ভিসটি একটি রিড-অনলি এপিআই, যা আপনাকে আপনার অ্যাপ্লিকেশনে উচ্চ মানের ফটোগ্রাফিক কন্টেন্ট যোগ করতে দেয়। প্লেস ফটোস (নিউ) আপনাকে প্লেসেস ডেটাবেসে সংরক্ষিত লক্ষ লক্ষ ফটোতে অ্যাক্সেস দেয়।

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

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

চেষ্টা করে দেখুন!

দ্রষ্টব্য: আপনার Place Details (New) রেসপন্স বডির photos অ্যারে থেকে স্থানের name লিখুন এবং 'Execute' এ ক্লিক করুন। ছবিটি দেখার জন্য, Place Photos (New) রেসপন্স বডিতে photoUri ভ্যালুটি ব্যবহার করুন।

ছবি (নতুন) অনুরোধ করুন

একটি Place Photos (New) অনুরোধ হলো একটি URL-এ পাঠানো একটি HTTP GET অনুরোধ, যার গঠনটি নিম্নরূপ:

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

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

• NAME এ ছবিটির রিসোর্স নেম থাকে।
• API_KEY তে এপিআই কী থাকে।
• PARAMETERS maxHeightPx প্যারামিটার, maxWidthPx প্যারামিটার, অথবা উভয়ই থাকতে পারে।

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

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

ছবির নাম

একটি স্ট্রিং আইডেন্টিফায়ার যা একটি ছবিকে অনন্যভাবে শনাক্ত করে। Place Details (New) , Nearby Search (New) , বা Text Search (New) রিকোয়েস্ট থেকে প্রাপ্ত ছবির নামগুলো photos[] অ্যারের প্রতিটি উপাদানের name প্রপার্টিতে পাওয়া যায়।

উদাহরণস্বরূপ, ‘একটি ছবির নাম পান’ দেখুন।

সর্বোচ্চ উচ্চতা পিক্সেল এবং সর্বোচ্চ প্রস্থ পিক্সেল

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

আপনাকে অবশ্যই 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 (Place Details (New)) অথবা places.photos (Nearby Search (New) এবং Text Search (New)) অন্তর্ভুক্ত করা নিশ্চিত করুন। প্রতিটি API একটি স্থানের অবস্থানের জন্য সর্বোচ্চ ১০টি ছবি ফেরত দিতে পারে।

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

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

  places/PLACE_ID/photos/PHOTO_RESOURCE

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

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

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

নিম্নলিখিত উদাহরণটি একটি Place Details (New) অনুরোধ দেখায় যেখানে ফিল্ড মাস্কে 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 ব্যবহার করে একটি ছবি ফেরত দেয় এবং সেটির আকার এমনভাবে পরিবর্তন করে যাতে এটি সর্বোচ্চ ৪০০ পিক্সেল লম্বা ও চওড়া হয়:

https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/ATKogpeivkIjQ1FT7QmbeT33nBSwqLhdPvIWHfrG1WfmgrFjeZYpS_Ls7c7rj8jejN9QGzlx4GoAH0atSvUzATDrgrZic_tTEJdeITdWL-oG3TWi5HqZoLozrjTaxoAIxmROHfV5KXVcLeTdCC6kmZExSy0CLVIG3lAPIgmvUiewNf-ZHYE4-jXYwPQpWHJgqVosvZJ6KWEgowEA-qRAzNTu9VH6BPFqHakGQ7EqBAeYOiU8Dh-xIQC8FcBJiTi0xB4tr-MYXUaF0p_AqzAhJcDE6FAgLqG1s7EsME0o36w2nDRHA-IuoISBC3SIahINE3Xwq2FzEZE6TpNTFVfgTpdPhV8CGLeqrauHn2I6ePm-2hA8-87aO7aClXKJJVzlQ1dc_JuHz6Ks07d2gglw-ZQ3ibCTF5lMtCF9O-9JHyRQXsfuXw/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY

একটি সফল 'স্থানের ছবি (নতুন)' অনুরোধের প্রতিক্রিয়া হলো একটি ছবি।

দ্রষ্টব্য: ছবির ফরম্যাট ভিন্ন হতে পারে। প্রচলিত ছবির ফরম্যাটগুলো (যেমন JPEG, PNG, এবং GIF) সমর্থিত, কিন্তু গুগল ছবির ফরম্যাটের কোনো নিশ্চয়তা দেয় না।

ত্রুটি কোড

নতুন ছবি স্থাপনের অনুরোধগুলি নিম্নলিখিত ত্রুটি কোডগুলি দেখাতে পারে।

কোটা অতিক্রম করেছে (403)

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

অবৈধ অনুরোধ (404)

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

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

অনেক বেশি অনুরোধ (429)

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

চেষ্টা করে দেখুন!

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

অনুরোধ করতে:

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

   places/PLACE_ID/photos/PHOTO_RESOURCE/media

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

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