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

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 की स्थिति न दिखाए.

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

सक्रिय जवाब

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

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