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

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

• खराब जीपीएस वाले इलाकों, जैसे कि इनडोर जगहों और घनी आबादी वाले शहरी इलाकों में, यह एपीआई बहुत ज़्यादा सटीक बदलाव जनरेट करने के लिए वीपीएस कवरेज पर निर्भर करता है.
• अगर आस-पास की जगहों में बहुत कम या बिलकुल भी रुकावटें न हों, तो Geospatial API, जीपीएस से मिली जगह के डेटा का इस्तेमाल कर सकता है, ताकि ज़्यादा सटीक तरीके से भौगोलिक डेटा में बदलाव किए जा सकें.

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

ARCore API चालू करें

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

यह देखना कि आपके ऐप्लिकेशन में वीपीएस की सुविधा उपलब्ध है या नहीं

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

Geospatial API का इस्तेमाल उन इलाकों में भी किया जा सकता है जहां वीपीएस कवरेज नहीं है. बाहर के वातावरण में बहुत कम या कोई रुकावट नहीं होने पर, जीपीएस को बहुत ज़्यादा सटीक पोज़ देने के लिए काफ़ी मदद मिल सकती है.

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

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