मान्य पते या वीडियो आईडी के लिए, lookupVideoMetadata
तरीका, किसी वीडियो से जुड़ा मेटाडेटा दिखाता है. रिस्पॉन्स बॉडी में मौजूद मेटाडेटा की मदद से, यह पता लगाया जा सकता है कि इमेज कितनी नई है और वीडियो की अवधि कितनी है. साथ ही, वीडियो मौजूद है या नहीं, इसकी पुष्टि करने के लिए भी एक मुफ़्त वर्कफ़्लो मिलता है.
एपीआई का इस्तेमाल कैसे करें
इस एंडपॉइंट को कॉल करने के लिए, अमेरिका के यूआरएल में कोड में बदले गए पिन कोड या videoId
को पास करें.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS "
इसके बाद, एपीआई इनमें से कोई एक जवाब दिखाता है:
- अगर वीडियो मौजूद है, तो
lookupVideoMetadata
वीडियो का मेटाडेटा दिखाता है. - अगर वीडियो मौजूद नहीं है, तो एपीआई 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"
}
वीडियो नहीं मिला
वीडियो, Google के डेटाबेस में मौजूद नहीं है. ऐसा इसलिए हो सकता है, क्योंकि इसे अब तक रेंडर नहीं किया गया है या जगह ऐसी है जहां यह सुविधा काम नहीं करती.
अगर आपका कारोबार ऐसे इलाके में है जहां यह सुविधा उपलब्ध है, तो रेंडर करने का अनुरोध करने के लिए, renderVideo
का इस्तेमाल करें.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}