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

ARCore भौगोलिक एपीआई के इस क्विकस्टार्ट से, आपको Xcode में एक सैंपल ऐप्लिकेशन चलाने का तरीका पता चलता है जो Geospatial API को दिखाता है.

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

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

अगर आपने हाल ही में ARCore की मदद से अपना डेटा जोड़ा है, तो शुरुआत करना देखें.

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

• Xcode 13.0 या इसके बाद का वर्शन
• अगर Cocoapods का इस्तेमाल किया जा रहा है, तो Cocoapods 1.4.0 या उसके बाद के वर्शन
• iOS 12.0 या इसके बाद के वर्शन पर चलने वाला, ARKit के साथ काम करने वाला Apple डिवाइस (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 चालू किया गया हो.

आपको अपने Google Cloud प्रोजेक्ट में, ARCore API को चालू करना होगा. अगर आपको प्रोजेक्ट बनाना है, तो ये काम करें:

1. Google Cloud Platform में प्रोजेक्ट बनाना पर जाएं.

2. प्रोजेक्ट का सही नाम डालें और उसके लिए कोई जगह चुनें.

3. बनाएं पर क्लिक करें.

4. साइडबार में, एपीआई और सेवाएं को चुनें. इसके बाद, लाइब्रेरी चुनें.

5. ARCore API खोजें, उसे चुनें, और चालू करें पर क्लिक करें.

अनुमति देने की सुविधा सेट अप करें

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

1. अपने Google Cloud प्रोजेक्ट में, एपीआई पासकोड बनाने वाले लेख में बताए गए तरीके से एपीआई पासकोड पाएं.

2. एपीआई पासकोड को उसी तरह कॉपी करें जिस तरह उसे बाद के चरण में चिपकाया जाएगा.

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

4. अपनी एपीआई पासकोड को 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 वर्कस्पेस फ़ाइल चुनें और Sign & capabilities पर क्लिक करें.

2. साइनिंग को अपने-आप मैनेज करें बॉक्स को चुनें.

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

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

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

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

   बिल्ड की गड़बड़ियों से बचने के लिए, पक्का करें कि फ़ाइल को .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 का इस्तेमाल करना शुरू करें.