একটি রাস্তার দৃশ্য চিত্র অনুরোধ এই বিন্যাসে একটি 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" এ রূপান্তর করুন। রাস্তার দৃশ্য স্ট্যাটিক API অবস্থানের সবচেয়ে কাছের প্যানোরামা ফটোগ্রাফে স্ন্যাপ করে। আপনি যখন একটি ঠিকানা পাঠ্য স্ট্রিং প্রদান করেন, API নির্দিষ্ট অবস্থানটি আরও ভালভাবে প্রদর্শন করতে একটি ভিন্ন ক্যামেরা অবস্থান ব্যবহার করতে পারে। আপনি যখন অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক প্রদান করেন, তখন API অবস্থানের নিকটতম একটি ফটোগ্রাফের জন্য 50 মিটার ব্যাসার্ধ অনুসন্ধান করে। যেহেতু রাস্তার দৃশ্যের চিত্রগুলি পর্যায়ক্রমে রিফ্রেশ করা হয়, এবং প্রতিবার সামান্য ভিন্ন অবস্থান থেকে ফটোগ্রাফগুলি নেওয়া হতে পারে, এটি সম্ভব যে চিত্রগুলি আপডেট করা হলে আপনারlocationএকটি ভিন্ন প্যানোরামায় স্ন্যাপ করতে পারে৷
বা:
-
panoএকটি নির্দিষ্ট প্যানোরামা আইডি। প্যানোরামাগুলি সময়ের সাথে সাথে আইডি পরিবর্তন করতে পারে, তাই এই আইডিটি ধরে রাখবেন না৷ পরিবর্তে, অবস্থান ঠিকানা বা অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক সংরক্ষণ করুন যাতে আপনি প্যানোরামা আইডি রিফ্রেশ করতে পারেন। বিশদ বিবরণের জন্য, মুছে ফেলা প্যানোরামা আইডি রিফ্রেশ করুন দেখুন।
পাশাপাশি:
-
sizeপিক্সেলে ছবির আউটপুট আকার নির্দিষ্ট করে। আকার{width}x{height}হিসাবে নির্দিষ্ট করা হয়েছে - উদাহরণস্বরূপ,size=600x400একটি ছবি 600 পিক্সেল চওড়া, এবং 400 উচ্চতা দেয়৷ -
keyআপনাকে Google ক্লাউড কনসোলে আপনার অ্যাপ্লিকেশনের API ব্যবহার নিরীক্ষণ করতে দেয় এবং নিশ্চিত করে যে Google প্রয়োজনে আপনার অ্যাপ্লিকেশন সম্পর্কে আপনার সাথে যোগাযোগ করতে পারে। আরও তথ্যের জন্য, একটি কী এবং স্বাক্ষর পান দেখুন।
মুছে ফেলা প্যানোরামা আইডি রিফ্রেশ করুন
আপনি যদি একটি প্যানোরামা আইডি পুনরুদ্ধার করার চেষ্টা করেন এবং হয় ZERO_RESULTS বা কোনও মান না পান, তাহলে প্যানোরামা আইডিটি মুছে ফেলা হয়েছে এবং রিফ্রেশ করতে হবে৷
অবস্থান ঠিকানা বা অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্কগুলি সংরক্ষণ করুন যেগুলি আপনি একটি প্যানোরামা আইডি পেতে ব্যবহার করেছিলেন যাতে প্রয়োজনের সময় আপনি রিফ্রেশ করতে পারেন৷
যখন আপনি সনাক্ত করেন যে একটি প্যানোরামা আইডি পরিবর্তিত হয়েছে, তখন সেই অবস্থানের নিকটতম প্যানোরামাগুলির জন্য আবার অনুসন্ধান করতে আসল অবস্থান ঠিকানা বা অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করুন এবং একটি নতুন প্যানোরামা আইডি পান৷
ঐচ্ছিক পরামিতি
-
signature( প্রস্তাবিত ) হল একটি ডিজিটাল স্বাক্ষর যা আপনার API কী ব্যবহার করে যেকোন সাইট অনুরোধ তৈরি করে তা যাচাই করার জন্য ব্যবহৃত হয়। একটি ডিজিটাল স্বাক্ষর অন্তর্ভুক্ত নয় এমন অনুরোধগুলি ব্যর্থ হতে পারে৷ আরও তথ্যের জন্য, একটি কী এবং স্বাক্ষর পান দেখুন।দ্রষ্টব্য: প্রাক্তন Google মানচিত্র প্ল্যাটফর্ম প্রিমিয়াম প্ল্যান গ্রাহকদের জন্য, ডিজিটাল স্বাক্ষর প্রয়োজন ৷ প্রিমিয়াম প্ল্যান গ্রাহকদের জন্য প্রমাণীকরণ পরামিতি সম্পর্কে আরও তথ্য পান।
-
headingক্যামেরার কম্পাস শিরোনাম নির্দেশ করে। গৃহীত মানগুলি0থেকে360পর্যন্ত (উভয় মানই উত্তর নির্দেশ করে,90পূর্ব নির্দেশ করে এবং180দক্ষিণ)। যদি আপনি একটি শিরোনাম নির্দিষ্ট না করেন, তাহলে একটি মান গণনা করা হয় যা ক্যামেরাটিকে নির্দিষ্টlocationদিকে নির্দেশ করে, যে বিন্দু থেকে নিকটতম ছবি তোলা হয়েছিল। -
fov( ডিফল্ট হল90) ডিগ্রীতে প্রকাশিত চিত্রের অনুভূমিক ক্ষেত্র নির্ধারণ করে, যার সর্বোচ্চ অনুমোদিত মান120। একটি নির্দিষ্ট আকারের ভিউপোর্টের সাথে কাজ করার সময়, যেমন একটি সেট আকারের রাস্তার দৃশ্যের চিত্রের সাথে, সারমর্মে দৃশ্যের ক্ষেত্রটি জুমকে উপস্থাপন করে, ছোট সংখ্যাগুলি জুমের উচ্চ স্তরের নির্দেশ করে৷
(বাম:fov=120; ডান:fov=20) -
pitch( ডিফল্ট হল0) রাস্তার দৃশ্যের গাড়ির সাপেক্ষে ক্যামেরার উপরে বা নিচের কোণ নির্দিষ্ট করে। এটি প্রায়শই, তবে সর্বদা নয়, সমতল অনুভূমিক। ইতিবাচক মান ক্যামেরাকে উপরে কোণ করে (90ডিগ্রি সোজা উপরে নির্দেশ করে); নেতিবাচক মান ক্যামেরা নিচের কোণে (-90সোজা নিচে নির্দেশ করে)। -
radius( ডিফল্ট হল50) একটি ব্যাসার্ধ সেট করে, মিটারে নির্দিষ্ট করা হয়, যেখানে প্রদত্ত অক্ষাংশ এবং দ্রাঘিমাংশকে কেন্দ্র করে একটি প্যানোরামা অনুসন্ধান করতে হয়। বৈধ মান হল অ-নেতিবাচক পূর্ণসংখ্যা। -
return_error_codeনির্দেশ করে যে এপিআই একটি ত্রুটি কোড ফেরত দেবে কিনা যখন কোনো চিত্র পাওয়া যায় না (404 খুঁজে পাওয়া যায়নি), অথবা একটি অবৈধ অনুরোধের প্রতিক্রিয়া হিসাবে (400 খারাপ অনুরোধ)। বৈধ মান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
কোন চিত্র উপলব্ধ
রাস্তার দৃশ্যের ছবি উপলব্ধ নয় এমন অবস্থানগুলির জন্য, রাস্তার দৃশ্য স্ট্যাটিক API একটি ধূসর সাধারণ চিত্র প্রদান করে, যেখানে "দুঃখিত, আমাদের এখানে কোনো চিত্র নেই।" এই উদাহরণে দেখানো হয়েছে:
শুধুমাত্র বৈধ ছবি দেখান
জেনেরিক ছবি প্রদর্শন এড়াতে এবং নিশ্চিত করুন যে আপনার ওয়েব পৃষ্ঠা শুধুমাত্র বৈধ রাস্তার দৃশ্য স্ট্যাটিক API চিত্রগুলি প্রদর্শন করে, এই পরামর্শগুলি অনুসরণ করুন:
-
return_error_codeপ্যারামিটারটিকেtrueএ সেট করুন। এর ফলে স্ট্রিট ভিউ স্ট্যাটিক এপিআই সাধারণ ধূসর ছবির জায়গায় একটি 404 NOT FOUND ত্রুটি ফেরত দেয়, যদি নির্দিষ্ট অবস্থানের জন্য কোনো ছবি উপলব্ধ না হয়। - একটি অনুরোধ পাঠানোর আগে নির্দিষ্ট অবস্থানের জন্য চিত্র উপলব্ধ আছে কিনা তা নির্ধারণ করতে রাস্তার দৃশ্য চিত্রের মেটাডেটার অনুরোধ করুন৷