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

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

এপিআই কীভাবে ব্যবহার করবেন

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

curl -X POST -d '{
  "address": "POSTAL_ADDRESS"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?X-Goog-Api-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?X-Goog-Api-Key=YOUR_API_KEY"

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

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

অবৈধ ঠিকানা প্রতিক্রিয়া

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

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

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

এরিয়াল ভিউ এপিআই এখন আপনার ভিডিওটি রেন্ডার করছে। রেসপন্সটিতে videoId রয়েছে, যা ব্যবহার করে আপনি ভিডিওটি সংগ্রহ করতে পারবেন।

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

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

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

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

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

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