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

मान्य पता या वीडियो आईडी दिए जाने पर, 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"
  }
}