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

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

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

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

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"
  }
}

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

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

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

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

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

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

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

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