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

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

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

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

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

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

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

ARCore API चालू करें

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

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

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

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

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

  1. अपनेplatformpod प्रोजेक्ट का Podfile:

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

    अगर आपको iOS 10 पर काम करना है, तो platform :ios, '10.0' भी तय किया जा सकता है ध्यान रखें कि Geospatial API सिर्फ़ iOS >= 11 पर रनटाइम के दौरान काम करेगा.

  2. टर्मिनल विंडो खोलें और उस फ़ोल्डर से 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;
}

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

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

डिवाइस की मौजूदा जगह के हिसाब से, जगह के हिसाब से उपलब्धता देखें

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

Geospatial API का इस्तेमाल उन इलाकों में भी किया जा सकता है जहां वीपीएस कवरेज नहीं है. बाहर के वातावरण में बहुत कम या कोई रुकावट नहीं होने पर, जीपीएस ज़्यादा सटीक तरीके से बदलाव करने के लिए काफ़ी हो सकता है.

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