मान्य पते या videoID होने पर, 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"
}
}