রাস্তার দৃশ্য চিত্র মেটাডেটা

ভূমিকা

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

দ্রষ্টব্য: তারিখ ক্ষেত্রের মান পরিবর্তিত হতে পারে:

• বিভিন্ন প্যানোরামার জন্য তারিখ ক্ষেত্রের গ্রানুলারিটি ভিন্ন হতে পারে। উদাহরণস্বরূপ, কিছু প্যানোরামার জন্য তারিখ ক্ষেত্রের মধ্যে একটি বছর এবং মাস থাকে, আবার অন্যদের জন্য এটি কেবল বছর ধারণ করে।
• যদি কোন তথ্য উপলব্ধ না থাকে তাহলে তারিখ ক্ষেত্রটি বাদ দেওয়া হবে।

স্ট্রিট ভিউ স্ট্যাটিক API মেটাডেটা অনুরোধগুলি বিনামূল্যে পাওয়া যায়। মেটাডেটা অনুরোধ করার সময় কোনও কোটা খরচ হয় না। স্ট্রিট ভিউ স্ট্যাটিক API ব্যবহার করে কোনও ছবি লোড করার সময় কেবল কোটা খরচ হয় ।

স্ট্রিট ভিউ ইমেজারি মেটাডেটা অনুরোধ করার সময়, প্যানোরামা ইমেজারি ৫০ মিটার পর্যন্ত নির্ভুল থাকে।

চিত্রাবলীর মেটাডেটা অ্যাক্সেস করুন

একটি স্ট্রিট ভিউ ছবির মেটাডেটা অনুরোধ হল নিম্নলিখিত ফর্মের একটি HTTP URL:

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

দ্রষ্টব্য : মেটাডেটা অনুরোধের জন্য https:// প্রোটোকল প্রয়োজন।

URL গুলিতে যেমন স্ট্যান্ডার্ড আছে, সমস্ত প্যারামিটার অ্যাম্পারস্যান্ড (&) অক্ষর ব্যবহার করে পৃথক করা হয়।

মেটাডেটা অনুরোধের জন্য প্রয়োজনীয় প্যারামিটার

মেটাডেটা অনুরোধগুলি স্ট্রিট ভিউ স্ট্যাটিক এপিআই ইমেজরি অনুরোধের মতো একই URL প্যারামিটার গ্রহণ করে, যদিও শুধুমাত্র নিম্নলিখিত প্যারামিটারগুলি প্রয়োজন:

যেকোনো একটি:

• location — হয় একটি টেক্সট স্ট্রিং (যেমন Chagrin Falls, OH ) অথবা কমা দ্বারা পৃথক করা অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্কের জোড়া ( 40.457375,-80.009353 ) হতে পারে।

অথবা:

• pano — একটি নির্দিষ্ট প্যানোরামা আইডি। প্যানোরামাগুলি সময়ের সাথে সাথে আইডি পরিবর্তন করতে পারে, তাই এই আইডিটি ধরে রাখবেন না। পরিবর্তে, অবস্থান ঠিকানা বা অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক সংরক্ষণ করুন যাতে আপনি প্যানোরামা আইডি রিফ্রেশ করতে পারেন। বিস্তারিত জানার জন্য, মুছে ফেলা প্যানোরামা আইডি রিফ্রেশ দেখুন।

পাশাপাশি:

• key এবং signature — অনুরোধটি প্রমাণীকরণের জন্য API কী প্রয়োজন। কিছু ক্ষেত্রে ডিজিটাল স্বাক্ষরও প্রয়োজন, এবং সর্বদা সুপারিশ করা হয়। আরও তথ্যের জন্য, একটি কী এবং স্বাক্ষর পান দেখুন।

আপনার মেটাডেটা অনুরোধ, শুধুমাত্র প্রয়োজনীয় প্যারামিটার সহ, এইরকম দেখাচ্ছে:

https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

অথবা এইরকম:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

মুছে ফেলা প্যানোরামা আইডি রিফ্রেশ করুন

যদি আপনি একটি প্যানোরামা আইডি পুনরুদ্ধার করার চেষ্টা করেন এবং হয় ZERO_RESULTS অথবা কোনও মান পান না, তাহলে প্যানোরামা আইডিটি মুছে ফেলা হয়েছে এবং রিফ্রেশ করতে হবে।

1. প্যানোরামা আইডি পেতে আপনার ব্যবহৃত অবস্থান ঠিকানা বা অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক সংরক্ষণ করুন যাতে প্রয়োজনে আপনি রিফ্রেশ করতে পারেন।

2. যখন আপনি শনাক্ত করেন যে একটি প্যানোরামা আইডি পরিবর্তিত হয়েছে, তখন সেই অবস্থানের নিকটতম প্যানোরামাগুলি আবার অনুসন্ধান করতে মূল অবস্থান ঠিকানা বা অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করুন এবং একটি নতুন প্যানোরামা আইডি পান।

দ্রষ্টব্য: যেহেতু রাস্তার দৃশ্যের ছবি পর্যায়ক্রমে আপডেট করা হয় এবং প্রতিবার সামান্য ভিন্ন অবস্থান থেকে ছবি তোলা যেতে পারে, তাই ছবি বা প্যানোরামা আইডি আপডেট করা হলে একটি নির্দিষ্ট প্যানোরামা আইডি ভিন্ন প্যানোরামায় স্ন্যাপ করতে পারে।

মেটাডেটা অনুরোধের জন্য ঐচ্ছিক পরামিতি

আপনার মেটাডেটা অনুরোধে আপনি নিম্নলিখিত প্যারামিটারগুলি অন্তর্ভুক্ত করতে পারেন: size , heading , fov এবং pitch । মনে রাখবেন যে এই প্যারামিটারগুলি প্যানোরামা সম্পর্কিত ডেটা বা কোন প্যানোরামা পাওয়া যাবে তা প্রভাবিত করে না। API চিত্র অনুরোধের মতো একই প্যারামিটারগুলি অন্তর্ভুক্ত করার অনুমতি দেয় যাতে একটি নির্দিষ্ট চিত্র অনুরোধের সাথে সম্পর্কিত মেটাডেটা অনুরোধ তৈরি করা সহজ হয়, তবে মেটাডেটা অনুরোধের জন্য, API ঐচ্ছিক প্যারামিটার এবং তাদের মানগুলি উপেক্ষা করে। এই প্যারামিটারগুলি ব্যবহার সম্পর্কে তথ্যের জন্য, স্ট্রিট ভিউ স্ট্যাটিক API ডেভেলপারের নির্দেশিকা দেখুন।

প্রতিক্রিয়া বিন্যাস

মেটাডেটা প্রতিক্রিয়াগুলি শুধুমাত্র JSON ফর্ম্যাটে ফেরত পাঠানো হয়।

উদাহরণ

উদাহরণ ১: প্যানোরামা পাওয়া গেছে

নিম্নলিখিত URL গুলি সফলভাবে একই প্যানোরামার মেটাডেটা এবং চিত্রের অনুরোধ করেছে।

মেটাডেটা অনুরোধ এবং প্রতিক্রিয়া

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

চিত্রের অনুরোধ এবং প্রতিক্রিয়া, যেখানে অনুপস্থিত চিত্রটি প্রত্যাশিত।

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

উদাহরণ ২: প্যানোরামা পাওয়া যায়নি

নিম্নলিখিত URL গুলি এমন একটি প্যানোরামার জন্য মেটাডেটা এবং চিত্রের অনুরোধ করে যা নির্দিষ্ট স্থানে বা তার কাছাকাছি পাওয়া যায়নি।

মেটাডেটা অনুরোধ এবং প্রতিক্রিয়া

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "status" : "ZERO_RESULTS"
}

চিত্রের অনুরোধ এবং প্রতিক্রিয়া

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

স্ট্যাটাস কোড

মেটাডেটা রেসপন্স অবজেক্টের মধ্যে থাকা status ফিল্ডে অনুরোধের স্ট্যাটাস থাকে এবং এতে ডিবাগিং তথ্য থাকতে পারে যা আপনাকে রাস্তার দৃশ্যের অনুরোধ কেন কাজ করছে না তা সমস্যা সমাধানে সাহায্য করবে। status ফিল্ডে নিম্নলিখিত মান থাকতে পারে:

অবস্থা	বিবরণ
"OK"	কোনও ত্রুটি ঘটেনি তা নির্দেশ করে; একটি প্যানোরামা পাওয়া যায় এবং মেটাডেটা ফেরত পাঠানো হয়।
"ZERO_RESULTS"	নির্দেশ করে যে প্রদত্ত অবস্থানের কাছাকাছি কোনও প্যানোরামা খুঁজে পাওয়া যায়নি। আপনি যদি একটি অস্তিত্বহীন বা অবৈধ প্যানোরামা আইডি প্রদান করেন তবে এই প্রতিক্রিয়া ঘটতে পারে। [রিফ্রেশ করুন মুছে ফেলা প্যানোরামা আইডি](#refresh-pano) দেখুন।
"NOT_FOUND"	নির্দেশ করে যে location প্যারামিটারে প্রদত্ত ঠিকানা স্ট্রিংটি খুঁজে পাওয়া যায়নি। যদি একটি অস্তিত্বহীন ঠিকানা দেওয়া হয় তবে এই বার্তাটি আসতে পারে।
"OVER_QUERY_LIMIT"	ইঙ্গিত করে যে আপনি এই API-এর জন্য আপনার দৈনিক কোটা বা প্রতি-সেকেন্ড কোটা অতিক্রম করেছেন।
"REQUEST_DENIED"	আপনার অনুরোধ প্রত্যাখ্যান করা হয়েছে তা নির্দেশ করে। আপনি যদি আপনার অনুরোধ অনুমোদন না করেন, অথবা আপনার API কী ধারণকারী Google Cloud কনসোল প্রকল্পে Street View Static API সক্রিয় না থাকে তবে এই বার্তাটি আসতে পারে।
"INVALID_REQUEST"	সাধারণত ইঙ্গিত করে যে কোয়েরি প্যারামিটারগুলি (ঠিকানা, অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক, বা উপাদানগুলি) অনুপস্থিত।
"UNKNOWN_ERROR"	এর অর্থ হল সার্ভারের ত্রুটির কারণে অনুরোধটি প্রক্রিয়া করা যায়নি। এই সমস্যাটি প্রায়শই অস্থায়ী হয়। আবার চেষ্টা করলে অনুরোধটি সফল হতে পারে।

অধিক তথ্য

স্ট্রিট ভিউ স্ট্যাটিক এপিআই, অথবা অন্যান্য গুগল ম্যাপস এপিআই পণ্য ব্যবহার সম্পর্কে আরও তথ্যের জন্য, ম্যাপস এপিআই সাপোর্ট পৃষ্ঠাটি দেখতে ভুলবেন না।