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

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

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

একটি URL-এনকোডেড মার্কিন ডাক ঠিকানা অথবা একটি videoId পাস করে এই এন্ডপয়েন্টটি কল করুন।

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

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

• ভিডিওটি বিদ্যমান থাকলে, lookupVideoMetadata ভিডিওটির মেটাডেটা ফেরত দেয়।
• ভিডিওটি বিদ্যমান না থাকলে, এপিআই একটি ৪০৪ এরর কোড ফেরত দেয়।

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

নিম্নলিখিত কোড নমুনাটি ৬০০ মন্টগোমারি স্ট্রিট, সান ফ্রান্সিসকো, সিএ ৯৪১১১-এ অবস্থিত ট্রান্সআমেরিকা পিরামিডের একটি আকাশ থেকে তোলা ভিডিওর অনুরোধ করে।

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

ভিডিওটি খুঁজে পাওয়া যায়নি

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

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

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