अपने iOS ऐप्लिकेशन के लिए Geospatial API को चालू करना

अपने ऐप्लिकेशन की सेटिंग कॉन्फ़िगर करें, ताकि वह Geospatial API का इस्तेमाल कर सके.

ज़रूरी शर्तें

आगे बढ़ने से पहले, पक्का करें कि आपने एआर के बुनियादी कॉन्सेप्ट और ARCore सेशन को कॉन्फ़िगर करने का तरीका समझ लिया हो.

अगर आपको यहां बताए गए फ़ंक्शन को दिखाने वाला कोई सैंपल ऐप्लिकेशन चलाना है, तो iOS के लिए ARCore का जियोस्पेशल क्विकस्टार्ट देखें.

Geospatial API के बारे में ज़्यादा जानकारी के लिए, Geospatial API के बारे में जानकारी देखें.

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

ARCore API चालू करना

अपने ऐप्लिकेशन में विज़ुअल पोज़िशनिंग सिस्टम (वीपीएस) का इस्तेमाल करने से पहले, आपको किसी नए या मौजूदा Google Cloud प्रोजेक्ट में ARCore API को चालू करना होगा. यह सेवा, जियोस्पेशल ऐंकर को होस्ट करने, सेव करने, और रिज़ॉल्व करने के लिए ज़िम्मेदार है.

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

अपने ऐप्लिकेशन में ज़रूरी लाइब्रेरी जोड़ना

अपने ऐप्लिकेशन को ARCore API को कॉल करने की अनुमति देने के बाद, आपको अपने ऐप्लिकेशन में जियोस्पेशल सुविधाएं चालू करने के लिए लाइब्रेरी जोड़नी होंगी.

अपने ऐप्लिकेशन के लिए Podfile को अपडेट करें, ताकि ARCore SDK टूल और iOS के साथ काम करने वाले वर्शन को शामिल किया जा सके. ऐसा करने के लिए:

  1. अपने प्रोजेक्ट के Podfile में ये platform और pod जोड़ें:

    platform :ios, '11.0'
pod 'ARCore/Geospatial', '~> 1.48.0'

    अगर आपको iOS 10 के साथ काम करना है, तो platform :ios, '10.0' भी डाला जा सकता है. हालांकि, ध्यान दें कि Geospatial API सिर्फ़ iOS 11 और उसके बाद के वर्शन पर रनटाइम के दौरान काम करेगा.

  2. कोई Terminal विंडो खोलें और उस फ़ोल्डर से pod install चलाएं जहां आपका Xcode प्रोजेक्ट मौजूद है.

    इससे एक .xcworkspace फ़ाइल जनरेट होती है. इसका इस्तेमाल, ऐप्लिकेशन को बनाने और चलाने के लिए किया जाता है.

पक्का करें कि आपका डेवलपमेंट एनवायरमेंट, क्विकस्टार्ट में बताई गई ARCore SDK टूल की ज़रूरी शर्तों को पूरा करता हो.

सेशन कॉन्फ़िगरेशन में, भौगोलिक डेटा से जुड़ी सुविधाएं चालू करना

देखें कि यह सुविधा किन डिवाइसों पर काम करती है

शुरुआती जानकारी में बताए गए मुताबिक, ARCore के साथ काम करने वाले सभी डिवाइसों पर Geospatial API काम नहीं करता.

डिवाइस की जांच करने के लिए, GARSession.isGeospatialModeSupported: का इस्तेमाल करें, जैसा कि यहां बताया गया है:

if (![self.garSession isGeospatialModeSupported:GARGeospatialModeEnabled]) {
  [self setErrorStatus:@"GARGeospatialModeEnabled is not supported on this device."];
  return;
}

GARSessionConfiguration *configuration = [[GARSessionConfiguration alloc] init];
configuration.geospatialMode = GARGeospatialModeEnabled;
[self.garSession setConfiguration:configuration error:&error];
if (error) {
  [self setErrorStatus:[NSString stringWithFormat:@"Failed to configure GARSession: %d",
                                                  (int)error.code]];
  return;
}

रनटाइम के दौरान, उपयोगकर्ता से जगह की जानकारी की अनुमतियां मांगना

सेशन को कॉन्फ़िगर करने से पहले, आपके ऐप्लिकेशन को रनटाइम पर जगह की जानकारी से जुड़ी इन अनुमतियों का अनुरोध करना होगा:

डिवाइस की मौजूदा जगह पर जियोस्पेशल डेटा की उपलब्धता देखना

जियोस्पेशल एपीआई, जियोस्पेशल ट्रांसफ़ॉर्म का पता लगाने के लिए, VPS और जीपीएस के कॉम्बिनेशन का इस्तेमाल करता है. इसलिए, जब तक डिवाइस की जगह की जानकारी का पता लगाया जा सकता है, तब तक एपीआई का इस्तेमाल किया जा सकता है. जिन इलाकों में जीपीएस की सटीक जानकारी नहीं मिलती है, जैसे कि इनडोर स्पेस और शहर के घने इलाके, वहां एपीआई वीपीएस कवरेज का इस्तेमाल करके, सटीक ट्रांसफ़ॉर्म जनरेट करेगा. सामान्य परिस्थितियों में, वीपीएस से जगह की सटीक जानकारी 5 मीटर और घुमाव की सटीक जानकारी 5 डिग्री तक मिल सकती है. GARSession.checkVPSAvailabilityAtCoordinate:completionHandler: का इस्तेमाल करके पता लगाएं कि किसी जगह पर VPS की सुविधा उपलब्ध है या नहीं.

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

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