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

ARCore जियोस्पेशल एपीआई की इस क्विकस्टार्ट सुविधा से, आपको Android Studio में ऐप्लिकेशन का एक नमूना चलाने का तरीका पता चलता है. यह ऐप्लिकेशन जियोस्पेशल एपीआई दिखाता है.

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

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

अगर आप ARCore के साथ नए हैं, तो शुरू करना देखें.

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

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

ऐसे डिवाइस जिन पर यह सुविधा काम करती है देखें और उन डिवाइसों की पूरी सूची देखें जिन्हें ARCore के साथ काम करने के लिए प्रमाणित किया गया है. भौगोलिक डेटा के लिए, हार्डवेयर का एक अहम हिस्सा मैग्नेटोमीटर है, जो भौगोलिक डेटा के एपीआई की खास बातों के मुताबिक होता है. कुछ मैग्नेटोमीटर खास जानकारी के मुताबिक नहीं हैं. ऐसे डिवाइस जिन पर यह मैग्नेटोमीटर नहीं है, वे काम नहीं करते.

सॉफ़्टवेयर

  • एआर (ऑगमेंटेड रिएलिटी) डिवाइस पर इंस्टॉल किया गया 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 टूल से शामिल किया गया geospital_java प्रोजेक्ट, जियोस्पेशल एपीआई को कॉल करने वाले कोड की जानकारी देता है.

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

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

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

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

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

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

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

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

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

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

  5. ARCore एपीआई खोजें, उसे चुनें, और चालू करें पर क्लिक करें.

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

भौगोलिक डेटा से जुड़े एपीआई (VPS) को कॉल करने के लिए, सैंपल ऐप्लिकेशन का इंस्टेंस, बिना अनुमति के अनुमति का इस्तेमाल कर सकता है.

  1. अपने Android Studio प्रोजेक्ट में, Gradle टूलपैन खोलें.

  2. <project-name> > work > Tasks > android पर जाएं.

  3. signreport टास्क को चलाएं.

  4. SHA-1 फ़िंगरप्रिंट को कॉपी करें, इसे बाद के चरणों में चिपकाएं.

    ऐप्लिकेशन के नमूने के लिए, डीबग फ़िंगरप्रिंट का इस्तेमाल करें.

  5. अपने Google Cloud प्रोजेक्ट में, OAuth क्लाइंट आईडी बनाएं.

  6. SHA-1 फ़िंगरप्रिंट फ़ील्ड में, पिछले चरण में दिए गए SHA-1 फ़िंगरप्रिंट को चिपकाएं.

  7. OAuth क्लाइंट आईडी बनाने के लिए, बनाएं पर क्लिक करें.

ज़रूरी लाइब्रेरी शामिल करें

ऐप्लिकेशन और नमूने की build.gradle फ़ाइल में, Google Play सेवाएं सेट अप करें ताकि Android लाइब्रेरी में Google साइन-इन शामिल किया जा सके.

dependencies {
  // Apps must declare play-services-auth version >= 16.
  // In the following line, substitute `16 (or later)` with the latest version.
  implementation 'com.google.android.gms:play-services-auth:16 (or later)'
}

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

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

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

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

अगर वीएसपी की जानकारी उपलब्ध नहीं है, तो हो सकता है कि पोज़िशनिंग करने की स्थिति बहुत कम हो. ऐप्लिकेशन इंटरनेट से जुड़ा होना चाहिए और जगह की जानकारी वीपी को होनी चाहिए. सबसे अच्छे नतीजे पाने के लिए, सैंपल ऐप्लिकेशन को दिन के समय के दौरान, घर के बाहर (न कि घर के अंदर) चलाएं.

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

थ्रेशोल्ड में बदलाव करने के लिए:

  1. Android Studio में, भौगोलिक डेटा से जुड़ी गतिविधि खोलें और नीचे दिए गए सेक्शन पर ब्राउज़ करें:

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

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

अगले चरण