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

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

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

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

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

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

• अगर वीडियो मौजूद है, तो lookupVideoMetadata फ़ंक्शन वीडियो का मेटाडेटा दिखाता है.
• अगर वीडियो मौजूद नहीं है, तो एपीआई 404 गड़बड़ी कोड दिखाता है.

अनुरोध का उदाहरण

यहां दिए गए कोड के सैंपल में, Transamerica Pyramid का हवाई नज़ारा दिखाने वाले वीडियो का अनुरोध किया गया है. यह इमारत 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"
  }
}