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

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, ACTIVE की state वैल्यू दिखाता है, तो इसका मतलब है कि वीडियो का रेंडर होना पूरी हो गया है. इसे videoId के साथ lookupVideo को कॉल करके वापस पाया जा सकता है.

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