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

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