প্লেস ফটো (নতুন) পরিষেবা হল একটি পঠনযোগ্য 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[]
অ্যারে থাকে যদি জায়গাটিতে ফটোগ্রাফিক সামগ্রী থাকে।
photo[]
নিম্নলিখিত ক্ষেত্রগুলি ধারণ করে:
name
— যখন আপনি একটি ফটো অনুরোধ করেন তখন ছবির রিসোর্স নাম ধারণকারী একটি স্ট্রিং। এই স্ট্রিংটি আকারে রয়েছে:places/PLACE_ID/photos/PHOTO_RESOURCE
-
heightPx
— ছবির সর্বোচ্চ উচ্চতা, পিক্সেলে। -
widthPx
— ছবির সর্বোচ্চ প্রস্থ, পিক্সেলে। -
authorAttributions[]
— যেকোনো প্রয়োজনীয় অ্যাট্রিবিউশন। এই ক্ষেত্রটি সর্বদা উপস্থিত থাকে, তবে খালি হতে পারে।
ফটো পরিষেবা দ্বারা প্রত্যাবর্তিত ফটোগুলি ব্যবসার মালিক এবং ব্যবহারকারীর অবদানের ফটোগুলি সহ বিভিন্ন অবস্থান থেকে নেওয়া হয়৷ বেশিরভাগ ক্ষেত্রে, এই ফটোগুলি অ্যাট্রিবিউশন ছাড়াই ব্যবহার করা যেতে পারে, বা ছবির একটি অংশ হিসাবে প্রয়োজনীয় অ্যাট্রিবিউশন অন্তর্ভুক্ত থাকবে৷ যাইহোক, যদি প্রত্যাবর্তিত photo
উপাদানটিতে authorAttributions
ক্ষেত্রে একটি মান অন্তর্ভুক্ত থাকে, আপনি যেখানেই ছবিটি প্রদর্শন করবেন সেখানে আপনাকে অবশ্যই আপনার অ্যাপ্লিকেশনে অতিরিক্ত বৈশিষ্ট্য অন্তর্ভুক্ত করতে হবে।
নিম্নলিখিত উদাহরণটি একটি স্থানের বিবরণের অনুরোধ দেখায় যাতে ফিল্ড মাস্কে 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 বিকল্পগুলির সাথে পরিচিত হতে পারেন।
একটি অনুরোধ করতে:
- API আইকন নির্বাচন করুন, , পৃষ্ঠার ডানদিকে।
-
name
প্যারামিটারটি এতে সেট করুন:places/PLACE_ID/photos/PHOTO_RESOURCE/media
-
skipHttpRedirect
কেtrue
সেট করুন যাতে অনুরোধটি একটি JSON প্রতিক্রিয়া প্রদান করে। ডিফল্টরূপে, অনুরোধটি চিত্রটি ফেরত দেয়, যা API এক্সপ্লোরার দ্বারা প্রদর্শিত হতে পারে না। - এক্সিকিউট বোতাম নির্বাচন করুন। পপ-আপে, আপনি অনুরোধ করতে যে অ্যাকাউন্টটি ব্যবহার করতে চান সেটি বেছে নিন।
API এক্সপ্লোরার প্যানেলে, প্রসারিত আইকন নির্বাচন করুন, , API এক্সপ্লোরার উইন্ডো প্রসারিত করতে।