मान्य पता या 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"
}
}