Android Studio प्रोजेक्ट सेट अप करना

अपने ऐप्लिकेशन को Android के लिए Places SDK टूल का इस्तेमाल करने के लिए कॉन्फ़िगर करने के लिए, इन चरणों का पालन करें. ये उन सभी ऐप्लिकेशन के लिए ज़रूरी हैं जो Android के लिए Places SDK टूल का इस्तेमाल करते हैं.

पहला चरण: Android Studio सेट अप करना

  1. Android Studio के आर्कटिक फ़ॉक्स या उसके बाद वाले वर्शन की ज़रूरत है. अगर आपने अब तक ऐसा नहीं किया है, तो इसे डाउनलोड करें और इंस्टॉल करें.
  2. पक्का करें कि Android Gradle प्लग इन 7.0 या इसके बाद के वर्शन का इस्तेमाल Android Studio में किया जा रहा है.

दूसरा चरण. SDK टूल सेट अप करें

Android लाइब्रेरी के लिए Places SDK टूल,Google के Maven के डेटा स्टोर करने की जगह से उपलब्ध है. अपने ऐप्लिकेशन में SDK टूल जोड़ने के लिए, ये काम करें:

  1. अपनी टॉप-लेवल settings.gradle फ़ाइल में, gradle प्लग इन पोर्टल, Google Maven का डेटा स्टोर करने की जगह, और Maven सेंट्रल रिपॉज़िटरी शामिल करें. pluginManagement ब्लॉक, स्क्रिप्ट के किसी भी दूसरे स्टेटमेंट से पहले दिखना चाहिए. 
    pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
  2. अपनी टॉप-लेवल settings.gradle फ़ाइल में, dependencyResolutionManagement ब्लॉक के तहत Google का Maven डेटा स्टोर करने की जगह और Maven सेंट्रल रिपॉज़िटरी शामिल करें: 
    dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

  3. अपनी मॉड्यूल-लेवल build.gradle फ़ाइल के dependencies सेक्शन में, Android के लिए Places SDK टूल में एक डिपेंडेंसी जोड़ें:

    dependencies {
    implementation 'com.google.android.libraries.places:places:3.0.0'
}
  4. अपने मॉड्यूल-लेवल वाली build.gradle फ़ाइल में, compileSdk और minSdk को इन वैल्यू पर सेट करें: 
    android {
    compileSdk 31

    defaultConfig {
        minSdk 21
        // ...
    }

तीसरा चरण: प्रोजेक्ट में अपनी एपीआई कुंजी जोड़ना

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

हमारा सुझाव है कि इस टास्क को व्यवस्थित करने के लिए, Android के लिए सीक्रेट ग्रेडल प्लग इन का इस्तेमाल करें. प्लग इन इंस्टॉल करने और अपनी एपीआई कुंजी सेव करने के लिए:

  1. Android Studio में, अपनी प्रोजेक्ट-लेवल की build.gradle फ़ाइल खोलें और इसमें मौजूद कोड को buildscript में मौजूद dependencies एलिमेंट में जोड़ें. 
    plugins {
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false
}
  2. इसके बाद, अपनी मॉड्यूल-लेवल build.gradle फ़ाइल खोलें और plugins कोड में यह कोड जोड़ें. 
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
  3. फ़ाइल सेव करें और अपने प्रोजेक्ट को Gradle के साथ सिंक करें.
  4. अपनी प्रोजेक्ट लेवल डायरेक्ट्री में local.properties खोलें और नीचे दिया गया कोड जोड़ें. YOUR_API_KEY को अपनी एपीआई कुंजी से बदलें. 
    MAPS_API_KEY=YOUR_API_KEY
  5. फ़ाइल सेव करें.
  6. अपनी AndroidManifest.xml फ़ाइल में, com.google.android.geo.API_KEY पर जाएं और android:value attribute को इस तरह अपडेट करें: 
    <meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${MAPS_API_KEY}" />

ध्यान दें: जैसा कि ऊपर दिखाया गया है, एपीआई कुंजी के लिए com.google.android.geo.API_KEY को मेटाडेटा का नाम देने का सुझाव दिया जाता है. Android प्लैटफ़ॉर्म पर Google Maps पर बने कई एपीआई की पुष्टि करने के लिए, इस नाम से कुंजी का इस्तेमाल किया जा सकता है. इसमें, Android के लिए Places SDK टूल भी शामिल है. पुराने सिस्टम के साथ काम करने की सुविधा के लिए, एपीआई का नाम com.google.android.maps.v2.API_KEY भी काम करता है. इस लेगसी नाम से, सिर्फ़ Android Maps API v2 की पुष्टि की जा सकती है. ऐप्लिकेशन एपीआई कुंजी के मेटाडेटा के नामों में से सिर्फ़ एक को तय कर सकता है. अगर दोनों के बारे में बताया गया हो, तो एपीआई अपवाद देता है.

चरण 4. Places API क्लाइंट शुरू करें

नीचे दिए गए उदाहरण में दिखाए गए तरीके से किसी गतिविधि या फ़्रैगमेंट में Android के लिए Places SDK टूल शुरू करना (ध्यान दें कि आप कॉल करते समय एपीआई कुंजी पास करते हैं Places.initialize()):

Java


    // Initialize the SDK
    Places.initialize(getApplicationContext(), apiKey);

    // Create a new PlacesClient instance
    PlacesClient placesClient = Places.createClient(this);

Kotlin


    // Initialize the SDK
    Places.initialize(applicationContext, apiKey)

    // Create a new PlacesClient instance
    val placesClient = Places.createClient(this)

अब आप Android के लिए Places SDK टूल का उपयोग शुरू करने के लिए तैयार हैं!

पांचवां चरण: Android डिवाइस सेट अप करना

Android के लिए Places SDK टूल का इस्तेमाल करने वाला कोई ऐप्लिकेशन चलाने के लिए, आपको उसे किसी Android डिवाइस या ऐसे Android एम्युलेटर पर डिप्लॉय करना होगा जो Android 4.0 या उसके बाद वाले वर्शन पर आधारित हो और जिसमें Google API शामिल हो.

  • Android डिवाइस का इस्तेमाल करने के लिए, हार्डवेयर डिवाइस पर ऐप्लिकेशन चलाएं में दिए गए निर्देशों का पालन करें.
  • Android एम्युलेटर का इस्तेमाल करने के लिए, वर्चुअल डिवाइस बनाया जा सकता है. साथ ही, Android Studio के साथ मिलने वाले Android वर्चुअल डिवाइस (AVD) मैनेजर का इस्तेमाल करके, एम्युलेटर इंस्टॉल किया जा सकता है.

अगले चरण

प्रोजेक्ट कॉन्फ़िगर होने के बाद, ऐप्लिकेशन के नमूने देखे जा सकते हैं.