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

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

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

একটি বায়বীয় দৃশ্য ভিডিও তৈরি বা পুনরুদ্ধার করতে নিম্নলিখিত কর্মপ্রবাহ ব্যবহার করুন:

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

এই কর্মপ্রবাহটি নীচের চিত্রে উপস্থাপন করা হয়েছে:

উপরে বর্ণিত কর্মপ্রবাহ প্রদর্শনকারী চার্ট

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

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