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

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

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

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

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

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

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

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

নিম্নলিখিত কোড নমুনাটি 600 মন্টগোমারি স্ট্রিট, সান ফ্রান্সিসকো, 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"
}

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

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

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

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