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

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