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

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

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

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

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

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

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

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

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

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