একটি ভিডিওর মেটাডেটা পুনরুদ্ধার করুন৷

একটি বৈধ ঠিকানা বা ভিডিওআইডি দেওয়া হলে, lookupVideoMetadata পদ্ধতি একটি প্রদত্ত ভিডিওর সাথে যুক্ত মেটাডেটা প্রদান করে। প্রতিক্রিয়া বডিতে থাকা মেটাডেটা আপনাকে চিত্রের সতেজতা, ভিডিওর দৈর্ঘ্য নির্ধারণ করতে দেয় এবং ভিডিওগুলির অস্তিত্ব নিশ্চিত করার জন্য একটি বিনামূল্যের কর্মপ্রবাহও প্রদান করে৷

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

একটি ইউআরএল-এনকোডেড ইউএস পোস্টাল ঠিকানা বা একটি videoId পাস করে এই এন্ডপয়েন্টটিকে কল করুন।

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS"

API তারপর নিম্নলিখিত দুটি প্রতিক্রিয়াগুলির মধ্যে একটি প্রদান করে:

  • ভিডিওটি বিদ্যমান থাকলে, lookupVideoMetadata ভিডিও মেটাডেটা ভিডিওর মেটাডেটা ফেরত দেয়।
  • ভিডিওটি বিদ্যমান না থাকলে, API একটি 404 ত্রুটি কোড প্রদান করে।

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

নিম্নলিখিত কোড নমুনা 600 Montgomery St, San Francisco, CA 94111-এ অবস্থিত ট্রান্সামেরিকা পিরামিডের জন্য একটি বায়বীয় দৃশ্য ভিডিওর অনুরোধ করে৷

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"

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

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

ভিডিও পাওয়া গেছে

ভিডিওটি ইতিমধ্যে রেন্ডার করা হয়েছে।

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "captureDate": {
    "year": 2022,
    "month": 4,
    "day": 1
  },
  "duration": "40s",
  "state": "ACTIVE"
}

ভিডিও রেন্ডার হচ্ছে

ভিডিওটি রেন্ডার হচ্ছে।

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "state": "PROCESSING"
}

ভিডিও পাওয়া যায় না

ভিডিওটি Google এর ডাটাবেসে নেই। এটি হতে পারে কারণ এটি এখনও রেন্ডার করা হয়নি, বা অবস্থানটি এমন একটি এলাকায় যা সমর্থিত নয়৷

যদি অবস্থানটি একটি সমর্থিত এলাকায় হয়, আপনি একটি রেন্ডার অনুরোধ শুরু করতে renderVideo ব্যবহার করতে পারেন৷

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}