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

कोई मान्य पता या वीडियो आईडी देने पर, the lookupVideoMetadata तरीका, दिए गए वीडियो से जुड़ा मेटाडेटा दिखाता है. जवाब के मुख्य हिस्से में मौजूद मेटाडेटा से, आपको इमेज की नई जानकारी, वीडियो की अवधि के बारे में पता चलता है. साथ ही, वीडियो के मौजूद होने की पुष्टि करने के लिए, एक मुफ़्त वर्कफ़्लो भी मिलता है.

एपीआई का इस्तेमाल कैसे करें

इस एंडपॉइंट को कॉल करने के लिए, इसे यूआरएल के तौर पर कोड में बदला गया अमेरिका का पोस्टल पता या videoId पास करें.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?X-Goog-Api-Key=YOUR_API_KEY&address=POSTAL_ADDRESS"

इसके बाद, एपीआई इनमें से कोई एक जवाब देता है:

• अगर वीडियो मौजूद है, तो lookupVideoMetadata वीडियो का मेटाडेटा दिखाता है.
• अगर वीडियो मौजूद नहीं है, तो एपीआई 404 गड़बड़ी कोड दिखाता है.

अनुरोध का उदाहरण

कोड के इस उदाहरण में, सैन फ़्रांसिस्को, CA 94111 में 600 मोंटगोमरी स्ट्रीट पर मौजूद ट्रांसअमेरिका पिरामिड का एरियल व्यू वीडियो का अनुरोध किया गया है.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?X-Goog-Api-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"
  }
}