कॉन्टेंट बनाने
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, ऑस्टिन, 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"
}
}
जवाब प्रोसेस किया जा रहा है
एरियल व्यू एपीआई अब आपके वीडियो को रेंडर कर रहा है. इस जवाब में
videoId
, जिसका इस्तेमाल वीडियो वापस पाने के लिए किया जा सकता है.
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
रेंडरिंग की प्रोसेस में एक घंटे से लेकर कुछ घंटे भी लग सकते हैं. अगर
वीडियो अब भी प्रोसेस हो रहा है. वीडियो की स्थिति का पोल करने के लिए, lookupVideo
का इस्तेमाल किया जा सकता है
जब तक यह ACTIVE
की स्थिति नहीं वापस दे देता.
पोल करने के लिए, videoId
को पास करके, lookupVideo
से अनुरोध करें. रेंडर करने की प्रोसेस यह हो सकती है
कई घंटे लगते हैं, इसलिए घातांकीय (घातांकीय)) का इस्तेमाल करें
बैकऑफ़ का इस्तेमाल करें.
ऐक्टिव रिस्पॉन्स
जब renderVideo
, ACTIVE
की state
वैल्यू दिखाता है, तो इसका मतलब है कि वीडियो में
रेंडरिंग पूरी हो गई है और आप
lookupVideo
को कॉल करके उसे वापस पा सकते हैं
videoId
.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}