কিভাবে এরিয়াল ভিউ API ব্যবহার করবেন

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

ভিডিও তৈরি বা পুনরুদ্ধার করার কর্মপ্রবাহ

আকাশ থেকে তোলা ভিডিও তৈরি বা সংগ্রহ করতে নিম্নলিখিত কার্যপ্রবাহটি ব্যবহার করুন:

1. lookupVideoMetadata ব্যবহার করে যাচাই করুন যে Google ওই অবস্থানের জন্য আগে থেকেই কোনো ভিডিও তৈরি করেছে কিনা।
2. যদি কোনো ভিডিও না থাকে ( lookupVideoMetadata একটি 404 রিটার্ন করলে), তাহলে একটি নতুন ভিডিও তৈরি করতে renderVideo কল করুন।
   1. ভিডিওটির অবস্থা ACTIVE না হওয়া পর্যন্ত এন্ডপয়েন্টটি পোল করতে videoId বা address ব্যবহার করে lookupVideoMetadata কল করুন। রেন্ডারিং-এ কয়েক ঘন্টা সময় লাগতে পারে, তাই আপনার কলগুলোর মধ্যে ব্যবধান রাখতে এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করুন।

3. যদি ভিডিওটি সক্রিয় থাকে ( lookupVideoMetadata এর অবস্থা ACTIVE পাওয়া যায়), তাহলে ভিডিওটির URI-গুলো আনার জন্য lookupVideo কল করুন।

   দ্রষ্টব্য: গুগল কোনো নির্দিষ্ট ঠিকানার জন্য ভিডিও তৈরি করার পর, সেই ভিডিওটি যে কেউ দেখতে পারে। অর্থাৎ, একটি ভিডিও কোনো নির্দিষ্ট ব্যবহারকারী বা অ্যাকাউন্টের সঙ্গে যুক্ত থাকে না।

এই কার্যপ্রবাহটি নিচের ডায়াগ্রামে দেখানো হয়েছে:

পরবর্তীতে ব্যবহারের জন্য ভিডিও আইডিগুলো সংরক্ষণ করুন।

এরিয়াল ভিউ এপিআই-এর পরিষেবা-নির্দিষ্ট শর্তাবলী সাপেক্ষে, এরিয়াল ভিউ এপিআই ভিডিও আইডিগুলি গুগল ম্যাপস প্ল্যাটফর্ম পরিষেবার শর্তাবলীর ধারা ৩.২.৩(খ) (কোনো ক্যাশিং নয়) -এ উল্লিখিত ক্যাশিং সীমাবদ্ধতা থেকে অব্যাহতিপ্রাপ্ত । অতএব, আপনি পরবর্তী ব্যবহারের জন্য ভিডিও আইডির মান সংরক্ষণ করতে পারেন।