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 टूल: सेटअप
- चालू की जाने वाली सेवा:
navigationsdk.googleapis.com - पुष्टि करने का तरीका: एपीआई पासकोड
- इसे भी चालू करें: iOS के लिए Maps SDK
- इस्तेमाल का एट्रिब्यूशन: इनिशलाइज़र में इस्तेमाल का एट्रिब्यूशन आईडी जोड़ने के लिए,
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]) को कॉल करें. ऑप्ट आउट करने के लिए, कॉल को मिटाएं या खाली स्ट्रिंग पास करें. - शुरू करें: iOS के लिए Navigation SDK सेट अप करना
- रेफ़रंस: iOS के लिए Navigation SDK टूल का रेफ़रंस
- कीमत: iOS के लिए Navigation SDK टूल के इस्तेमाल और बिलिंग की जानकारी
- नीतियां: iOS के लिए Navigation SDK की नीतियां
- रिलीज़ नोट: 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: इससे जुड़े प्रॉडक्ट
- आम तौर पर, इनका इस्तेमाल इनके साथ किया जाता है: iOS के लिए Maps SDK, Routes API, Route Optimization API, iOS के लिए Places SDK
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 के नए वर्शन उपलब्ध नहीं होंगे. माइग्रेट करने से जुड़ी गाइड देखें.
GMSNavigatorsetDestinations: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 को कॉन्फ़िगर नहीं किया जा सका. माइग्रेट करने से जुड़ी गाइड देखें.GMSNavigatorcontinueToNextDestination: यह सुविधा 7 अप्रैल, 2026 से बंद कर दी जाएगी. बदलाव:GMSNavigatorcontinueToNextDestinationWithCompletion:.GMSUISettingsshowsTrafficLightsऔर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: नेविगेशन
- किसी मोबाइल ऐप्लिकेशन में, रास्ते के दिशा-निर्देश देने वाली इंटरैक्टिव सुविधा जोड़ें.
- रास्ते के दिशा-निर्देश पाने के लिए, मंज़िल सेट करें.
- रास्ते के दिशा-निर्देश पाने के लिए, नेविगेशन शुरू करें.
- रास्ते के अनुरोध के लिए, यात्रा का मोड (ड्राइव, पैदल, दोपहिया वाहन, टैक्सी) तय करें.
- रास्ते के दिशा-निर्देशों के लिए, रूटिंग की प्राथमिकताओं में बदलाव करना.
- रास्ते के दिशा-निर्देशों के लिए, सड़क के किनारे और पहुंचने की अन्य प्राथमिकताएं तय करें.
- फिर से इस्तेमाल किए जा सकने वाले रूट टोकन की मदद से, रास्ते के दिशा-निर्देशों के लिए फिर से प्लान किए गए रास्ते की जानकारी देना.
- रास्ते के दिशा-निर्देश वाले नेविगेशन सेशन से, उपयोगकर्ता के पहुंचने के अपडेट दिखाएं.
- रास्ते के दिशा-निर्देश वाले सेशन से, उपयोगकर्ता की जगह की जानकारी के अपडेट पाना.
- रास्ते के दिशा-निर्देश वाले नेविगेशन सेशन से, समय और दूरी के अपडेट पाना.
- रास्ते के दिशा-निर्देश वाले नेविगेशन सेशन से, रास्ते में हुए बदलाव के अपडेट पाना.
- रास्ते के दिशा-निर्देश वाले सेशन से, नाइट मोड के अपडेट पाना.
- रास्ते के दिशा-निर्देश वाले सेशन से, उपयोगकर्ता की स्पीड के अपडेट दिखाता है.
- रास्ते के दिशा-निर्देशों के दौरान दिखने वाले यूज़र इंटरफ़ेस (यूआई) एलिमेंट और कंट्रोल को अपनी पसंद के मुताबिक बनाएं.
- रास्ते के दिशा-निर्देशों की सुविधा में नया यूज़र इंटरफ़ेस (यूआई) एलिमेंट जोड़ना.
- रास्ते के दिशा-निर्देशों में, यात्रा की प्रोग्रेस दिखाने वाला इंडिकेटर जोड़ना.
- रास्ते के दिशा-निर्देशों के दौरान दिखने वाली मैप की सुविधाओं को अपनी पसंद के मुताबिक बनाएं.
- रास्ते के दिशा-निर्देशों में ट्रैफ़िक लेयर जोड़ना.
- रास्ते के दिशा-निर्देशों के लिए, कैमरे के व्यू और उसके काम करने के तरीके में बदलाव करना.
- रास्ते के दिशा-निर्देशों के लिए, स्पीडोमीटर और स्पीड लिमिट की सूचनाओं को अपनी पसंद के मुताबिक बनाना.
- रास्ते के दिशा-निर्देशों की फ़ीड को मैसेज की सीरीज़ के तौर पर दिखाता है. इसमें रास्ते के हर मोड़ के लिए दिशा-निर्देश होते हैं.
- रास्ते के दिशा-निर्देशों वाले फ़ीड के साथ इस्तेमाल करने के लिए, कस्टम आइकॉन तय करें.
- iOS ऐप्लिकेशन में, CarPlay के लिए इंटरैक्टिव और रास्ते के दिशा-निर्देश देने की सुविधा जोड़ें. झलक देखें
- उपयोगकर्ताओं को उनके रास्ते में आने वाली रुकावटों के बारे में सूचना देना.
- नेविगेशन शुरू करने से पहले, उपयोगकर्ताओं को उनके रास्ते में आने वाली रुकावटों को देखने की अनुमति दें.
- उपयोगकर्ताओं को अपने रास्ते में आने वाली रुकावटों की शिकायत करने की अनुमति दें.
- उपयोगकर्ताओं को अपने रास्ते में आने वाली रुकावटों की पुष्टि करने की अनुमति दें.
- रास्ते में आने वाली रुकावट की जानकारी देने के लिए, पसंद के मुताबिक बटन जोड़ें.