iOS के लिए Maps SDK की मदद से, iOS ऐप्लिकेशन में Google Maps के डेटा पर आधारित मैप जोड़े जा सकते हैं. यह एसडीके, Google Maps के सर्वर के ऐक्सेस, मैप के डिसप्ले, और उपयोगकर्ता के जेस्चर के जवाब को मैनेज करता है. साथ ही, इसकी मदद से मैप में मार्कर, पॉलीलाइन, ग्राउंड ओवरले, और जानकारी विंडो जोड़ी जा सकती हैं.
iOS के लिए Maps SDK: मुख्य जानकारी
- प्रॉडक्ट: iOS के लिए Maps SDK
- इसे इस नाम से भी जाना जाता है: iOS के लिए Google Maps SDK
- कैटगरी: Maps
- प्लैटफ़ॉर्म: iOS
- इस पर काम करता है: क्लाइंट (ऐप्लिकेशन या ब्राउज़र कोड)
- लॉन्च स्टेज: GA
- लाइफ़साइकल: चालू है
- खास जानकारी: iOS के लिए Maps SDK के बारे में खास जानकारी
- क्षेत्र के हिसाब से उपलब्धता: दुनिया भर में. Google Maps Platform के कवरेज पेज पर जाएं. इस्तेमाल और बिलिंग पेज पर, दुनिया भर और भारत के लिए अलग-अलग कीमत की सूचियों के लिंक दिए गए हैं. (कवरेज की जानकारी)
iOS के लिए Maps SDK: इसका इस्तेमाल कब करना चाहिए
iOS के लिए Maps SDK का इस्तेमाल तब करें, जब:
- आपको नेटिव iOS ऐप्लिकेशन में, जेस्चर हैंडलिंग की सुविधा वाला इंटरैक्टिव Google मैप चाहिए.
- आपको iOS ऐप्लिकेशन में मैप पर मार्कर, पॉलीलाइन, ग्राउंड ओवरले या जानकारी विंडो जोड़नी हों.
- आपको किसी iOS ऐप्लिकेशन में Street View पैनोरमा दिखाने हों.
- आपको मैप दिखाने वाले iOS ऐप्लिकेशन से, निर्देशांकों को पतों में रिवर्स जियोकोड करना है.
iOS के लिए Maps SDK का इस्तेमाल तब न करें, जब:
- आपको किसी iOS ऐप्लिकेशन में फ़ोटोरियलिस्टिक 3D मैप की ज़रूरत है. इसके बजाय, iOS के लिए Maps 3D SDK का इस्तेमाल करें.
- आपको अपने ऐप्लिकेशन में मैप रेंडर करने के बजाय, Google Maps ऐप्लिकेशन में कोई जगह या निर्देश खोलने होंगे. इसके बजाय, Maps के यूआरएल इस्तेमाल करें.
iOS के लिए Maps SDK: सेटअप
- चालू की जाने वाली सेवा:
maps-ios-backend.googleapis.com - पुष्टि करने का तरीका: एपीआई पासकोड
- इस्तेमाल का एट्रिब्यूशन: इनिशलाइज़र में इस्तेमाल का एट्रिब्यूशन आईडी जोड़ने के लिए,
GMSServicesक्लास मेथडaddInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:)) को कॉल करें. ऑप्ट आउट करने के लिए, कॉल को मिटाएं या खाली स्ट्रिंग पास करें. - शुरू करें: iOS के लिए Maps SDK सेट अप करना
- रेफ़रंस: iOS के लिए Maps SDK का रेफ़रंस
- कीमत: iOS के लिए Maps SDK के इस्तेमाल और बिलिंग की जानकारी
- नीतियां: iOS के लिए Maps SDK की नीतियां
- रिलीज़ नोट: iOS के लिए Maps SDK के रिलीज़ नोट
iOS के लिए Maps SDK के आधिकारिक पैकेज:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
iOS के लिए Maps SDK: इससे जुड़े प्रॉडक्ट
- आम तौर पर, इनके साथ इस्तेमाल किया जाता है: Geocoding API, iOS के लिए Places SDK
iOS के लिए Maps SDK: आम गलतियां
- समस्या: एसडीके, मर्ज की जा सकने वाली लाइब्रेरी के साथ काम नहीं करता. Xcode में, मर्ज की जा सकने वाली लाइब्रेरी बनाने की सुविधा चालू करने पर, रिलीज़ के लिए तैयार बिल्ड में लिंकर से जुड़ी गड़बड़ियां होती हैं. समस्या हल करने का तरीका: Build Mergeable Library सेटिंग को No पर सेट रखें. यह डिफ़ॉल्ट सेटिंग होती है. /maps/documentation/ios-sdk/config देखें.
- समस्या:
LSApplicationQueriesSchemesएंट्री के बिना, मैप पर Google के लोगो पर टैप करने से,comgooglemaps://औरgooglechromes://के लिए-canOpenURLगड़बड़ियां लॉग होती हैं. ठीक करें:Info.plistमें,LSApplicationQueriesSchemesमेंgooglechromesऔरcomgooglemapsजोड़ें. /maps/documentation/ios-sdk/config देखें. - समस्या: iOS ऐप्लिकेशन एक्सटेंशन (उदाहरण के लिए, कस्टम कीबोर्ड) में SDK टूल का इस्तेमाल करने पर, हो सकता है कि वह काम न करे. ऐसा मेमोरी से जुड़ी पाबंदियों की वजह से होता है. ठीक करने का तरीका: SDK टूल का इस्तेमाल मुख्य ऐप्लिकेशन में करें, न कि ऐप्लिकेशन एक्सटेंशन में. /maps/documentation/ios-sdk/overview देखें.
- समस्या: SDK टूल को iPadOS 13 और इसके बाद के वर्शन की कई विंडो या एक साथ कई इंस्टेंस के लिए ऑप्टिमाइज़ नहीं किया गया है. साथ ही, हो सकता है कि यह सही तरीके से काम न करे. ठीक करने का तरीका: iPad पर मल्टी-विंडो मोड में, मैप के अलग-अलग मामलों को ध्यान से टेस्ट करें या एक साथ कई मैप इंस्टेंस इस्तेमाल करने से बचें. /maps/documentation/ios-sdk/overview देखें.
iOS के लिए Maps SDK: लेगसी और अब काम न करने वाली सुविधाएं
- OpenGL रेंडरर और
setMetalRendererEnabled: 19-05-2025 से बंद कर दिया गया है. बदलाव: Metal रेंडरर (v8.0.0 से डिफ़ॉल्ट);setMetalRendererEnabledको हटाएं. समस्या: v9.0.0 (28-05-2024) में इस फ़ील्ड को बंद कर दिया गया था और v10.0.0 में हटा दिया गया था. इसलिए,GMSServicesअबsetMetalRendererEnabled:को नहीं दिखाता. GoogleMapsM4Bमॉड्यूल: 19-05-2025 से बंद कर दिया गया है. बदलाव:GoogleMapsM4Bपॉड या फ़्रेमवर्क को हटाएं. यह पुराने बिलिंग प्लान से जुड़ा है. लक्षण: 20-02-2024 को बंद कर दिया गया; Swift पैकेज के v9.0.0 और SDK टूल के v10.0.0 से हटा दिया गया.- CocoaPods डिस्ट्रिब्यूशन: 6 अगस्त, 2026 से इस्तेमाल नहीं किया जा सकता. विकल्प: Swift Package Manager. समस्या का ब्यौरा: 18-08-2025 से मेंटेनेंस मोड में है. वर्शन 11.0.0 से इसे बंद कर दिया गया है. माइग्रेट करने से जुड़ी गाइड देखें.
- Carthage installation: Deprecated since 2022-06-27. विकल्प: Swift Package Manager. समस्या: Carthage, iOS 13 और इसके बाद के वर्शन के लिए उपलब्ध लाइब्रेरी के साथ काम नहीं करता. Carthage के ज़रिए उपलब्ध नया वर्शन 6.2.1 है. माइग्रेट करने से जुड़ी गाइड देखें.
iOS के लिए Maps SDK की मदद से क्या किया जा सकता है
हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.
iOS के लिए Maps SDK: सीमाओं के लिए डेटा-ड्रिवन स्टाइलिंग
- मैप पर सीमाओं की स्टाइल बदलना.
- मैप पर सीमाओं के साथ उपयोगकर्ता के इंटरैक्शन का जवाब देना.
- मैप में कोरोप्लेथ स्टाइलिंग जोड़ना.
iOS के लिए Maps SDK: डेटासेट के लिए डेटा-ड्रिवन स्टाइलिंग
- फिर से इस्तेमाल किया जा सकने वाला और क्रॉस-प्लैटफ़ॉर्म जियोस्पेशल डेटासेट बनाएं.
- मैप में कस्टम जियोस्पेशल डेटासेट जोड़ना.
- मैप पर कस्टम डेटासेट की सुविधाओं की स्टाइल बदलना.
- मैप पर कस्टम डेटासेट की सुविधाओं की मदद से, उपयोगकर्ता के इंटरैक्शन का जवाब देना.
iOS के लिए Maps SDK: डेटासेट
- मैप में KML लेयर जोड़ना. ध्यान दें: Maps JavaScript API में, KmlLayer का इस्तेमाल बंद कर दिया गया है. यह आखिरी बार v3.65 में काम करता था. इसे मई 2027 में बंद कर दिया जाएगा. सीमाओं या डेटासेट के लिए, डेटा-ड्रिवन स्टाइलिंग पर माइग्रेट करें या डेटा लेयर पर GeoJSON लोड करें. Maps SDK टूल की यूटिलिटी लाइब्रेरी की मदद से, Android और iOS पर KML लेयर का इस्तेमाल किया जा सकता है.
- मैप में GeoJSON डेटा जोड़ना.
- मैप में हीटमैप लेयर जोड़ना.
iOS के लिए Maps SDK: जियोकोडिंग
iOS के लिए Maps SDK: 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 टूल चालू करे. - मैप कॉन्फ़िगरेशन और स्टाइलिंग सेटिंग को सेव करने के लिए, फिर से इस्तेमाल किया जा सकने वाला मैप आइडेंटिफ़ायर बनाएं.
- मैप पर उपयोगकर्ता के इंटरैक्शन और इवेंट का जवाब देना.
- मैप पर दिखने वाले कंट्रोल को पसंद के मुताबिक बनाएं.
- मैप को कंट्रोल करने के लिए, जेस्चर को पसंद के मुताबिक बनाएं.
- मैप (कैमरा) पर ज़ूम और पैन को कंट्रोल करना.
- मैप का टाइप बदलें.
- मैप की कलर स्कीम बदलना.
- मैप में ट्रैफ़िक लेयर जोड़ना.
- किसी तय इलाके में पॉइंट खोजने के लिए, क्वाडट्री बनाएं.
iOS के लिए Maps SDK: Maps एनोटेशन
- मैप में जानकारी वाली विंडो जोड़ना.
- मैप में कोई आकार या लाइन जोड़ना.
- मैप की सतह पर ग्राउंड की गई ओवरले इमेज जोड़ें.
- मैप में कस्टम टाइल ओवरले जोड़ना.
- मैप में मार्कर जोड़ना. ध्यान दें: 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.
- मैप पर मौजूद निर्देशांकों के बीच की गोलाकार दूरी, क्षेत्रफल या हेडिंग का हिसाब लगाना.
iOS के लिए Maps SDK: मैप की स्टाइलिंग
- फिर से इस्तेमाल की जा सकने वाली और क्रॉस-प्लैटफ़ॉर्म मैप स्टाइल बनाएं.
- मैप पर सड़कों, पॉलीलाइन, और पॉलीगॉन की स्टाइल बदलना.
- मैप की सुविधाओं को दिखाना या छिपाना.
- मैप पर आइकॉन और टेक्स्ट लेबल की स्टाइल बदलना.
- ज़ूम करने के अलग-अलग लेवल के लिए, अलग-अलग मैप स्टाइल लागू करें.
- मैप पर जगहों की डेंसिटी बदलना. एक्सपेरिमेंटल
- मैप पर बिल्डिंग की स्टाइल बदलना. एक्सपेरिमेंटल
- मैप पर लैंडमार्क की स्टाइल बदलना. एक्सपेरिमेंटल
iOS के लिए Maps SDK: Street View
- किसी वेब पेज या मोबाइल ऐप्लिकेशन में, कॉन्फ़िगर किया जा सकने वाला और इंटरैक्टिव Google Street View जोड़ें.
- Google Street View में मार्कर या ओवरले जोड़ना.
- Google Street View में उपयोगकर्ता के इंटरैक्शन और इवेंट का जवाब देना.
- Google Street View के लिए उपलब्ध जेस्चर को पसंद के मुताबिक बनाएं.
- Google Street View के लिए, कैमरे के मूवमेंट को ऐनिमेट करना.