একটি স্ট্রিট ভিউ ইমেজ অনুরোধ এই বিন্যাসে একটি HTTP URL হয়:
https://maps.googleapis.com/maps/api/streetview?parameters
অনুরোধ প্যারামিটার ব্যবহার করে ছবিটি নির্দিষ্ট করা হয়। ইউআরএল-এর প্রচলিত রীতি অনুযায়ী, সমস্ত প্যারামিটার অ্যামপারস্যান্ড (&) চিহ্ন দিয়ে আলাদা করা হয়। অনুমোদিত প্যারামিটার এবং তাদের সম্ভাব্য মানগুলি নীচে তালিকাভুক্ত করা হলো।
প্রয়োজনীয় প্যারামিটার
হয়:
-
locationএকটি টেক্সট স্ট্রিং (যেমনChagrin Falls, OH) অথবা অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্কের জোড়া (40.457375,-80.009353) হতে পারে এবং এটিকে অবশ্যই URL-এনকোড করতে হবে। তাই অনুরোধ পাঠানোর আগে "City Hall, New York, NY"-এর মতো ঠিকানাগুলিকে "City+Hall,New+York,NY"-তে রূপান্তর করুন। স্ট্রিট ভিউ স্ট্যাটিক এপিআই অবস্থানটির সবচেয়ে কাছের প্যানোরামা ফটোগ্রাফটিতে স্ন্যাপ করে। আপনি যখন একটি ঠিকানা টেক্সট স্ট্রিং প্রদান করেন, তখন এপিআই নির্দিষ্ট অবস্থানটিকে আরও ভালোভাবে দেখানোর জন্য একটি ভিন্ন ক্যামেরা অবস্থান ব্যবহার করতে পারে। আপনি যখন অক্ষাংশ এবং দ্রাঘিমাংশের স্থানাঙ্ক প্রদান করেন, তখন এপিআই অবস্থানটির সবচেয়ে কাছের ফটোগ্রাফটির জন্য ৫০ মিটার ব্যাসার্ধের মধ্যে অনুসন্ধান করে। যেহেতু স্ট্রিট ভিউ-এর চিত্রাবলী পর্যায়ক্রমে রিফ্রেশ করা হয় এবং প্রতিবার ফটোগ্রাফগুলি সামান্য ভিন্ন অবস্থান থেকে তোলা হতে পারে, তাই চিত্রাবলী আপডেট হওয়ার সময় আপনারlocationএকটি ভিন্ন প্যানোরামাতে স্ন্যাপ করার সম্ভাবনা রয়েছে।
অথবা:
-
panoহলো একটি নির্দিষ্ট প্যানোরামা আইডি। সময়ের সাথে সাথে প্যানোরামার আইডি পরিবর্তিত হতে পারে, তাই এই আইডিটি সংরক্ষণ করবেন না। এর পরিবর্তে, অবস্থানের ঠিকানা অথবা অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক সংরক্ষণ করুন, যাতে আপনি প্যানোরামা আইডিটি রিফ্রেশ করতে পারেন। বিস্তারিত জানতে, ‘মুছে ফেলা প্যানোরামা আইডি রিফ্রেশ করুন’ দেখুন।
পাশাপাশি:
-
sizeপিক্সেল-এ ছবির আউটপুট সাইজ নির্দিষ্ট করে। সাইজ{width}x{height}আকারে নির্দিষ্ট করা হয় - উদাহরণস্বরূপ,size=600x400লিখলে ছবিটি ৬০০ পিক্সেল চওড়া এবং ৪০০ পিক্সেল উঁচু হবে। -
keyআপনাকে Google Cloud কনসোলে আপনার অ্যাপ্লিকেশনের API ব্যবহার নিরীক্ষণ করতে দেয় এবং প্রয়োজনে Google যাতে আপনার অ্যাপ্লিকেশন সম্পর্কে আপনার সাথে যোগাযোগ করতে পারে, তা নিশ্চিত করে। আরও তথ্যের জন্য, Get a Key and Signature দেখুন।
মুছে ফেলা প্যানোরামা আইডিগুলি রিফ্রেশ করুন
যদি আপনি কোনো প্যানোরামা আইডি পুনরুদ্ধার করার চেষ্টা করেন এবং ZERO_RESULTS বা কোনো মান না পান, তাহলে প্যানোরামা আইডিটি মুছে ফেলা হয়েছে এবং এটিকে রিফ্রেশ করতে হবে।
প্যানোরামা আইডি পেতে ব্যবহৃত অবস্থানের ঠিকানা অথবা অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক সংরক্ষণ করুন, যাতে প্রয়োজনে তা রিফ্রেশ করতে পারেন।
যখন আপনি দেখবেন যে একটি প্যানোরামা আইডি পরিবর্তিত হয়েছে, তখন মূল অবস্থানের ঠিকানা অথবা অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক ব্যবহার করে সেই অবস্থানের নিকটতম প্যানোরামাগুলো পুনরায় অনুসন্ধান করুন এবং একটি নতুন প্যানোরামা আইডি সংগ্রহ করুন।
ঐচ্ছিক পরামিতি
-
signature( প্রস্তাবিত ) হলো একটি ডিজিটাল স্বাক্ষর যা যাচাই করতে ব্যবহৃত হয় যে, আপনার এপিআই কী ব্যবহার করে অনুরোধ তৈরি করা যেকোনো সাইট তা করার জন্য অনুমোদিত। যে অনুরোধগুলিতে ডিজিটাল স্বাক্ষর অন্তর্ভুক্ত থাকে না, সেগুলি ব্যর্থ হতে পারে। আরও তথ্যের জন্য, ‘একটি কী এবং স্বাক্ষর পান ’ দেখুন।দ্রষ্টব্য: গুগল ম্যাপস প্ল্যাটফর্ম প্রিমিয়াম প্ল্যানের প্রাক্তন গ্রাহকদের জন্য ডিজিটাল স্বাক্ষর প্রয়োজন । প্রিমিয়াম প্ল্যান গ্রাহকদের জন্য প্রমাণীকরণ প্যারামিটার সম্পর্কে আরও তথ্য জানুন।
-
headingক্যামেরার কম্পাস দিক নির্দেশ করে। এর গ্রহণযোগ্য মান হলো0থেকে360(উভয় মানই উত্তর,90পূর্ব এবং180দক্ষিণ নির্দেশ করে)। আপনি যদি কোনো হেডিং নির্দিষ্ট না করেন, তবে সবচেয়ে কাছের ছবিটি যে বিন্দু থেকে তোলা হয়েছিল, সেখান থেকে একটি মান গণনা করে ক্যামেরাটিকে নির্দিষ্টlocationদিকে পরিচালিত করা হয়। -
fov( ডিফল্ট90) ছবির আনুভূমিক দৃশ্যক্ষেত্র নির্ধারণ করে, যা ডিগ্রিতে প্রকাশ করা হয় এবং এর সর্বোচ্চ অনুমোদিত মান120যখন একটি নির্দিষ্ট আকারের ভিউপোর্ট নিয়ে কাজ করা হয়, যেমন একটি নির্দিষ্ট আকারের স্ট্রিট ভিউ ছবির ক্ষেত্রে, তখন দৃশ্যক্ষেত্র মূলত জুমকে বোঝায়, যেখানে ছোট সংখ্যাগুলো উচ্চতর জুমের মাত্রা নির্দেশ করে।
(বাম:fov=120; ডান:fov=20) -
pitch( ডিফল্ট0) স্ট্রিট ভিউ গাড়ির সাপেক্ষে ক্যামেরার ওপর বা নিচের কোণ নির্দিষ্ট করে। এটি প্রায়শই, তবে সবসময় নয়, সমতল অনুভূমিক হয়। ধনাত্মক মান ক্যামেরাকে ওপরের দিকে কোণ করে (90ডিগ্রি সোজা ওপরে বোঝায়); ঋণাত্মক মান ক্যামেরাকে নিচের দিকে কোণ করে (-90সোজা নিচে বোঝায়)। -
radius( ডিফল্ট50) প্রদত্ত অক্ষাংশ এবং দ্রাঘিমাংশকে কেন্দ্র করে একটি প্যানোরামা অনুসন্ধানের জন্য মিটারে একটি ব্যাসার্ধ নির্ধারণ করে। বৈধ মানগুলি হল অঋণাত্মক পূর্ণসংখ্যা। -
return_error_codeনির্দেশ করে যে, কোনো ছবি খুঁজে না পেলে (404 NOT FOUND) অথবা একটি অবৈধ অনুরোধের জবাবে (400 BAD REQUEST) API-টি একটি এরর কোড ফেরত দেবে কিনা। এর বৈধ মান হলোtrueএবংfalse। যদি এটিকেtrueসেট করা হয়, তাহলে সাধারণ ধূসর ছবির পরিবর্তে একটি এরর মেসেজ ফেরত দেওয়া হয়। এর ফলে ছবির প্রাপ্যতা যাচাই করার জন্য আলাদাভাবে কল করার প্রয়োজন হয় না। -
source( ডিফল্ট হলোdefault) স্ট্রিট ভিউ অনুসন্ধানকে নির্বাচিত উৎসগুলিতে সীমাবদ্ধ করে। বৈধ মানগুলি হলো:-
defaultস্ট্রিট ভিউ-এর জন্য পূর্বনির্ধারিত উৎসগুলো ব্যবহৃত হয়; অনুসন্ধান কোনো নির্দিষ্ট উৎসের মধ্যে সীমাবদ্ধ নয়। -
outdoorঅনুসন্ধানকে শুধুমাত্র বাইরের সংগ্রহগুলিতে সীমাবদ্ধ করে। ভেতরের সংগ্রহগুলি অনুসন্ধানের ফলাফলে অন্তর্ভুক্ত করা হয় না। মনে রাখবেন যে নির্দিষ্ট অবস্থানের জন্য বাইরের প্যানোরামা নাও থাকতে পারে। আরও মনে রাখবেন যে, অনুসন্ধানটি শুধুমাত্র সেই প্যানোরামাগুলিই দেখায় যেগুলি ভেতরের নাকি বাইরের, তা নির্ধারণ করা সম্ভব। উদাহরণস্বরূপ, ফটোস্ফিয়ারগুলি দেখানো হয় না, কারণ সেগুলি ভেতরের নাকি বাইরের, তা অজানা।
-
এটি একটি নমুনা অনুরোধ।
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
কোন ছবি উপলব্ধ নেই
যেসব স্থানে স্ট্রিট ভিউ চিত্রাবলী উপলব্ধ নেই, সেখানে স্ট্রিট ভিউ স্ট্যাটিক এপিআই একটি ধূসর সাধারণ চিত্র ফেরত দেয়, সাথে লেখা থাকে "দুঃখিত, এখানে আমাদের কোনো চিত্রাবলী নেই।", যেমনটি এই উদাহরণে দেখানো হয়েছে:
শুধুমাত্র বৈধ ছবিগুলো দেখান
সাধারণ ছবিটি প্রদর্শন করা এড়াতে এবং আপনার ওয়েব পেজে শুধুমাত্র বৈধ স্ট্রিট ভিউ স্ট্যাটিক এপিআই (Street View Static API) ছবি প্রদর্শিত হয় তা নিশ্চিত করতে, এই পরামর্শগুলো অনুসরণ করুন:
-
return_error_codeপ্যারামিটারটিtrueতে সেট করুন। এর ফলে, নির্দিষ্ট অবস্থানের জন্য কোনো ছবি উপলব্ধ না থাকলে, স্ট্রিট ভিউ স্ট্যাটিক এপিআই সাধারণ ধূসর ছবির পরিবর্তে একটি `404 NOT FOUND` ত্রুটি ফেরত দেবে। - অনুরোধ পাঠানোর আগে, নির্দিষ্ট অবস্থানের জন্য কোনো চিত্র উপলব্ধ আছে কিনা তা নির্ধারণ করতে স্ট্রিট ভিউ চিত্রের মেটাডেটা অনুরোধ করুন।