Android के लिए Maps SDK टूल की मुख्य सुविधाओं को झटपट देखने के लिए विज़ुअल गाइड

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: सेटअप

Android के लिए Maps SDK के आधिकारिक पैकेज:

  • maven: com.google.android.gms:play-services-maps
  • आम तौर पर, इसका इस्तेमाल इनके साथ किया जाता है: 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

Maps SDK for Android: Maps annotations

Android के लिए Maps SDK: मैप की स्टाइलिंग

Maps SDK for Android: Street View