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

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

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

हवाई से ली गई तस्वीरों का वीडियो जनरेट करने या उसे वापस पाने के लिए, यहां दिया गया वर्कफ़्लो अपनाएं:

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

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

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

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

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

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