iOS के लिए Navigation SDK टूल के बारे में खास जानकारी

iOS के लिए Navigation SDK, iOS ऐप्लिकेशन में Google Maps के रास्ते के दिशा-निर्देशों की सुविधा जोड़ता है. इसमें यूज़र इंटरफ़ेस (यूआई) को पसंद के मुताबिक बनाने और रास्ते को कॉन्फ़िगर करने की सुविधा भी मिलती है. यह iOS के लिए Maps SDK को एक्सटेंड करता है. इससे मैप लेयर मिलती है. इसे ऐप्लिकेशन में भी इंस्टॉल करना ज़रूरी है.

iOS के लिए Navigation SDK टूल: मुख्य बातें

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

iOS के लिए Navigation SDK: इसका इस्तेमाल कब करें

iOS के लिए Navigation SDK का इस्तेमाल तब करें, जब:

  • आपको अपने नेटिव iOS ऐप्लिकेशन में, Google Maps के रास्ते के दिशा-निर्देश देने की सुविधा चाहिए, ताकि उपयोगकर्ताओं को ऐप्लिकेशन स्विच न करना पड़े.
  • आपको नेविगेशन यूज़र इंटरफ़ेस (यूआई), मैप की स्टाइल, कैमरा या लेआउट को पसंद के मुताबिक बनाना होगा, ताकि गाइडेंस के दौरान वे आपके ब्रैंड के मुताबिक दिखें.
  • आपको Routes API या Route Optimization API से, रास्ते की प्राथमिकताएं, कई वेपॉइंट या रूट टोकन चाहिए.
  • आपको कस्टम गाइडेंस यूज़र इंटरफ़ेस (यूआई) या CarPlay के लिए, यात्रा से जुड़े इवेंट (जगह की जानकारी, पहुंचने का समय, रास्ते में बदलाव, ईटीए) या मोड़-दर-मोड़ डेटा फ़ीड की ज़रूरत है.

iOS के लिए Navigation SDK का इस्तेमाल तब न करें, जब:

  • कोई Android ऐप्लिकेशन बनाया जा रहा है. इसके बजाय, Android के लिए Navigation SDK का इस्तेमाल करें.
  • आपको Flutter या React Native ऐप्लिकेशन बनाना है. इसके बजाय, Flutter और React Native के लिए Google Navigation का इस्तेमाल करें.
  • आपको सर्वर पर सिर्फ़ रास्ते, ईटीए या दूरियों की जानकारी चाहिए. साथ ही, आपको ऐप्लिकेशन में दिशा-निर्देशों की ज़रूरत नहीं है. इसके बजाय, Routes API का इस्तेमाल करें.

iOS के लिए Navigation SDK टूल: सेटअप

iOS पैकेज के लिए आधिकारिक Navigation SDK टूल:

  • swift_package: https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)

iOS के लिए Navigation SDK टूल के साथ इस्तेमाल न किए जाने वाले पैकेज:

  • cocoapods: GoogleNavigation. CocoaPods डिस्ट्रिब्यूशन को वर्शन 11.0.0 से बंद कर दिया गया है. साथ ही, यह 18-08-2025 को मेंटेनेंस मोड में चला गया है. इसके बजाय, Swift Package Manager का इस्तेमाल करें.

iOS के लिए Navigation SDK टूल: आम गलतियां

  • समस्या: नेविगेशन के दौरान स्क्रीन की रोशनी कम हो जाती है या स्क्रीन बंद हो जाती है. ऐसा इसलिए होता है, क्योंकि SDK टूल, iOS के आइडल टाइमर को बंद नहीं करता. ठीक करने का तरीका: नेविगेट करते समय, UIApplication.shared.isIdleTimerDisabled = true सेट करें. /maps/documentation/navigation/ios-sdk/route देखें.
  • समस्या: एसडीके के आने वाले किसी मुख्य रिलीज़ में, अल्टीमीटर (CMAltimeter) का इस्तेमाल किया जाएगा. साथ ही, जिन ऐप्लिकेशन के Info.plist में NSMotionUsageDescription नहीं होगा वे शुरू होते ही क्रैश हो जाएंगे. कुंजी को अभी जोड़ने से, मौजूदा व्यवहार पर कोई असर नहीं पड़ता. ठीक करने का तरीका: Info.plist में NSMotionUsageDescription (Privacy - Motion Usage Description) जोड़ें. /maps/documentation/navigation/ios-sdk/route देखें.
  • समस्या: iOS के लिए Places SDK, Navigation SDK के साथ बंडल नहीं किया गया है (Places SDK 5.0 के बाद से). इसलिए, Places की क्लास मौजूद नहीं हैं. ठीक करने का तरीका: Places SDK for iOS को अलग से इंस्टॉल करें. इसके लिए, Navigation SDK के वर्शन का ही इस्तेमाल करें. /maps/documentation/navigation/ios-sdk/xcode-setup देखें.
  • समस्या: अगर ऐप्लिकेशन का travelMode, driving या twoWheeler नहीं है, तो रूट टोकन की मदद से डेस्टिनेशन सेट करने पर, .travelModeUnsupported गड़बड़ी का मैसेज दिखता है. ठीक करने का तरीका: mapView.travelMode को .driving या .twoWheeler पर सेट करें. रास्ते के लिए इस्तेमाल किए गए मोड को देखने के लिए, resolvedParameters.travelMode को चुनें. /maps/documentation/navigation/ios-sdk/route-customizations देखें.

iOS के लिए Navigation SDK: लेगसी और अब काम न करने वाली सुविधाएं

  • CocoaPods डिस्ट्रिब्यूशन: 6 अगस्त, 2026 से इस्तेमाल नहीं किया जा सकता. विकल्प: Swift Package Manager. समस्या का ब्यौरा: 18-08-2025 से मेंटेनेंस मोड चालू है. साल 2026 की दूसरी तिमाही के बाद, CocoaPods के नए वर्शन उपलब्ध नहीं होंगे. माइग्रेट करने से जुड़ी गाइड देखें.
  • GMSNavigator setDestinations:callback:, setDestinations:routingOptions:callback:, setDestinations:routeToken:callback: (GMSRouteStatusCallback): यह 02-11-2026 से अब काम नहीं करता. बदलाव: setDestinations:completionHandler:, setDestinations:routingOptions:completionHandler:, setDestinationsWithToken:completionHandler: (GMSNavigationRouteCompletionHandler).
  • GMSServices इंस्टेंस प्रॉपर्टी appCheckTokenProvider: इस्तेमाल नहीं की जा सकती. यह बदलाव 24-09-2026 से लागू होगा. बदलाव: क्लास प्रॉपर्टी GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]). समस्या: 11.1.0 में, GMSServices.sharedServices() की मदद से App Check को कॉन्फ़िगर नहीं किया जा सका. माइग्रेट करने से जुड़ी गाइड देखें.
  • GMSNavigator continueToNextDestination: यह सुविधा 7 अप्रैल, 2026 से बंद कर दी जाएगी. बदलाव: GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights और showsStopSigns: 6 अगस्त, 2026 से इस्तेमाल नहीं किया जा सकता. विकल्प: किसी विकल्प की ज़रूरत नहीं है. नेविगेशन के दौरान, ट्रैफ़िक लाइट और स्टॉप साइन डिफ़ॉल्ट रूप से दिखते हैं.
  • .terrain मैप टाइप, ऐक्टिव नेविगेशन के दौरान: इसे 2026-08-06 से बंद कर दिया गया है. बदलाव: .normal (kGMSTypeNormal), .satellite या .hybrid मैप टाइप.
  • GMSNavigatorDelegate और GMSRoadSnappedLocationProviderDelegate प्रोटोकॉल: 13-05-2021 से इस्तेमाल नहीं किए जा रहे हैं. इनकी जगह इस्तेमाल करें: GMSNavigatorListener और GMSRoadSnappedLocationProviderListener (-addListener: के साथ जोड़ें; GMSNavigator पर timeUpdateThreshold और distanceUpdateThreshold सेट करें). माइग्रेट करने से जुड़ी गाइड देखें.

iOS के लिए Navigation SDK की मदद से क्या किया जा सकता है

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

iOS के लिए Navigation SDK टूल: मैप की स्टाइलिंग

iOS के लिए Navigation SDK: नेविगेशन