Street View ছবির মেটাডেটা

ভূমিকা

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

Street View Static API মেটাডেটা সংক্রান্ত অনুরোধ কোনও চার্জ ছাড়াই উপলভ্য। আপনি মেটাডেটার জন্য অনুরোধ করলে কোনও কোটা ব্যবহার করা হয় না। Street View Static API ব্যবহার করে আপনি কোনও ছবি লোড করলে তবেই কোটা খরচ হয়।

Street View ছবির মেটাডেটার জন্য অনুরোধ করার সময়, প্যানোরামা ছবি ৫০ মিটার পর্যন্ত সঠিক হয়।

ছবির মেটাডেটা অ্যাক্সেস করা

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

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

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

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

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

আরও তথ্য

Street View Static API বা অন্যান্য Google Maps API প্রোডাক্ট ব্যবহার করার ব্যাপারে আরও জানতে, Maps API সহায়তা পৃষ্ঠা চেক করতে ভুলবেন না।