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