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

कॉन्टेंट बनाने 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"
  }
}

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

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

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

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

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