किसी वीडियो का मेटाडेटा वापस पाना

मान्य पता या वीडियो आईडी दिए जाने पर, lookupVideoMetadata तरीके से किसी वीडियो से जुड़ा मेटाडेटा मिलता है. जवाब के मुख्य हिस्से में मौजूद मेटाडेटा से, आपको इमेज के अपडेट होने की जानकारी, वीडियो की अवधि, और वीडियो के मौजूद होने की पुष्टि करने के लिए बिना किसी शुल्क के वर्कफ़्लो मिलता है.

एपीआई का इस्तेमाल कैसे करें

इस एंडपॉइंट को कॉल करें. इसके लिए, अमेरिका के डाक पते को यूआरएल-कोड में बदलें या videoId का इस्तेमाल करें.

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

इसके बाद, एपीआई इनमें से कोई एक जवाब देता है:

• अगर वीडियो मौजूद है, तो lookupVideoMetadata फ़ंक्शन वीडियो का मेटाडेटा दिखाता है.
• अगर वीडियो मौजूद नहीं है, तो एपीआई 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"
  }
}