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

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

जवाब प्रोसेस किया जा रहा है

Aerial View API अब आपके वीडियो को रेंडर कर रहा है. रिस्पॉन्स में videoId शामिल होता है. इसका इस्तेमाल करके, वीडियो को वापस पाया जा सकता है.

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

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

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

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

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

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