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

Android के लिए Maps 3D SDK की मदद से, Android ऐप्लिकेशन पर Google की 3D इमेजरी से बनाए गए इंटरैक्टिव 3D मैप दिखाए जा सकते हैं. यह मार्कर, पॉपओवर, पॉलीलाइन, पॉलीगॉन, glTF 3D मॉडल, कैमरा पाथ ऐनिमेशन, और उपयोगकर्ता के इंटरैक्शन और कैमरे के मूवमेंट के लिए कंट्रोल उपलब्ध कराता है.

Android के लिए Maps 3D SDK: मुख्य जानकारी

  • प्रॉडक्ट: Android के लिए Maps 3D SDK
  • इसे इस नाम से भी जाना जाता है: Maps 3D Android SDK
  • कैटगरी: Maps
  • प्लैटफ़ॉर्म: Android
  • इस पर काम करता है: क्लाइंट (ऐप्लिकेशन या ब्राउज़र कोड)
  • लॉन्च स्टेज: GA
  • लाइफ़साइकल: चालू है
  • खास जानकारी: Android के लिए Maps 3D SDK के बारे में खास जानकारी
  • देश या इलाके के हिसाब से उपलब्धता: सीमित. इसकी उपलब्धता, देश और इलाके के हिसाब से अलग-अलग होती है. Google Maps Platform के कवरेज पेज पर, Maps 3D (JavaScript, Android, iOS) कॉलम देखें. (कवरेज की जानकारी)

Android के लिए Maps 3D SDK: इसका इस्तेमाल कब करना चाहिए

Android के लिए Maps 3D SDK का इस्तेमाल तब करें, जब:

  • आपको किसी Android ऐप्लिकेशन में, असल दुनिया की जगहों का इंटरैक्टिव और फ़ोटोरियलिस्टिक 3D मैप दिखाना है.
  • आपको Android ऐप्लिकेशन में 3D मैप पर मार्कर, पॉपओवर, पॉलीलाइन, पॉलीगॉन या glTF 3D मॉडल दिखाने हैं.
  • आपको पहले से तय किए गए कैमरा ऐनिमेशन (फ़्लाई-टू, फ़्लाई-अराउंड) की ज़रूरत है, जो उपयोगकर्ताओं को 3D मैप पर अलग-अलग जगहों के बीच गाइड करते हैं.
  • आपको यह कंट्रोल करना है कि उपयोगकर्ता, Android ऐप्लिकेशन में 3D मैप पर कैमरे के कौनसे मूवमेंट और यूज़र इंटरफ़ेस (यूआई) कंट्रोल इस्तेमाल कर सकते हैं.

Android के लिए Maps 3D SDK का इस्तेमाल तब न करें, जब:

  • आपको एक ऐसा वेब ऐप्लिकेशन बनाना है जिसके लिए 3D मैप की ज़रूरत है. इसके बजाय, Maps JavaScript API का इस्तेमाल करें.
  • आपको कोई ऐसा iOS ऐप्लिकेशन बनाना है जिसमें 3D मैप की ज़रूरत हो. इसके बजाय, iOS के लिए Maps 3D SDK का इस्तेमाल करें.
  • आपको Android ऐप्लिकेशन में, प्रोडक्शन के लिए तैयार स्टैंडर्ड 2D स्ट्रीट मैप की ज़रूरत है (इस SDK टूल में ROADMAP मोड, एक्सपेरिमेंट के तौर पर उपलब्ध है). इसके बजाय, Maps SDK for Android का इस्तेमाल करें.

Android के लिए Maps 3D SDK: सेटअप

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

  • maven: com.google.android.gms:play-services-maps3d
  • आम तौर पर, इसका इस्तेमाल इनके साथ किया जाता है: Places SDK for Android

Android के लिए Maps 3D SDK: सामान्य गलतियां

  • समस्या: अगर मैप लोड होने के दौरान मैप मोड की जानकारी नहीं दी जाती है, तो मैप लोड नहीं होता. ठीक करें: लेआउट एक्सएमएल (map3d:mapMode) में या setMapMode/Map3DInitConfig के साथ, हमेशा Map3DMode (SATELLITE, HYBRID या ROADMAP) सेट करें. /maps/documentation/maps-3d/android-sdk/map-modes देखें.
  • समस्या: क्लिक लिसनर (मैप और मार्कर पर क्लिक), मुख्य यूज़र इंटरफ़ेस (यूआई) थ्रेड पर नहीं चलते. इसलिए, हैंडलर से यूज़र इंटरफ़ेस (यूआई) में सीधे तौर पर अपडेट नहीं किए जा सकते. ठीक करने का तरीका: यूज़र इंटरफ़ेस (यूआई) को अपडेट करने से पहले, मुख्य थ्रेड पर स्विच करें. उदाहरण के लिए, lifecycleScope.launch(Dispatchers.Main) का इस्तेमाल करें. /maps/documentation/maps-3d/android-sdk/add-a-marker देखें.
  • समस्या: मैप की स्थिति को Map3DView इंस्टेंस के साथ शेयर किया जाता है. इसलिए, पुराने व्यू के मार्कर, ओवरले, और कैमरे की पोज़िशन, नए व्यू में भी दिखती है. ठीक करने का तरीका: सिर्फ़ एक Map3DView चालू रखें; पुराने इंस्टेंस पर onDestroy() को कॉल करें और मार्कर, ओवरले को मैन्युअल तरीके से हटाएं. साथ ही, GoogleMap3D की मदद से कैमरे को रीसेट करें. /maps/documentation/maps-3d/android-sdk/add-a-3d-map देखें.
  • समस्या: डिफ़ॉल्ट रूप से, बुनियादी मैप पर मौजूद किसी लोकप्रिय जगह पर टैप करने से, Places यूज़र इंटरफ़ेस (यूआई) विजेट दिखता है. इसके लिए, Places SDK टूल की डिपेंडेंसी भी ज़रूरी है. ठीक करने का तरीका: Places SDK for Android डिपेंडेंसी जोड़ें. साथ ही, अगर आपको डिफ़ॉल्ट विजेट नहीं चाहिए, तो उसे हटाने के लिए OnMap3DClickListener में onMap3DClick से true को रिटर्न करें. /maps/documentation/maps-3d/android-sdk/points-of-interest देखें.

Android के लिए Maps 3D SDK की मदद से क्या-क्या किया जा सकता है

हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.