iOS के लिए भू-स्थानिक क्विकस्टार्ट

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

भौगोलिक ऐप्लिकेशन के साथ अपना ऐप्लिकेशन डेवलप करने की गाइड के लिए, iOS के लिए भौगोलिक डेटा की डेवलपर गाइड देखें.

भौगोलिक डेटा के एपीआई के बारे में ज़्यादा जानने के लिए, ARCore जियोस्पेशियल एपीआई का परिचय देखें.

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

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

डिवाइस से जुड़ी सहायता

जिन डिवाइस को ARCore के साथ काम करने के लिए सर्टिफ़िकेशन मिला है उनकी पूरी सूची देखने के लिए काम करने वाले डिवाइस देखें.

सॉफ़्टवेयर

  • Xcode वर्शन 13 या उसके बाद का वर्शन

  • Cocoapods 1.4.0 या उसके बाद के वर्शन

  • iOS 11.0 या इसके बाद के वर्शन पर चलने वाला ARKit के साथ काम करने वाला Apple डिवाइस (iOS 10.0 या इसके बाद के वर्शन के डिप्लॉयमेंट टारगेट, सैंपल ऐप्लिकेशन चलाने के लिए 11.0 ज़रूरी है)

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

iOS के लिए, ARCore SDK टूल के साथ शामिल किए गए GeospatalExample प्रोजेक्ट में भौगोलिक कोड को कॉल करने वाले कोड की जानकारी दी गई है.

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

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

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

  4. उदाहरण फ़ोल्डर खोलें, भौगोलिक डेटा के उदाहरण फ़ोल्डर को चुनें और खोलें पर क्लिक करें.

Google Cloud Project सेट अप करना

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

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

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

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

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

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

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

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

भू-स्थानिक API (एपीआई) कॉल को VPS पर करने के लिए, सैंपल ऐप्लिकेशन को अनुमति देने की ज़रूरत होती है और बिना पाबंदी वाले एपीआई कुंजी का इस्तेमाल हो सकता है. अगर आप प्रतिबंधित एपीआई कुंजी का इस्तेमाल करते हैं, तो आपको एपीआई कुंजी से जोड़ने के लिए एक बंडल आईडी भी देना होगा.

  1. अपने Google Cloud Project में, एपीआई कुंजी बनाने में बताए गए तरीके से एपीआई कुंजी पाएं.

  2. एपीआई कुंजी को कॉपी करें, जैसा कि आप उसे बाद के चरण में चिपकाएंगे.

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

  4. GARSession में अपनी API (एपीआई) कुंजी जोड़ें: पिछले एपीआई से कॉपी की गई एपीआई कुंजी को, टेक्स्ट के तौर पर अपनी एपीआई कुंजी (कोटेशन छोड़ें) पर चिपकाएं, जैसा कि नीचे दिखाया गया है.

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

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

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

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

ऐप्लिकेशन का नमूना बनाएं और चलाएं

  1. Xcode में, GeospatalExample फ़ाइल फ़ोल्डर चुनें और साइनिंग और एएमपी; क्षमताएं पर क्लिक करें.

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

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

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

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

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

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

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

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

अगर वीपीएस जानकारी उपलब्ध नहीं है, तो पोज़िशनिंग की सटीक जानकारी बहुत कम हो सकती है. ऐप्लिकेशन को इंटरनेट से कनेक्ट होना चाहिए और जगह की जानकारी 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 के लिए भौगोलिक डेटा डेवलपर गाइड देखें और भौगोलिक डेटा एपीआई का इस्तेमाल शुरू करें.