एक ऐसा Android ऐप्लिकेशन बनाएं, जो Google मैप दृश्य का उपयोग करके मैप दिखाता हो टेम्प्लेट पर जाएं. अगर आपके पास कोई मौजूदा Android Studio प्रोजेक्ट है, तो Android Studio प्रोजेक्ट सेट अप करना लेख देखें.
यह क्विकस्टार्ट उन डेवलपर के लिए है जिन्हें बुनियादी जानकारी है Kotlin या Java के साथ Android डेवलपमेंट.
डेवलपमेंट एनवायरमेंट के बारे में जानकारी
यह क्विकस्टार्ट Android Studio का इस्तेमाल करके बनाया गया था हेजहॉग और Android Gradle प्लग इन वर्शन 8.2.
Android डिवाइस सेट अप करें
Android के लिए Maps SDK टूल का इस्तेमाल करने वाले ऐप्लिकेशन को चलाने के लिए, आपको उसे Android डिवाइस या Android पर डिप्लॉय करना होगा एम्युलेटर, जो Android 5.0 या इसके बाद वाले वर्शन पर आधारित हो और जिसमें तो Google API के ज़रिए ऐसा किया जा सकता है.
- Android डिवाइस का इस्तेमाल करने के लिए, यहां दिए गए निर्देशों का पालन करें: हार्डवेयर डिवाइस पर ऐप्लिकेशन चलाएं.
- Android एम्युलेटर का इस्तेमाल करने के लिए, वर्चुअल डिवाइस बनाएं. इसके बाद, Android वर्चुअल डिवाइस (एवीडी) मैनेजर यह सुविधा Android Studio में पहले से मौजूद है.
Android Studio में Google Maps प्रोजेक्ट बनाना
Android Studio में Google Maps प्रोजेक्ट बनाने की प्रोसेस बदलकर, Android Studio के फ़्लमिंगो और इसके बाद के रिलीज़.
Android Studio खोलें और इसमें नया प्रोजेक्ट पर क्लिक करें Android Studio में आपका स्वागत है विंडो.
नया प्रोजेक्ट विंडो में, फ़ोन और टैबलेट कैटगरी में, कोई गतिविधि नहीं को चुनें और फिर आगे बढ़ें पर क्लिक करें.
नया प्रोजेक्ट फ़ॉर्म भरें:
भाषा को Java या Kotlin पर सेट करें. दोनों भाषाएँ, Android के लिए Maps SDK टूल. Kotlin के बारे में ज़्यादा जानने के लिए, यहां देखें Kotlin की मदद से Android ऐप्लिकेशन डेवलप करना.
SDK टूल के कम से कम वर्शन को अपने टेस्ट डिवाइस के साथ काम करने वाले SDK टूल के वर्शन पर सेट करें. आपको ऐसा वर्शन चुनना होगा जो Android के 19.0.x वर्शन के लिए Maps SDK टूल, यह Android एपीआई लेवल 21 ("Lollipop"; Android 5.0) या इसके बाद का वर्शन है. इनके लिए रिलीज़ नोट देखें SDK टूल के वर्शन की ज़रूरी शर्तों के बारे में नई जानकारी.
बिल्ड कॉन्फ़िगरेशन लैंग्वेज को Kotlin DSL या Groovy DSL पर सेट करें. दोनों बिल्ड कॉन्फ़िगरेशन भाषाओं के स्निपेट यहां दिखाए गए हैं प्रोसेस को अंजाम देते हैं.
पूरा करें पर क्लिक करें.
Android Studio, Gradle को शुरू करता है और प्रोजेक्ट बनाता है. इसमें थोड़ा समय लग सकता है.
Google मैप दृश्य गतिविधि जोड़ें:
- अपने प्रोजेक्ट में
app
फ़ोल्डर पर राइट क्लिक करें. नया > चुनें Google > Google Maps व्यू की गतिविधि.
नई Android गतिविधि डायलॉग बॉक्स में, लॉन्चर गतिविधि चेकबॉक्स.
पूरा करें चुनें.
ज़्यादा जानकारी के लिए, यह देखें किसी टेंप्लेट से कोड जोड़ना
- अपने प्रोजेक्ट में
बिल्ड पूरा होने के बाद, Android Studio
AndroidManifest.xml
को खोलता है औरMapsActivity
फ़ाइलें शामिल हैं. आपकी गतिविधि का नाम अलग हो सकता है, लेकिन यह वही खाता है जिसे आपने सेटअप के दौरान कॉन्फ़िगर किया था.
अपना Google Cloud प्रोजेक्ट सेट अप करना
Cloud Console को सेटअप करने के ज़रूरी चरणों को पूरा करने के लिए, इस पर क्लिक करें से लिंक किया गया है:
चरण 1
कंसोल
-
Google Cloud Console में, प्रोजेक्ट चुनने वाले पेज पर, क्लिक करें नया क्लाउड बनाने के लिए प्रोजेक्ट बनाएं प्रोजेक्ट.
-
पक्का करें कि आपके Cloud प्रोजेक्ट के लिए बिलिंग की सुविधा चालू हो. पुष्टि करें कि आपके प्रोजेक्ट के लिए बिलिंग की सुविधा चालू हो.
Google Cloud, मुफ़्त में आज़माने की सुविधा देता है. परीक्षण 90 के अंत में खत्म हो जाएगा दिनों या खाते द्वारा $300 मूल्य के शुल्क अर्जित कर लिए जाने के बाद, जो भी पहले हो. अभी नहीं कभी भी. Google Maps Platform पर हर महीने 200 डॉलर का क्रेडिट दिया जाता है. ज़्यादा के लिए जानकारी, देखें बिलिंग खाता क्रेडिट और बिलिंग.
Cloud SDK
gcloud projects create "PROJECT"
यहां दी गई, Google Cloud SDK टूल , Cloud SDK टूल इंस्टॉल करना , और ये निर्देश दिए जा सकते हैं:
दूसरा चरण
Google Maps Platform का इस्तेमाल करने के लिए, आपको उन एपीआई या SDK टूल को चालू करना होगा जिनका इस्तेमाल आपको अपने प्रोजेक्ट के साथ करना है.
कंसोल
Cloud SDK
gcloud services enable \ --project "PROJECT" \ "maps-android-backend.googleapis.com"
यहां दी गई, Google Cloud SDK टूल , Cloud SDK टूल इंस्टॉल करना , और ये निर्देश दिए जा सकते हैं:
तीसरा चरण
यह चरण सिर्फ़ एपीआई पासकोड बनाने की प्रोसेस से गुज़रता है. अगर एपीआई पासकोड का इस्तेमाल इसलिए, हमारा सुझाव है कि आप एपीआई पासकोड पर पाबंदी लगाएं. ज़्यादा जानकारी पाएं एपीआई पासकोड का इस्तेमाल करना पेज पर, प्रॉडक्ट से जुड़ी जानकारी.
एपीआई पासकोड ऐसा यूनीक आइडेंटिफ़ायर होता है जो आपके प्रोजेक्ट से जुड़े अनुरोधों की पुष्टि करता है इस्तेमाल और बिलिंग के मकसद से. आपके पास अपने प्रोजेक्ट के साथ कम से कम एक एपीआई पासकोड होना ज़रूरी है.
एपीआई पासकोड बनाने के लिए:
कंसोल
-
Google Maps Platform > क्रेडेंशियल पेज पर जाएं.
-
क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं > API पासकोड.
एपीआई पासकोड बनाया गया डायलॉग, आपकी नई बनाई गई एपीआई पासकोड दिखाता है. -
बंद करें पर क्लिक करें.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है नई एपीआई कुंजी, क्रेडेंशियल पेज पर एपीआई पासकोड में मौजूद है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है एपीआई पर पाबंदी लगाना न भूलें कुंजी का इस्तेमाल करें.)
Cloud SDK
gcloud alpha services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
यहां दी गई, Google Cloud SDK टूल , Cloud SDK टूल इंस्टॉल करना , और ये निर्देश दिए जा सकते हैं:
अपने ऐप्लिकेशन में एपीआई पासकोड जोड़ना
इस सेक्शन में, एपीआई पासकोड को सेव करने का तरीका बताया गया है, ताकि इसका इस्तेमाल
आपका ऐप्लिकेशन. आपको वर्शन कंट्रोल सिस्टम में एपीआई पासकोड की जांच नहीं करनी चाहिए. इसलिए, हमारा सुझाव है कि
इसे secrets.properties
फ़ाइल में सेव करना, जो आपकी रूट डायरेक्ट्री में मौजूद होती है
प्रोजेक्ट. secrets.properties
फ़ाइल के बारे में ज़्यादा जानकारी के लिए, देखें
Gradle प्रॉपर्टी फ़ाइलें.
इस टास्क को आसान बनाने के लिए, हमारा सुझाव है कि आप Android के लिए सीक्रेट ग्रेडल प्लग इन.
अपने Google Maps प्रोजेक्ट में Android के लिए Secrets Gradle प्लग इन इंस्टॉल करने के लिए:
-
Android Studio में, अपना टॉप-लेवल
build.gradle
याbuild.gradle.kts
खोलें फ़ाइल और निम्न कोड कोdependencies
तत्व में जोड़ेंbuildscript
.ग्रूवी
buildscript { dependencies { classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1" } }
Kotlin
buildscript { dependencies { classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1") } }
-
अपनी मॉड्यूल-लेवल
build.gradle
फ़ाइल खोलें और नीचे दिए गए कोड कोplugins
एलिमेंट.ग्रूवी
plugins { // ... id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' }
Kotlin
plugins { id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") }
- अपनी मॉड्यूल-लेवल
build.gradle
फ़ाइल में, पक्का करें किtargetSdk
औरcompileSdk
को 34 पर सेट किया गया. - फ़ाइल सेव करें और Gredle के साथ प्रोजेक्ट सिंक करते हैं.
-
अपनी शीर्ष-स्तरीय डायरेक्ट्री में
secrets.properties
फ़ाइल खोलें, और फिर जोड़ें .YOUR_API_KEY
को अपनी एपीआई पासकोड से बदलें. अपनी कुंजी इस फ़ाइल में सेव करें ऐसा इसलिए हुआ, क्योंकि वर्शन कंट्रोल मेंsecrets.properties
की जांच नहीं की जा सकी सिस्टम.MAPS_API_KEY=YOUR_API_KEY
- फ़ाइल सेव करें.
-
अपनी टॉप-लेवल डायरेक्ट्री में
local.defaults.properties
फ़ाइल बनाएं. फ़ोल्डर कोsecrets.properties
फ़ाइल के रूप में चुनकर यह कोड जोड़ें.MAPS_API_KEY=DEFAULT_API_KEY
इस फ़ाइल का मकसद, एपीआई पासकोड के लिए बैकअप जगह की जानकारी देना है, अगर
secrets.properties
फ़ाइल नहीं मिली है, ताकि बिल्ड विफल न हो. ऐसा तब हो सकता है, जब आपने वर्शन कंट्रोल सिस्टम से ऐप्लिकेशन का क्लोन बनाया है. इसमेंsecrets.properties
और आपने अभी तक स्थानीय भाषा मेंsecrets.properties
फ़ाइल नहीं बनाई है. एपीआई पासकोड. - फ़ाइल सेव करें.
-
अपनी
AndroidManifest.xml
फ़ाइल में, इस पर जाएंcom.google.android.geo.API_KEY
औरandroid:value attribute
अपडेट करें. अगर<meta-data>
टैग मौजूद नहीं है, तो उसे<application>
टैग.<meta-data android:name="com.google.android.geo.API_KEY" android:value="${MAPS_API_KEY}" />
Note:
com.google.android.geo.API_KEY
is the recommended metadata name for the API key. A key with this name can be used to authenticate to multiple Google Maps-based APIs on the Android platform, including the Maps SDK for Android. For backwards compatibility, the API also supports the namecom.google.android.maps.v2.API_KEY
. This legacy name allows authentication to the Android Maps API v2 only. An application can specify only one of the API key metadata names. If both are specified, the API throws an exception. -
In Android Studio, open your module-level
build.gradle
orbuild.gradle.kts
file and edit thesecrets
property. If thesecrets
property does not exist, add it.Edit the properties of the plugin to set
propertiesFileName
tosecrets.properties
, setdefaultPropertiesFileName
tolocal.defaults.properties
, and set any other properties.Groovy
secrets { // To add your Maps API key to this project: // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file. // 2. Add this line, where YOUR_API_KEY is your API key: // MAPS_API_KEY=YOUR_API_KEY propertiesFileName = "secrets.properties" // A properties file containing default secret values. This file can be // checked in version control. defaultPropertiesFileName = "local.defaults.properties" // Configure which keys should be ignored by the plugin by providing regular expressions. // "sdk.dir" is ignored by default. ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore" ignoreList.add("sdk.*") // Ignore all keys matching the regexp "sdk.*" }
Kotlin
secrets { // To add your Maps API key to this project: // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file. // 2. Add this line, where YOUR_API_KEY is your API key: // MAPS_API_KEY=YOUR_API_KEY propertiesFileName = "secrets.properties" // A properties file containing default secret values. This file can be // checked in version control. defaultPropertiesFileName = "local.defaults.properties" // Configure which keys should be ignored by the plugin by providing regular expressions. // "sdk.dir" is ignored by default. ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore" ignoreList.add("sdk.*") // Ignore all keys matching the regexp "sdk.*" }
कोड देखें
टेंप्लेट से मिले कोड की जांच करें. खास तौर पर, इन चीज़ों पर नज़र डालें फ़ाइलें शामिल की हैं.
Maps पर की गई गतिविधि वाली फ़ाइल
मैप गतिविधि फ़ाइल, ऐप्लिकेशन की मुख्य गतिविधि है और में मैप को मैनेज करने और दिखाने के लिए कोड होता है. डिफ़ॉल्ट रूप से, जो फ़ाइल गतिविधि का पता लगाता है,
MapsActivity.java
या अगर आपने Kotlin को आपके ऐप्लिकेशन की भाषा,MapsActivity.kt
.मैप गतिविधि के मुख्य एलिमेंट:
SupportMapFragment
ऑब्जेक्ट मैप की लाइफ़साइकल है और यह ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) का पैरंट एलिमेंट है.GoogleMap
ऑब्जेक्ट, मैप के डेटा का ऐक्सेस देता है और व्यू. यह Android के लिए Maps SDK टूल का मुख्य क्लास है. मैप ऑब्जेक्ट गाइड मेंSupportMapFragment
औरGoogleMap
ऑब्जेक्ट के बारे में ज़्यादा जानकारी दी गई है जानकारी.moveCamera
फ़ंक्शन, मैप को सिडनी ऑस्ट्रेलिया के लिएLatLng
निर्देशांक. पहली सेटिंग मैप को जोड़ते समय कॉन्फ़िगर करें. आम तौर पर, यह मैप की जगह और कैमरे की सेटिंग होती है; जैसे देखने का कोण, मैप ओरिएंटेशन, और ज़ूम लेवल. ज़्यादा जानकारी के लिए, ज़्यादा जानकारी के लिए, कैमरा और व्यू गाइड.addMarker
फ़ंक्शन इसके निर्देशांक में एक मार्कर जोड़ता है सिडनी. ज़्यादा जानकारी के लिए मार्कर गाइड देखें.
मॉड्यूल Gradle फ़ाइल
मॉड्यूल
build.gradle
फ़ाइल में ये मैप डिपेंडेंसी शामिल हैं, जो Android के लिए Maps SDK टूल के लिए ज़रूरी है.dependencies { // Maps SDK for Android implementation 'com.google.android.gms:play-services-maps:19.0.0' }
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैMaps की डिपेंडेंसी को मैनेज करने के बारे में ज़्यादा जानने के लिए, वर्शन देखें.
एक्सएमएल लेआउट फ़ाइल
activity_maps.xml
फ़ाइल एक एक्सएमएल लेआउट फ़ाइल है जो जिसमें ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) का स्ट्रक्चर शामिल हो. फ़ाइल,res/layout
डायरेक्ट्री में मौजूद है.activity_maps.xml
फ़ाइल एक ऐसे फ़्रैगमेंट के बारे में बताती है जिसमें ये शामिल हैं एलिमेंट:tools:context
फ़्रैगमेंट की डिफ़ॉल्ट गतिविधि सेट करता हैMapsActivity
तक, जिसकी जानकारी मैप गतिविधि की फ़ाइल में दी गई है.android:name
फ़्रैगमेंट का क्लास नाम इस पर सेट करता हैSupportMapFragment
, जो मैप गतिविधि में इस्तेमाल किया जाने वाला फ़्रैगमेंट टाइप है फ़ाइल से लिए जाते हैं.
इस एक्सएमएल लेआउट फ़ाइल में यह कोड शामिल है:
<fragment xmlns:android="http://schemas.android.com/apk/res/android" xmlns:map="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools" android:id="@+id/map" android:name="com.google.android.gms.maps.SupportMapFragment" android:layout_width="match_parent" android:layout_height="match_parent" tools:context=".MapsActivity" />
ऐप्लिकेशन को डिप्लॉय करें और चलाएं
ऐप्लिकेशन को सफलतापूर्वक चलाने पर, वह एक ऐसा मैप दिखाएगा जो सिडनी ऑस्ट्रेलिया में शहर पर एक मार्कर है, जैसा कि नीचे दिए गए स्क्रीनशॉट में दिखाया गया है.
ऐप्लिकेशन को डिप्लॉय करने और चलाने के लिए:
- Android Studio में, Run मेन्यू विकल्प (या 'चलाएं' बटन आइकॉन) पर क्लिक करके आपका ऐप्लिकेशन चलाना.
- जब डिवाइस चुनने के लिए कहा जाए, तब इनमें से कोई एक विकल्प चुनें:
- अपने कंप्यूटर से कनेक्ट किए गए Android डिवाइस को चुनें.
- इसके अलावा, सिम्युलेटर लॉन्च करें रेडियो बटन चुनें. इसके बाद, आपके सेट अप किए गए वर्चुअल डिवाइस पर.
- ठीक है पर क्लिक करें. Android Studio आपका ऐप्लिकेशन बनाने के लिए, Gradle को शुरू करेगा. इसके बाद, अपने डिवाइस या एम्युलेटर पर नतीजे दिखाएं. ऐप्लिकेशन को दिखने में कुछ मिनट लग सकते हैं लॉन्च करता है.
अगले चरण
मैप सेट अप करें: यह दस्तावेज़ आपके मैप के लिए शुरुआती और रनटाइम सेटिंग को सेट अप करने का तरीका बताता है, जैसे सुविधा का इस्तेमाल किया जा सकता है.
अपने Android ऐप्लिकेशन (Kotlin) में मैप जोड़ें: यह कोडलैब (कोड बनाना सीखना) आपको एक ऐसे ऐप्लिकेशन के बारे में जानकारी देगा जो Android के लिए Maps SDK.
Maps Android KTX लाइब्रेरी का इस्तेमाल करें: Kotlin एक्सटेंशन (KTX) लाइब्रेरी की मदद से, आपको कई अन्य डिवाइसों का इस्तेमाल करने पर Android के लिए Maps SDK का इस्तेमाल करते समय, Kotlin लैंग्वेज सुविधाएं.
जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को Creative Commons Attribution 4.0 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.
आखिरी बार 2024-08-17 (UTC) को अपडेट किया गया.
[] [] { "last_modified": "आखिरी बार 2024-08-17 (UTC) को अपडेट किया गया.", "state": "" }