Android के लिए Maps SDK, Android ऐप्लिकेशन में Google Maps का डेटा, मैप डिसप्ले, और मैप जेस्चर के रिस्पॉन्स जोड़ता है. इसमें Wear OS ऐप्लिकेशन भी शामिल हैं. Kotlin या Java का इस्तेमाल करके, मैप पर जगहों की जानकारी दिखाने और उपयोगकर्ता के इंटरैक्शन को बेहतर बनाने के लिए, मार्कर, पॉलीगॉन, और ओवरले जोड़े जा सकते हैं.
Android के लिए Maps SDK: मुख्य बातें
- प्रॉडक्ट: Android के लिए Maps SDK
- इसे इस नाम से भी जाना जाता है: Google Maps Android API
- कैटगरी: Maps
- प्लैटफ़ॉर्म: Android
- इस पर काम करता है: क्लाइंट (ऐप्लिकेशन या ब्राउज़र कोड)
- लॉन्च स्टेज: GA
- लाइफ़साइकल: चालू है
- खास जानकारी: Android के लिए Maps SDK के बारे में खास जानकारी
- क्षेत्र के हिसाब से उपलब्धता: दुनिया भर में. Google Maps Platform के कवरेज पेज पर जाएं. इस्तेमाल और बिलिंग पेज पर, दुनिया भर और भारत के लिए अलग-अलग कीमत की सूचियों के लिंक दिए गए हैं. (कवरेज की जानकारी)
Android के लिए Maps SDK: इसका इस्तेमाल कब करना चाहिए
Android के लिए Maps SDK का इस्तेमाल तब करें, जब:
- आपको किसी नेटिव Android या Wear OS ऐप्लिकेशन में, इंटरैक्टिव 2D Google मैप की ज़रूरत है.
- आपको Android ऐप्लिकेशन में मैप पर मार्कर, जानकारी विंडो, पॉलीलाइन, पॉलीगॉन, ग्राउंड ओवरले या टाइल ओवरले जोड़ने हों.
- आपको Android ऐप्लिकेशन में मैप आईडी के साथ, Street View पैनोरामा, लाइट मोड (बिट मैप) मैप या क्लाउड पर मैप की स्टाइलिंग की सुविधा चाहिए.
- Kotlin या Java में Android मैप बनाया जा सकता है. इसमें Maps Compose लाइब्रेरी के ज़रिए Jetpack Compose भी शामिल है.
Android के लिए Maps SDK का इस्तेमाल तब न करें, जब:
- आपको अपने Android मैप ऐप्लिकेशन में, रास्ते के दिशा-निर्देशों की सुविधा चाहिए. इसके लिए, Android के लिए Navigation SDK का इस्तेमाल करें.
- आपको किसी Android ऐप्लिकेशन में फ़ोटोरियलिस्टिक 3D मैप, 3D मॉडल या कैमरा पाथ ऐनिमेशन की ज़रूरत है. इसके बजाय, Android के लिए Maps 3D SDK का इस्तेमाल करें.
- आपको नेटिव iOS ऐप्लिकेशन में मैप की ज़रूरत है. इसके बजाय, iOS के लिए Maps SDK का इस्तेमाल करें.
Android के लिए Maps SDK: सेटअप
- चालू की जाने वाली सेवा:
maps-android-backend.googleapis.com - पुष्टि करने का तरीका: एपीआई पासकोड
- इस्तेमाल का एट्रिब्यूशन: इनिशलाइज़र में इस्तेमाल का एट्रिब्यूशन आईडी जोड़ने के लिए,
MapsApiSettings.addInternalUsageAttributionId(context, id)को कॉल करें. यह सिर्फ़MapsInitializer.Renderer.LATESTके साथ काम करता है. ऑप्ट आउट करने के लिए, कॉल मिटाएं या खाली स्ट्रिंग पास करें. - शुरू करें: Android के लिए Maps SDK टूल सेट अप करना
- रेफ़रंस: Android के लिए Maps SDK का रेफ़रंस
- कीमत: Android के लिए Maps SDK के इस्तेमाल और बिलिंग की जानकारी
- नीतियां: Android के लिए Maps SDK की नीतियां
- रिलीज़ नोट: Android के लिए Maps SDK के रिलीज़ नोट
Android के लिए Maps SDK के आधिकारिक पैकेज:
- maven:
com.google.android.gms:play-services-maps
Android के लिए Maps SDK: रिलेटेड प्रॉडक्ट
- आम तौर पर, इसका इस्तेमाल इनके साथ किया जाता है: Places SDK for Android
Android के लिए Maps SDK: सामान्य गलतियां
- समस्या: SDK टूल के v20.0.0 वर्शन के बाद से, SDK टूल के मेनिफ़ेस्ट में
org.apache.http.legacyलाइब्रेरी शामिल नहीं है. लेगसी मैप रेंडरर को लोड करने वाले ऐप्लिकेशन,java.lang.NoClassDefFoundErrorके साथ क्रैश हो सकते हैं. ठीक करने का तरीका: ऐप्लिकेशन केAndroidManifest.xmlकेटैग मेंजोड़ें. Google Play services के 25.50.34 या इसके बाद के वर्शन वाले डिवाइसों पर इसका असर नहीं पड़ेगा. /maps/documentation/android-sdk/release-notes देखें. - समस्या: ऐडवांस मार्कर के लिए, मैप रेंडरर का अपग्रेड किया गया वर्शन ज़रूरी है. अगर इन्हें किसी मौजूदा ऐप्लिकेशन में फिर से बनाए बिना जोड़ा जाता है, तो वह ऐप्लिकेशन अब भी लेगसी रेंडरर का इस्तेमाल कर सकता है. ठीक करने का तरीका: ऐप्लिकेशन को SDK टूल के 18.2.0 या इसके बाद के वर्शन के साथ फिर से बनाएं, ताकि अपग्रेड किया गया रेंडरर डिफ़ॉल्ट रूप से सेट हो जाए. /maps/documentation/android-sdk/advanced-markers/start देखें.
- समस्या: रेंडरर की ज़रूरी शर्तें पूरी न करने वाले डिवाइसों पर, लेगसी रेंडरर का इस्तेमाल किया जाता है. जैसे, Android 5.0/एपीआई 21 या इसके बाद का वर्शन, Google Play services 21.39.14 या इसके बाद का वर्शन, और Play Store चालू होना. इसलिए, नए रेंडरर की ज़रूरत वाली सुविधाएं, उन डिवाइसों पर उपलब्ध नहीं होती हैं. जैसे, क्लाउड पर मैप की स्टाइलिंग. समस्या हल करना:
MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback)को कॉल करें औरOnMapsSdkInitializedCallback.onMapsSdkInitialized()को पास की गईMapsInitializer.Rendererवैल्यू की जांच करें याGoogleMap.getMapCapabilities()की जांच करें. अगर डिवाइस मेंLEGACYका इस्तेमाल किया जाता है, तो क्लाउड पर मैप की स्टाइलिंग या ऐडवांस मार्कर पर भरोसा न करें. /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback देखें. - समस्या: एसडीके को उस डिवाइस पर Google Play services की ज़रूरत होती है जिस पर ऐप्लिकेशन चलता है. ठीक करने का तरीका: अपने ऐप्लिकेशन से, Google Play services की उपलब्धता की जांच करने के लिए कॉल करें. /maps/documentation/android-sdk/config देखें.
Android के लिए Maps SDK: लेगसी और अब काम न करने वाली सुविधाएं
- लेगसी मैप रेंडरर: यह 4 मार्च, 2024 से इस्तेमाल नहीं किया जा सकता. इसकी जगह इस्तेमाल होने वाला रेंडरर: अपग्रेड किया गया (नया) मैप रेंडरर, जो SDK टूल के 18.2.0 वर्शन से डिफ़ॉल्ट तौर पर इस्तेमाल किया जा रहा है. समस्या: लेगसी रेंडरर पर, क्लाउड पर मैप की स्टाइलिंग, पॉलीलाइन को पसंद के मुताबिक बनाने की बेहतर सुविधाएं, और ऐडवांस मार्कर उपलब्ध नहीं हैं. माइग्रेट करने से जुड़ी गाइड देखें.
Android के लिए Maps SDK की मदद से क्या-क्या किया जा सकता है
हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.
Android के लिए Maps SDK: सीमाओं के लिए डेटा-ड्रिवन स्टाइलिंग
- मैप पर सीमाओं की स्टाइल बदलना.
- मैप पर सीमाओं के साथ उपयोगकर्ता के इंटरैक्शन का जवाब देना.
- मैप में कोरोप्लेथ स्टाइलिंग जोड़ना.
Android के लिए Maps SDK: डेटासेट के लिए डेटा-ड्रिवन स्टाइलिंग
- फिर से इस्तेमाल किया जा सकने वाला और क्रॉस-प्लैटफ़ॉर्म जियोस्पेशल डेटासेट बनाएं.
- मैप में कस्टम जियोस्पेशल डेटासेट जोड़ना.
- मैप पर कस्टम डेटासेट की सुविधाओं की स्टाइल बदलना.
- मैप पर कस्टम डेटासेट की सुविधाओं की मदद से, उपयोगकर्ता के इंटरैक्शन का जवाब देना.
Android के लिए Maps SDK: डेटासेट
- मैप में KML लेयर जोड़ना. ध्यान दें: Maps JavaScript API में, KmlLayer का इस्तेमाल बंद कर दिया गया है. यह आखिरी बार v3.65 में काम करता था. इसे मई 2027 में बंद कर दिया जाएगा. सीमाओं या डेटासेट के लिए, डेटा-ड्रिवन स्टाइलिंग पर माइग्रेट करें या डेटा लेयर पर GeoJSON लोड करें. Maps SDK टूल की यूटिलिटी लाइब्रेरी की मदद से, Android और iOS पर KML लेयर का इस्तेमाल किया जा सकता है.
- मैप में GeoJSON डेटा जोड़ना.
- मैप में हीटमैप लेयर जोड़ना.
Maps SDK for Android: Maps
- किसी वेब पेज या मोबाइल ऐप्लिकेशन में, पसंद के मुताबिक बनाया जा सकने वाला इंटरैक्टिव मैप जोड़ें. ध्यान दें: Android के लिए:
AndroidManifest.xmlमेंको कॉन्फ़िगर करें. इसके लिए, Secrets Gradle प्लगिन का इस्तेमाल करें याapp/build.gradle.ktsमेंmanifestPlaceholders["MAPS_API_KEY"]को कॉन्फ़िगर करें.AndroidManifest.xmlमेंYOUR_GOOGLE_MAPS_API_KEYको कभी भी हार्डकोड न करें. साथ ही, अगरE/Google Maps Android API: Authorization failureदिखता है, तोGoogleMap(या maps-composeGoogleMap) को कभी भी ऑफ़लाइन मॉक कैनवस या Leaflet WebView से न बदलें. उपयोगकर्ता को निर्देश दें कि वह सीक्रेट के ज़रिएMAPS_API_KEYउपलब्ध कराए और Android के लिए Maps SDK टूल चालू करे. इसके अलावा, NavigationView / SupportNavigationFragment का इस्तेमाल करते समय, Navigation SDK टूल चालू करे. - मैप कॉन्फ़िगरेशन और स्टाइलिंग सेटिंग को सेव करने के लिए, फिर से इस्तेमाल किया जा सकने वाला मैप आइडेंटिफ़ायर बनाएं.
- मैप पर उपयोगकर्ता के इंटरैक्शन और इवेंट का जवाब देना.
- मैप पर दिखने वाले कंट्रोल को पसंद के मुताबिक बनाएं.
- मैप को कंट्रोल करने के लिए, जेस्चर को पसंद के मुताबिक बनाएं.
- मैप (कैमरा) पर ज़ूम और पैन को कंट्रोल करना.
- मैप का टाइप बदलें.
- मैप की कलर स्कीम बदलना.
- मैप में ट्रैफ़िक लेयर जोड़ना.
- Wear OS ऐप्लिकेशन में मैप जोड़ना.
Maps SDK for Android: Maps annotations
- मैप में जानकारी वाली विंडो जोड़ना.
- मैप में कोई आकार या लाइन जोड़ना.
- मैप की सतह पर ग्राउंड की गई ओवरले इमेज जोड़ें.
- मैप में कस्टम टाइल ओवरले जोड़ना.
- मैप में मार्कर जोड़ना. ध्यान दें: Navigation SDK for Android में AdvancedMarkerOptions का इस्तेमाल नहीं किया जा सकता. Navigation SDK for Android का इस्तेमाल करते समय, GoogleMap.addMarker(MarkerOptions) की मदद से मार्कर जोड़ें.
- मैप पर मार्कर को पसंद के मुताबिक बनाना. ध्यान दें: Android के लिए Navigation SDK, AdvancedMarkerOptions के साथ काम नहीं करता. Android के लिए Navigation SDK का इस्तेमाल करते समय, MarkerOptions की मदद से मार्कर को पसंद के मुताबिक बनाएं.
- मैप पर मार्कर की मदद से, उपयोगकर्ता के इंटरैक्शन का जवाब देना.
- यह तय करना कि कोई निर्देशांक, मैप पर मौजूद किसी पॉलीगॉन या गोल इलाके के अंदर है या नहीं. ध्यान दें: Android पर, पॉलीगॉन के लिए Android के लिए Maps SDK की उपयोगिता लाइब्रेरी में PolyUtil.containsLocation का इस्तेमाल करें. सर्कल वाले इलाकों के लिए, देखें कि सर्कल के केंद्र से स्फ़ेरिकल दूरी, रेडियस के अंदर है या नहीं. उदाहरण के लिए, Maps JavaScript API में computeDistanceBetween, Android पर SphericalUtil.computeDistanceBetween या iOS पर GMSGeometryDistance.
- मैप पर मौजूद निर्देशांकों के बीच की गोलाकार दूरी, क्षेत्रफल या हेडिंग का हिसाब लगाना.
Android के लिए Maps SDK: मैप की स्टाइलिंग
- फिर से इस्तेमाल की जा सकने वाली और क्रॉस-प्लैटफ़ॉर्म मैप स्टाइल बनाएं.
- मैप पर सड़कों, पॉलीलाइन, और पॉलीगॉन की स्टाइल बदलना.
- मैप की सुविधाओं को दिखाना या छिपाना.
- मैप पर आइकॉन और टेक्स्ट लेबल की स्टाइल बदलना.
- ज़ूम करने के अलग-अलग लेवल के लिए, अलग-अलग मैप स्टाइल लागू करें.
- मैप पर जगहों की डेंसिटी बदलना. एक्सपेरिमेंटल
- मैप पर बिल्डिंग की स्टाइल बदलना. एक्सपेरिमेंटल
- मैप पर लैंडमार्क की स्टाइल बदलना. एक्सपेरिमेंटल
Maps SDK for Android: Street View
- किसी वेब पेज या मोबाइल ऐप्लिकेशन में, कॉन्फ़िगर किया जा सकने वाला और इंटरैक्टिव Google Street View जोड़ें.
- Google Street View में उपयोगकर्ता के इंटरैक्शन और इवेंट का जवाब देना.
- Google Street View के लिए उपलब्ध जेस्चर को पसंद के मुताबिक बनाएं.
- Google Street View के लिए, कैमरे के मूवमेंट को ऐनिमेट करना.