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

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

Geospatial API की मदद से, खुद का ऐप्लिकेशन डेवलप करने से जुड़ी गाइड के लिए, यहां देखें: Android के लिए जियोस्पेशियल डेवलपर गाइड (Kotlin/Java) या Android NDK (C) के लिए, जियोस्पेशियल डेवलपर गाइड.

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

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

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

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

उन डिवाइस की पूरी सूची के लिए काम करने वाले डिवाइस देखें ARCore के साथ काम करने के लिए सर्टिफ़ाइड हैं. Geospatial API के लिए, ज़रूरी हार्डवेयर में से एक मैग्नेटोमीटर है. यह Geospatial API की ज़रूरी शर्तों को पूरा करता है. कुछ मैग्नेटोमीटर ज़रूरी शर्तों को पूरा नहीं करते; इन डिवाइसों से कनेक्ट किए गए डिवाइस ऑफ़-स्पेक्ट मैग्नेटोमीटर काम नहीं करते.

सॉफ़्टवेयर

  • इसका सबसे नया वर्शन Google Play Services for एआर YouTube TV की सुविधा वाले डिवाइस पर इंस्टॉल किया गया हो.

  • Android Studio का 3.0 या इसके बाद वाला वर्शन जिसमें Android SDK प्लैटफ़ॉर्म का वर्शन 7.0 (एपीआई लेवल 24) या उसके बाद वाला वर्शन हो

  • Android के लिए ARCore SDK टूल, जिसे दो में से किसी एक तरीके से पाया जा सकता है:

    • इसे यहां से डाउनलोड करें GitHub और उसे अपनी मशीन पर निकालें.

    • इस कमांड का इस्तेमाल करके, डेटा स्टोर करने की जगह को क्लोन करें: 

      git clone https://github.com/google-ar/arcore-android-sdk.git

सैंपल ऐप्लिकेशन खोलें और उसे सेट अप करें

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

  1. Android Studio में, फ़ाइल मेन्यू में, खोलें पर क्लिक करें.

  2. arcore-android-sdk के प्रोजेक्ट फ़ोल्डर पर जाएं.

  3. सैंपल फ़ोल्डर खोलें. इसके बाद, geospatial_java फ़ोल्डर चुनें और खोलें पर क्लिक करें.

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

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

सैंपल ऐप्लिकेशन चलाएं

Android Studio में, सैंपल ऐप्लिकेशन चलाएं.

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

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

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

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

थ्रेशोल्ड अडजस्ट करने के लिए:

  1. Android Studio में, GeospatialActivity खोलें और सेक्शन देखें:

    // The thresholds that are required for horizontal and heading accuracies before entering into the
// LOCALIZED state. Once the accuracies are equal or less than these values, the app will
// allow the user to place anchors.
private static final double LOCALIZING_HORIZONTAL_ACCURACY_THRESHOLD_METERS = 10;
private static final double LOCALIZING_HEADING_ACCURACY_THRESHOLD_DEGREES = 15;

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

    सटीक जानकारी कम करने से, ऐप्लिकेशन ज़्यादा अक्षांश पर ऐंकर करता है. यहां जाएं: पोज़ (हाव-भाव) की सटीक जानकारी के लिए उसमें बदलाव करना हमारा वीडियो देखें.

अगले चरण