iOS के लिए जियोस्पेशियल क्विकस्टार्ट

ARCore Geospatial API के लिए यह क्विकस्टार्ट, आपको Xcode में एक सैंपल ऐप्लिकेशन चलाने का तरीका दिखाता है. यह ऐप्लिकेशन, Geospatial API के काम करने का उदाहरण देता है.

Geospatial API की मदद से अपना ऐप्लिकेशन बनाने के बारे में जानने के लिए, iOS के लिए Geospatial डेवलपर गाइड देखें.

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

अगर आपने ARCore का इस्तेमाल करके ऐप्लिकेशन डेवलप करने की शुरुआत अभी-अभी की है, तो शुरू करना लेख पढ़ें.

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

• Xcode का 13.0 या इसके बाद का वर्शन
• Cocoapods का इस्तेमाल करने पर, Cocoapods 1.4.0 या इसके बाद का वर्शन
• ARKit के साथ काम करने वाला Apple डिवाइस, जिसमें iOS 12.0 या इसके बाद का वर्शन हो (iOS 12.0 या इसके बाद के वर्शन पर डिप्लॉयमेंट टारगेट होना ज़रूरी है)

ध्यान दें: ARCore 1.12 से, ARKit के साथ काम करने वाले सभी डिवाइसों पर यह सुविधा काम करती है.

सैंपल ऐप्लिकेशन सेट अप करना

iOS के लिए ARCore SDK टूल में शामिल GeospatialExample प्रोजेक्ट में, Geospatial API को कॉल करने वाले कोड के बारे में बताया गया है.

1. ऐप्लिकेशन का सैंपल कोड पाने के लिए, GitHub से iOS के लिए ARCore SDK टूल को क्लोन या डाउनलोड करें.

2. Terminal या Finder विंडो खोलें और उस फ़ोल्डर पर जाएं जहां आपने SDK टूल को क्लोन किया है या डाउनलोड किया है.

3. arcore-ios-sdk-master/Examples फ़ोल्डर पर जाएं.

4. उदाहरण फ़ोल्डर खोलें. इसके बाद, GeospatialExample फ़ोल्डर चुनें और खोलें पर क्लिक करें.

Google Cloud प्रोजेक्ट सेट अप करना

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

अनुमति सेट अप करना

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

1. XCode में, GeospatialExample सैंपल ऐप्लिकेशन में, ViewController.m फ़ाइल खोलें और your-api-key खोजें.

2. GARSession में अपना एपीआई पासकोड जोड़ें: पिछले चरण में कॉपी किए गए एपीआई पासकोड को, टेक्स्ट your-api-key (कोटेशन हटाएं) पर चिपकाएं, जैसा कि दिखाया गया है:

   self.garSession = [GARSession sessionWithAPIKey:@"your-api-key"
                                  bundleIdentifier:nil
                                             error:&error];
   

ARCore SDK टूल सेट अप करना

GeospatialExample ऐप्लिकेशन, Podfile के साथ शिप होता है. इसे आपके ज़रूरत के मुताबिक, पहले से कॉन्फ़िगर किया गया है. इसमें ARCore SDK टूल और iOS के वे वर्शन शामिल होते हैं जो आपको चाहिए. इन डिपेंडेंसी को इंस्टॉल करने के लिए, कोई टर्मिनल विंडो खोलें और उस फ़ोल्डर से pod install चलाएं जहां Xcode प्रोजेक्ट मौजूद है.

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

सैंपल ऐप्लिकेशन बनाना और चलाना

1. Xcode में, GeospatialExample वर्कस्पेस फ़ाइल चुनें और साइनिंग और सुविधाएं पर क्लिक करें.

2. हस्ताक्षर करने की सुविधा अपने-आप मैनेज करें बॉक्स को चुनें.

3. टीम फ़ील्ड में, टीम का नाम डालें.

   Xcode से ऐप्लिकेशन चलाने के लिए, डिफ़ॉल्ट बंडल आइडेंटिफ़ायर का इस्तेमाल किया जा सकता है. हालांकि, अगर प्रोडक्शन में अपने ऐप्लिकेशन के लिए, GeospatialExample को स्टब के तौर पर इस्तेमाल किया जाता है, तो आपको इसे बदलना होगा.

4. सैंपल ऐप्लिकेशन चलाने के लिए, अपना डिवाइस कनेक्ट करें.

5. .xcworkspace फ़ाइल से GeospatialExample ऐप्लिकेशन बनाएं और उसे चलाएं, ताकि आप उसे अपने डिवाइस पर लॉन्च कर सकें.

   बिल्ड करने से जुड़ी गड़बड़ियों से बचने के लिए, पक्का करें कि आपने .xcworkspace फ़ाइल से बिल्ड किया हो, न कि .xcodeproj फ़ाइल से.

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

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

अगर VPS की जानकारी उपलब्ध नहीं है, तो हो सकता है कि जगह की जानकारी बहुत कम सटीक हो. ऐप्लिकेशन को इंटरनेट से कनेक्ट करना ज़रूरी है. साथ ही, वीपीएस को जगह की जानकारी होनी चाहिए. बेहतर नतीजे पाने के लिए, सैंपल ऐप्लिकेशन को दिन के उजाले में बाहर चलाएं, न कि घर के अंदर.

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

थ्रेशोल्ड में बदलाव करने के लिए:

1. Xcode में, ViewController.m फ़ाइल खोलें और इस सेक्शन पर जाएं:

   // Thresholds for 'good enough' accuracy. These can be tuned for the
   // application. We use both 'low'
   // and 'high' values here to avoid flickering state changes.
   static const CLLocationAccuracy kHorizontalAccuracyLowThreshold = 10;
   static const CLLocationAccuracy kHorizontalAccuracyHighThreshold = 20;
   static const CLLocationDirectionAccuracy kHeadingAccuracyLowThreshold = 15;
   static const CLLocationDirectionAccuracy kHeadingAccuracyHighThreshold = 25;
   

2. ज़रूरत के हिसाब से इन वैल्यू में बदलाव करें. वैल्यू जितनी ज़्यादा होगी, सटीक जानकारी कम होगी.

   सटीक जानकारी को कम करने पर, ऐप्लिकेशन को ऐंकर डालने के लिए ज़्यादा अनुमति मिलती है. ज़्यादा जानकारी के लिए, ट्रांसफ़ॉर्मेशन के सटीक होने के लिए अडजस्ट करें देखें.

अगले चरण

iOS के लिए जियोस्पेशियल डेवलपर गाइड पढ़ें और Geospatial API का इस्तेमाल करके ऐप्लिकेशन बनाना शुरू करें.