renderVideo
वाले तरीके से, अमेरिका के दिए गए पिन कोड वाले पते के लिए, हवाई से ली गई तस्वीरों वाला वीडियो जनरेट करने का अनुरोध किया जाता है. अगर दिए गए पते के लिए वीडियो पहले से मौजूद है, तो यह तरीका वीडियो का मेटाडेटा दिखाता है.
एपीआई का इस्तेमाल कैसे करें
renderVideo
एंडपॉइंट पर एचटीटीपीएस पोस्ट अनुरोध करके, नया एरियल वीडियो जनरेट करें. इसके लिए, अपनी एपीआई पासकोड और अमेरिका का डाक पता डालें, जैसा कि यहां दिए गए उदाहरण में दिखाया गया है. रेंडरिंग की प्रोसेस में एक घंटे से लेकर कुछ घंटे लग सकते हैं.
curl -X POST -d '{ "address": "POSTAL_ADDRESS" }' \ -H 'Content-Type: application/json' \ "https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
अनुरोध का उदाहरण
यहां दिए गए कोड के उदाहरण में, 500 W 2nd St, Austin, TX, 78701 के लिए, हवाई से ली गई तस्वीरों का वीडियो बनाने का अनुरोध किया गया है.
curl -X POST -d '{ "address": "500 W 2nd St, Austin, TX 78701" }' \ -H 'Content-Type: application/json' \ "https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
जवाब का उदाहरण
नीचे दिए गए JSON कोड के सैंपल, वीडियो के अनुरोध के उदाहरण के लिए संभावित जवाब दिखाते हैं.
अमान्य पता
पता गलत है या यह अमेरिका में नहीं है.
{
"error": {
"code": 400,
"message": "Address not supported.",
"status": "INVALID_ARGUMENT"
}
}
जवाब प्रोसेस किया जा रहा है
Aerial View API अब आपके वीडियो को रेंडर कर रहा है. इस जवाब में videoId
शामिल है. इसका इस्तेमाल, वीडियो वापस पाने के लिए किया जा सकता है.
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
रेंडरिंग की प्रोसेस में एक घंटे से लेकर कुछ घंटे भी लग सकते हैं. अगर वीडियो अब भी प्रोसेस हो रहा है, तो वीडियो के ACTIVE
की स्थिति वापस आने तक, उसकी स्थिति की पोल करने के लिए lookupVideo
का इस्तेमाल किया जा सकता है.
पोल बनाने के लिए, lookupVideo
को अनुरोध करें. साथ ही, videoId
को पास करें. रेंडरिंग में कई घंटे लग सकते हैं. इसलिए, कॉल के बीच में समय देने के लिए, एक्सपोनेंशियल बैकऑफ़ का इस्तेमाल करें.
ऐक्टिव रिस्पॉन्स
जब renderVideo
, ACTIVE
की state
वैल्यू दिखाता है, तो इसका मतलब है कि वीडियो का रेंडर होना पूरी हो गया है. इसे videoId
के साथ lookupVideo
को कॉल करके वापस पाया जा सकता है.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}