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

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

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

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

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

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

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

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

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

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