ऐरियल व्यू एपीआई का इस्तेमाल कैसे करें

Aerial View API के साथ दो सामान्य वर्कफ़्लो इस्तेमाल किए जा सकते हैं. आपका तरीका इस बात पर निर्भर करता है कि जिस वीडियो का अनुरोध किया जा रहा है वह मौजूद है या नहीं. अगर आपको पक्का पता नहीं है कि वीडियो मौजूद है या नहीं, तो आपको वीडियो की स्थिति का पता लगाने के लिए lookupVideoMetadata का इस्तेमाल करना चाहिए.

वीडियो जनरेट करने या वापस पाने का वर्कफ़्लो

एरियल व्यू वीडियो जनरेट करने या वापस पाने के लिए, यह वर्कफ़्लो इस्तेमाल करें:

1. देखें कि क्या Google ने lookupVideoMetadata का इस्तेमाल करके, जगह के लिए पहले से ही कोई वीडियो जनरेट किया है.
2. अगर कोई वीडियो मौजूद नहीं है (lookupVideoMetadata ने 404 गड़बड़ी दिखाई है), तो नया वीडियो जनरेट करने के लिए renderVideo को कॉल करें.
   1. वीडियो की स्थिति ACTIVE होने तक, videoId या पते का इस्तेमाल करके एंडपॉइंट को पोल करने के लिए, lookupVideoMetadata को कॉल करें. रेंडर होने में कई घंटे लग सकते हैं. इसलिए, अपने कॉल के बीच में समय का अंतर रखने के लिए, एक्सपोनेंशियल बैकऑफ़ का इस्तेमाल करें.

3. अगर वीडियो चालू है (lookupVideoMetadata ने ACTIVE की स्थिति दिखाई है), तो वीडियो के यूआरआई फ़ेच करने के लिए, lookupVideo को कॉल करें.

   ध्यान दें: Google किसी पते के लिए वीडियो जनरेट करने के बाद, वह वीडियो सभी के लिए उपलब्ध होता है. इसका मतलब है कि वीडियो किसी खास उपयोगकर्ता या खाते से नहीं जुड़ा होता.

इस वर्कफ़्लो को नीचे दिए गए डायग्राम में दिखाया गया है:

बाद में इस्तेमाल करने के लिए वीडियो आईडी सेव करना

Aerial View API की सेवा से जुड़ी खास शर्तों के मुताबिक, Aerial View API के वीडियो आईडी पर, Google Maps Platform की सेवा की शर्तों के सेक्शन 3.2.3(b)(कैश मेमोरी में सेव न करना) में बताई गई, कैश मेमोरी में सेव करने से जुड़ी पाबंदियां लागू नहीं होती हैं. इसलिए, वीडियो आईडी की वैल्यू को बाद में इस्तेमाल करने के लिए सेव किया जा सकता है.