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

ভূমিকা

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

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

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

স্ট্রিট ভিউ স্ট্যাটিক এপিআই মেটাডেটা অনুরোধ বিনামূল্যে করা যায়। মেটাডেটা অনুরোধ করার সময় কোনো কোটা খরচ হয় না। শুধুমাত্র স্ট্রিট ভিউ স্ট্যাটিক এপিআই ব্যবহার করে কোনো ছবি লোড করার সময়ই কোটা খরচ হয় ।

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

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

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

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

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

ইউআরএল-এর প্রচলিত রীতি অনুযায়ী, সমস্ত প্যারামিটার অ্যামপারস্যান্ড (&) চিহ্ন ব্যবহার করে আলাদা করা হয়।

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

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

হয়:

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

অথবা:

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

পাশাপাশি:

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

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

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 । মনে রাখবেন যে এই প্যারামিটারগুলো প্যানোরামা সম্পর্কিত ডেটা বা কোন প্যানোরামাটি পাওয়া যাবে তার উপর কোনো প্রভাব ফেলে না। একটি নির্দিষ্ট ইমেজেরি অনুরোধ সম্পর্কিত মেটাডেটা অনুরোধ তৈরি করা সহজ করার জন্য এপিআই ইমেজেরি অনুরোধের মতোই একই প্যারামিটার অন্তর্ভুক্ত করার অনুমতি দেয়, কিন্তু মেটাডেটা অনুরোধের ক্ষেত্রে এপিআই ঐচ্ছিক প্যারামিটার এবং তাদের মান উপেক্ষা করে। এই প্যারামিটারগুলো ব্যবহার করার বিষয়ে তথ্যের জন্য, স্ট্রিট ভিউ স্ট্যাটিক এপিআই ডেভেলপারস গাইড দেখুন।

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

মেটাডেটা প্রতিক্রিয়া শুধুমাত্র JSON ফরম্যাটে ফেরত দেওয়া হয়।

উদাহরণ

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

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

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

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"	এটি নির্দেশ করে যে আপনি এই এপিআই-এর জন্য আপনার দৈনিক কোটা বা প্রতি-সেকেন্ড কোটা অতিক্রম করেছেন।
"REQUEST_DENIED"	এটি নির্দেশ করে যে আপনার অনুরোধটি প্রত্যাখ্যান করা হয়েছে। এই বার্তাটি দেখা যেতে পারে যদি আপনি আপনার অনুরোধটি অনুমোদন না করে থাকেন, অথবা যদি আপনার এপিআই কী (API key) থাকা গুগল ক্লাউড কনসোল প্রজেক্টে স্ট্রিট ভিউ স্ট্যাটিক এপিআই (Street View Static API) সক্রিয় করা না থাকে।
"INVALID_REQUEST"	সাধারণত এটি নির্দেশ করে যে কোয়েরি প্যারামিটারগুলো (ঠিকানা, অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক বা এর উপাদানগুলো) অনুপস্থিত।
"UNKNOWN_ERROR"	এটি নির্দেশ করে যে সার্ভার ত্রুটির কারণে অনুরোধটি প্রক্রিয়া করা যায়নি। এই সমস্যাটি প্রায়শই অস্থায়ী। পুনরায় চেষ্টা করলে অনুরোধটি সফল হতে পারে।

আরও তথ্য

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