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

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

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

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

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

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

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