डिवाइस की मौजूदा जगह पर VPS की उपलब्धता देखें

Geospatial API, ज़्यादा सटीक भौगोलिक डेटा ट्रांसफ़ॉर्म जनरेट करने के लिए, VPS और जीपीएस डेटा के कॉम्बिनेशन का इस्तेमाल करता है. इस एपीआई का इस्तेमाल ऐसी किसी भी जगह पर किया जा सकता है जहां डिवाइस की जगह की जानकारी मिल सकती है:

  • जिन इलाकों में जीपीएस की सटीक जानकारी नहीं मिलती है, जैसे कि इनडोर स्पेस और शहर के घने इलाके, वहां एपीआई वीपीएस कवरेज का इस्तेमाल करके, सटीक ट्रांसफ़ॉर्म जनरेट करेगा.
  • जियोस्पेशल एपीआई, ज़्यादा सटीक जियोस्पेशल ट्रांसफ़ॉर्म जनरेट करने के लिए, उपलब्ध जीपीएस लोकेशन डेटा का इस्तेमाल कर सकता है. ऐसा, ऐसे आउटडोर एनवायरमेंट में किया जा सकता है जहां ऊपर से आने वाली रुकावटें कम या बिलकुल न हों.

एआर सेशन शुरू होने से पहले, किसी हॉरिज़ॉन्टल पोज़िशन पर वीपीएस की उपलब्धता का पता लगाया जा सकता है. साथ ही, इसका इस्तेमाल करके ज़्यादा बेहतर अनुभव दिए जा सकते हैं. उदाहरण के लिए, सिर्फ़ वीपीएस उपलब्ध होने पर "एआर में जाएं" बटन दिखाना.

ARCore API चालू करना

वीपीएस की उपलब्धता देखने के लिए, आपके ऐप्लिकेशन में ARCore API चालू होना चाहिए.

अपने ऐप्लिकेशन में वीपीएस की उपलब्धता देखना

Geospatial API का इस्तेमाल ऐसी किसी भी जगह पर किया जा सकता है जहां डिवाइस की जगह की जानकारी मिल सकती है. अगर एआर अनुभव, वीपीएस कवरेज पर निर्भर करता है, तो GARVPSAvailabilityFuture पाने के लिए GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: का इस्तेमाल किया जा सकता है. यह एक असाइनमेंट है, जो किसी दी गई हॉरिज़ॉन्टल पोज़िशन पर वीपीएस की उपलब्धता की जांच करता है. GARVPSAvailabilityFuture मिलने के बाद, पॉलिंग या कॉलबैक की मदद से इसका नतीजा पाया जा सकता है.

नतीजे के बारे में पोल करना

Future की स्थिति जानने के लिए, GARFuture.state का इस्तेमाल करें. तीन अलग-अलग स्थितियां होती हैं:

  • GARFutureStatePending: कार्रवाई अभी पूरी नहीं हुई है, इसलिए नतीजे की जानकारी नहीं है.
  • GARFutureStateCancelled: GARFuture#cancel ने कार्रवाई रद्द कर दी है. रजिस्टर किया गया कोई भी कॉलबैक कभी नहीं किया जाएगा.
  • GARFutureStateDone: कार्रवाई पूरी हो गई है. नतीजा पाने के लिए, GARVPSAvailabilityFuture.result का इस्तेमाल करें.

टास्क पूरा होने तक, GARFuture.state को देखते रहें.

कॉलबैक की मदद से नतीजा पाना

कॉलबैक की मदद से भी Future का नतीजा पाया जा सकता है. GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: का इस्तेमाल करें और completionHandler डालें. Future के स्टेटस के GARFutureStateDone होने के तुरंत बाद, इस completionHandler को मुख्य थ्रेड पर कॉल किया जाएगा.

Future को रद्द करना

Future को रद्द करने के लिए, GARFuture#cancel का इस्तेमाल करें. थ्रेड के पैरलल प्रोसेस होने की वजह से, हो सकता है कि आपका रद्द करने का अनुरोध पूरा न हो पाए. अगर यह कोशिश पूरी हो जाती है, तो GARFuture#cancel YES दिखाता है. अगर ऐसा नहीं होता है, तो NO दिखाता है.

VPS कवरेज के बिना Geospatial API का इस्तेमाल करना

जियोस्पेशल एपीआई का इस्तेमाल उन इलाकों में भी किया जा सकता है जहां वीपीएस की सुविधा उपलब्ध नहीं है. अगर आप किसी ऐसे आउटडोर लोकेशन पर हैं जहां ऊपर से कोई रुकावट नहीं है या बहुत कम रुकावटें हैं, तो जीपीएस की मदद से, पोज़ को सटीक तरीके से जनरेट किया जा सकता है.

आगे क्या करना है