একটি নতুন ভিডিও তৈরি করুন

renderVideo পদ্ধতিটি নির্দিষ্ট মার্কিন ডাক ঠিকানার জন্য একটি এরিয়াল ভিউ ভিডিও তৈরির অনুরোধ করে। যদি নির্দিষ্ট ঠিকানার জন্য ভিডিওটি ইতিমধ্যেই বিদ্যমান থাকে, তাহলে এই পদ্ধতিটি ভিডিও সম্পর্কে মেটাডেটা ফেরত দেয়।

API কীভাবে ব্যবহার করবেন

নিম্নলিখিত উদাহরণে দেখানো হয়েছে, renderVideo এন্ডপয়েন্টে একটি HTTPS POST অনুরোধ করে, আপনার API কী এবং একটি মার্কিন ডাক ঠিকানা পাস করে একটি নতুন এরিয়াল ভিডিও তৈরি করুন। রেন্ডারিং প্রক্রিয়াটি এক ঘন্টা থেকে কয়েক ঘন্টা পর্যন্ত সময় নিতে পারে।

curl -X POST -d '{
  "address": "POSTAL_ADDRESS"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

উদাহরণ অনুরোধ

নিম্নলিখিত কোড উদাহরণটি 500 W 2nd St, Austin, TX, 78701 এর জন্য একটি এরিয়াল ভিউ ভিডিও তৈরির অনুরোধ করে।

curl -X POST -d '{
  "address": "500 W 2nd St, Austin, TX 78701"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

উদাহরণ প্রতিক্রিয়া

নিম্নলিখিত JSON কোড নমুনাগুলি উদাহরণ ভিডিও অনুরোধের সম্ভাব্য প্রতিক্রিয়াগুলি দেখায়।

ঠিকানার উত্তরটি অবৈধ

ঠিকানাটি হয় ভুল, অথবা এটি মার্কিন যুক্তরাষ্ট্রের মধ্যে নয়।

{
  "error": {
    "code": 400,
    "message": "Address not supported.",
    "status": "INVALID_ARGUMENT"
  }
}

প্রতিক্রিয়া প্রক্রিয়াকরণ

Aerial View API এখন আপনার ভিডিও রেন্ডার করছে। প্রতিক্রিয়াটিতে videoId রয়েছে, যা আপনি ভিডিওটি পুনরুদ্ধার করতে ব্যবহার করতে পারেন।

{
  "state": "PROCESSING",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}

রেন্ডারিং প্রক্রিয়াটি এক ঘন্টা থেকে কয়েক ঘন্টা পর্যন্ত সময় নিতে পারে। যদি ভিডিওটি এখনও প্রক্রিয়াকরণের সময় থাকে, তাহলে আপনি lookupVideo ব্যবহার করে ভিডিওর অবস্থা পরীক্ষা করতে পারেন যতক্ষণ না এটি ACTIVE অবস্থায় ফিরে আসে।

পোল করার জন্য, videoId পাশ করে lookupVideo এর জন্য অনুরোধ করুন। রেন্ডারিং করতে বেশ কয়েক ঘন্টা সময় লাগতে পারে, তাই আপনার কলগুলি ফাঁকা করার জন্য সূচকীয় ব্যাকঅফ ব্যবহার করুন।

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

যখন renderVideo ACTIVE এর একটি state মান প্রদান করে, তখন এর অর্থ হল ভিডিওটি রেন্ডারিং সম্পন্ন হয়েছে, এবং আপনি videoId ব্যবহার করে lookupVideo কল করে এটি পুনরুদ্ধার করতে পারেন।

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}