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

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

भौगोलिक एपीआई की मदद से अपना ऐप्लिकेशन बनाने से जुड़ी गाइड के लिए, Android के लिए भौगोलिक डेवलपर गाइड (Kotlin/Java) देखें या Android एनडीके (C) के लिए जियोस्पेशियल डेवलपर गाइड देखें.

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

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

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

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

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

सॉफ़्टवेयर

  • काम करने वाले डिवाइस पर Google Play Services for AR का नया वर्शन इंस्टॉल होना चाहिए.

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

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

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

    • रिपॉज़िटरी को इस निर्देश के साथ क्लोन करें: 

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

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

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

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

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

  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. इन वैल्यू में ज़रूरत के हिसाब से बदलाव करें. वैल्यू जितनी ज़्यादा होगी, उतनी कम सटीक होगी.

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

अगले चरण