नया वीडियो जनरेट करना

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"
  }
}

रेंडरिंग की प्रोसेस में एक से लेकर कुछ घंटे लग सकते हैं. अगर वीडियो अब भी प्रोसेस हो रहा है, तो lookupVideo का इस्तेमाल करके वीडियो की स्थिति को पोल किया जा सकता है. ऐसा तब तक करें, जब तक कि स्थिति ACTIVE न हो जाए.

पोल करने के लिए, lookupVideo को अनुरोध करें और videoId पास करें. रेंडर होने में कई घंटे लग सकते हैं. इसलिए, कॉल के बीच में समय का अंतर रखने के लिए, एक्सपोनेंशियल बैकऑफ़ का इस्तेमाल करें.

ऐक्टिव रिस्पॉन्स

जब renderVideo, state वैल्यू के तौर पर ACTIVE दिखाता है, तो इसका मतलब है कि वीडियो रेंडर हो गया है. इसे वापस पाने के लिए, videoId के साथ lookupVideo को कॉल करें.

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}