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

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

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

ज़्यादा जानकारी के लिए, ज़्यादा जानकारी के लिए, ARCore Geospatial API के बारे में जानकारी 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 को चालू करना होगा. हालांकि 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 को जगह की जानकारी मिलनी चाहिए. सबसे अच्छे नतीजों के लिए, सैंपल ऐप्लिकेशन को दिन के समय में बाहर (घर के अंदर नहीं) चलाएं.

साथ ही, अगर आप किसी ऐसे इलाके में हैं जहां 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 का इस्तेमाल करना शुरू करें.