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