भौगोलिक डेटा का एपीआई, वीपीएस और जीपीएस डेटा को एक साथ इस्तेमाल करता है, ताकि बहुत सटीक भौगोलिक पोज़ जनरेट किए जा सकें. एपीआई का इस्तेमाल ऐसी किसी भी जगह पर किया जा सकता है जहां डिवाइस अपनी जगह की जानकारी हासिल कर पाए:
- जिन इलाकों में जीपीएस की सटीक जानकारी नहीं होती है वहां के लिए यह एपीआई, बहुत ज़्यादा सही वाले आस-पास की जगहें जनरेट करने के लिए, वीपीएस कवरेज का इस्तेमाल करेगा. जैसे, इनडोर स्पेस और घना शहरी वातावरण.
- अगर घर के बाहर ऐसी जगहें हैं जहां ऊपर से कोई रुकावट नहीं आती, तो भौगोलिक स्थिति ज़्यादा सटीक तरीके से जियोस्पेशियल पोज़ जनरेट करने के लिए, उपलब्ध जीपीएस जगह की जानकारी के डेटा का इस्तेमाल कर सकती है.
आप एआर सेशन शुरू होने से पहले किसी दी गई हॉरिज़ॉन्टल स्थिति पर VPS की उपलब्धता तय कर सकते हैं और ज़्यादा खास अनुभव देने के लिए इसका इस्तेमाल कर सकते हैं — उदाहरण के लिए, "AR डालें" बटन सिर्फ़ तब दिखाएं, जब VPS उपलब्ध हो.
ARCore API चालू करना
आपके ऐप्लिकेशन में ARCore API चालू करना ज़रूरी है, ताकि यह देखा जा सके कि VPS की सुविधा उपलब्ध है या नहीं.
अपने ऐप्लिकेशन में VPS की उपलब्धता देखना
भौगोलिक डेटा के एपीआई का इस्तेमाल ऐसी किसी भी जगह पर किया जा सकता है जहां डिवाइस अपनी जगह का पता लगा सकता है. अगर आपका एआर अनुभव, वीपीएस कवरेज पर आधारित है, तो AREarthManager.CheckVpsAvailabilityAsync() का इस्तेमाल करके VpsAvailabilityPromise लिया जा सकता है. यह एसिंक्रोनस टास्क है जो दिए गए हॉरिज़ॉन्टल पोज़िशन पर VPS की उपलब्धता की जांच करता है.
VpsAvailabilityPromise मिल जाने के बाद, पोल का इस्तेमाल करके इसका नतीजा पाया जा सकता है.
नतीजे पर पोल करें
InterruptiblePromise की स्थिति जानने के लिए, VpsAvailabilityPromise.State का इस्तेमाल करें. ये तीन अलग-अलग स्थितियां होती हैं:
Pending: कार्रवाई अभी पूरी नहीं हुई है, इसलिए किसी नतीजे की जानकारी नहीं है.Cancelled:VpsAvailabilityPromise.Cancel()ने कार्रवाई को रद्द कर दिया है. रजिस्टर किए गए किसी भी कॉलबैक को कभी कॉल नहीं किया जाएगा.Done: कार्रवाई पूरी हो गई है. नतीजा पाने के लिए,VpsAvailabilityPromise.Resultका इस्तेमाल करें.
टास्क पूरा होने तक, VpsAvailabilityPromise.State देखते रहें.
InterruptiblePromise रद्द करें
InterruptiblePromise को रद्द करने के लिए, VpsAvailabilityPromise.Cancel() का इस्तेमाल करें. थ्रेड पैरललिज़्म की वजह से, हो सकता है कि रद्द करने की आपकी कोशिश कामयाब न हुई हो.
VPS कवरेज के बिना Geospatial API का इस्तेमाल करना
भौगोलिक एपीआई का इस्तेमाल उन इलाकों में भी किया जा सकता है जहां वीपीएस कवरेज नहीं है. अगर खुली जगह में हवाई जहाज़ में कोई रुकावट नहीं आती है या आस-पास कोई रुकावट नहीं होती है, तो बेहतर पोज़ बनाने के लिए जीपीएस काफ़ी मददगार हो सकता है.
आगे क्या करना है
- असल दुनिया में उपयोगकर्ता के डिवाइस की जगह की सटीक जानकारी पाने के लिए, डिवाइस के कैमरे के भौगोलिक पोज़ को हासिल करें.