मोड़-दर-मोड़ डेटा फ़ीड, उन डिवाइसों को सिर्फ़ नेविगेशन की जानकारी देता है जिन्हें मैप पर नेविगेट करने के दिशा-निर्देश के लिए डिज़ाइन नहीं किया गया है. इससे आने वाले समय में, आपके कॉन्टेंट में ये एलिमेंट शामिल किए जाते हैं:
- आइकॉन (बाएं, दाएं, यू-टर्न)
- संख्याओं को गोलचक्कर में मोड़ें
- सड़कों के नाम
- अगले नेविगेशन चरण या अंतिम डेस्टिनेशन तक की अनुमानित दूरी और समय
ऐसे अनुभव बनाने के लिए मोड़-दर-मोड़ फ़ीड इस्तेमाल किया जा सकता है जहां नेविगेशन SDK टूल का पूरा यूज़र इंटरफ़ेस (यूआई) सही नहीं है, जैसे कि छोटी स्क्रीन वाले डिसप्ले. उदाहरण के लिए, इसे दोपहिया वाहन चलाने वाले लोगों के लिए इस्तेमाल किया जा सकता है, जहां सिर्फ़ नेविगेशन के लिए दिए गए दिशा-निर्देश प्रोजेक्ट किए जा सकते हैं. इससे उन्हें अपनी मंज़िल तक तेज़ी से और भरोसे के साथ पहुंचने में मदद मिलेगी.
नेविगेशन के लिए ज़रूरी डिसप्ले एलिमेंट
नेविगेशन के हर चरण के लिए मुख्य फ़ील्ड में सड़क का पूरा नाम, गतिविधि, और चरण की कुल दूरी की जानकारी होती है. ये जानकारी GMSNavigationStepInfo में उपलब्ध होती हैं.
पूरी यात्रा के लिए, हो सकता है कि आप मौजूदा चरण या मंज़िल तक पहुंचने के लिए बचे हुए समय और दूरी को दिखाना चाहें. ये सभी जानकारी GMSNavigationNavInfo में उपलब्ध है. दाईं ओर की इमेज में इन ज़रूरी नेविगेशन एलिमेंट का उदाहरण दिखाया गया है.
इवेंट लिसनर सेट अप करना
अगर आपको सिर्फ़ नेविगेशन वाले डेटा का इस्तेमाल करना है, तो आपको didChangeNavInfo
इवेंट के लिए, इवेंट लिसनर लागू करना होगा. इवेंट लिसनर में, यात्रा और चरण की जानकारी ऐक्सेस करें
ताकि अपने उपयोगकर्ताओं को मोड़-दर-मोड़ नेविगेशन दिया जा सके.
इवेंट हैंडलर लागू करने के लिए, मैप के व्यू कंट्रोलर को GMSNavigatorListener
प्रोटोकॉल लागू करना होगा. iOS के लिए नेविगेशन SDK में इवेंट हैंडल करने के बारे में ज़्यादा जानकारी के लिए,
नेविगेशन इवेंट सुनना देखें.
DidChangeNavInfo इवेंट को मैनेज करना
अपने ऐप्लिकेशन को मोड़-दर-मोड़ मदद देने के लिए, didChangeNavInfo
इवेंट के लिए एक लिसनर बनाएं. इवेंट लिसनर में, मोड़-दर-मोड़ नेविगेशन को कंट्रोल करने के लिए, इन क्लास और एनम का इस्तेमाल करें:
GMSNavigationNavInfo — नेविगेशन की स्थिति के बारे में तय करने वाली क्लास की जानकारी.
GMSNavigationStepInfo — नेविगेशन रूट के एक चरण के बारे में जानकारी देने वाली क्लास.
GMSNavigationNavState — नेविगेशन की मौजूदा स्थिति के बारे में बताने वाली एनम, जैसे कि रास्ते में बदलाव करना, नया रास्ता बदलना या बंद करना.
GMSNavigationDrivingSide — एनम यह तय करता है कि यह चरण ड्राइव-ऑन-राइट या ड्राइव-ऑन-लेफ़्ट रूट पर है या नहीं.
GMSNavigationManeuver — नेविगेशन की कार्रवाइयों के बारे में बताने वाली Enum, जैसे कि बाएं मुड़ना या दाएं मुड़ना.
यहां didChangeNavInfo
इवेंट के लिए इवेंट लिसनर के उदाहरण दिए गए हैं:
Objective-C
// ViewController.h @interface SomeViewController () <GMSNavigatorListener> @end // ViewController.m @implementation SomeViewController // Some initialization code. ... { ... [_mapView.navigator addListener:self]; ... } #pragma mark GMSNavigatorListener - (void)navigator:(GMSNavigator *)navigator didUpdateNavInfo:(GMSNavigationNavInfo *)navInfo { // Get the current step information if (navInfo.navState == GMSNavigationNavStateEnroute) { GMSNavigationStepInfo *currentStep = navInfo.currentStep; if (currentStep) { ... roadNameLabel.text = currentStep.simpleRoadName; ... } } ... }
Swift
// ViewController.swift class SomeViewController: UIViewController { ... mapView.navigator?.add(self); ... } extension SomeViewController: GMSNavigatorListener { func navigator(_ navigator: GMSNavigator, didUpdateNavInfo navInfo: GMSNavigationNavInfo) { // Get the current step information if navInfo.navState == .enroute { if let currentStep = navInfo.currentStep { ... roadNameLabel.text = currentStep.simpleRoadName ... } } } }
नेविगेशन की स्थितियां
नेविगेशन की मौजूदा स्थिति जानने के लिए, GMSNavigationNavInfo की navState
प्रॉपर्टी का इस्तेमाल करें. यह इनमें से एक है:
एनरूट -
GMSNavigationNavStateEnroute
स्थिति का मतलब है कि निर्देशों के साथ नेविगेशन फ़िलहाल चालू है और उपयोगकर्ता बताए गए रास्ते पर है. मौजूदा आगे की कार्रवाई के बारे में जानकारी उपलब्ध है.फिर से रास्ता बताना -
GMSNavigationNavStateRerouting
का मतलब है कि नेविगेशन चल रहा है, लेकिन नेविगेटर किसी नए रास्ते की खोज कर रहा है. आगे होने वाला कोई नया रास्ता उपलब्ध नहीं है, क्योंकि अभी तक कोई नया रास्ता नहीं है.बंद है -
GMSNavigationNavStateStopped
का मतलब है कि नेविगेशन खत्म हो गया है. उदाहरण के लिए, जब उपयोगकर्ता ऐप्लिकेशन में नेविगेशन बंद करता है, तब नेविगेशन रुक जाता है. सैंपल ऐप्लिकेशन में,GMSNavigationNavStateStopped
स्थिति, नेविगेशन की जानकारी वाले डिसप्ले को हटा देती है, ताकि उपयोगकर्ता को ऐसे निर्देश न दिखें.
कलाबाज़ों के लिए आइकॉन बनाना
GMSNavigationManeuver
enum, नेविगेट करते समय होने वाले हर संभावित बदलाव के बारे में बताता है और आपके पास
GMSNavigationStepInfoGMS NavigationStep-1-1 की maneuver
प्रॉपर्टी की मदद से, दिए गए हर चरण को पूरा करने में मदद मिल सकती है
आपको कलाकर दिखाने वाले आइकॉन बनाने होंगे और उनकी करतबों के साथ उन्हें जोड़ना होगा.
कुछ प्रयोगों के लिए, किसी आइकॉन के लिए वन-टू-वन मैपिंग सेट अप की जा सकती है, जैसे कि
GMSNavigationManeuverDestinationLeft
और GMSNavigationManeuverDestinationRight
.
हालांकि, कुछ कौशल दिखाने वाले पैमानों में, दूसरे शख़्सियतों की विशेषताएं होती हैं. इसलिए, शायद आप एक ही आइकॉन के लिए एक से ज़्यादा तरीकों का इस्तेमाल करना चाहें. उदाहरण के लिए, GMSNavigationManeuverTurnLeft
और
GMSNavigationManeuverOnRampLeft
, दोनों बाएं मुड़ने के आइकॉन को मैप कर सकते हैं.
कुछ तरीकों में एक और “Clockwise” या “CounterClockwise” लेबल मौजूद होता है. SDK टूल, इस लेबल को देश की ड्राइविंग के हिसाब से तय करता है. उदाहरण के लिए, जिन देशों में गाड़ी सड़क के बाईं ओर है वहां ड्राइवर घड़ी की दिशा में राउंड अराउंड या यू-टर्न लेते हैं, जबकि सड़क के दाईं ओर वाले देश घड़ी की उलटी दिशा में चलते हैं. नेविगेशन SDK टूल यह पता लगाता है कि उपयोगकर्ताओं की गतिविधि, बाईं या दाईं ओर है या नहीं. साथ ही, यह भी जानकारी देता है कि उपयोगकर्ताओं को सही कार्रवाई करनी है या नहीं. इसलिए, हो सकता है कि आपकी कला का आइकॉन घड़ी की सुई की दिशा में और घड़ी की उलटी दिशा में चलने वाली कार्रवाई में अलग हो.
अलग-अलग कलाओं के उदाहरण देखने के लिए बड़ा करें
सैंपल आइकॉन | बारी-बारी से खेले जाने वाले गेम |
---|---|
DEPART UNKNOWN |
|
STRAIGHT ON_RAMP_UNSPECIFIED OFF_RAMP_UNSPECIFIED NAME_CHANGE
|
|
TURN_RIGHT ON_RAMP_RIGHT
|
|
TURN_LEFT ON_RAMP_LEFT
|
|
TURN_SLIGHT_RIGHT ON_RAMP_SLIGHT_RIGHT OFF_RAMP_SLIGHT_RIGHT
|
|
TURN_SLIGHT_LEFT ON_RAMP_SLIGHT_LEFT OFF_RAMP_SLIGHT_LEFT
|
|
TURN_SHARP_RIGHT ON_RAMP_SHARP_RIGHT OFF_RAMP_SHARP_RIGHT
|
|
TURN_SHARP_LEFT ON_RAMP_SHARP_LEFT OFF_RAMP_SHARP_LEFT
|
|
TURN_U_TURN_COUNTERCLOCKWISE ON_RAMP_U_TURN_COUNTERCLOCKWISE OFF_RAMP_U_TURN_COUNTERCLOCKWISE
|
|
TURN_U_TURN_CLOCKWISE ON_RAMP_U_TURN_CLOCKWISE OFF_RAMP_U_TURN_CLOCKWISE
|
|
ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
|
|
ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_RIGHT_CLOCKWISE
|
|
ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
|
|
ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_STRAIGHT_CLOCKWISE
|
|
ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
|
|
ROUNDABOUT_LEFT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_LEFT_CLOCKWISE
|
|
ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_SHARP_LEFT_CLOCKWISE
|
|
ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
|
|
ROUNDABOUT_U_TURN_CLOCKWISE
|
|
ROUNDABOUT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_CLOCKWISE
|
|
ROUNDABOUT_EXIT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_EXIT_CLOCKWISE
|
|
MERGE_RIGHT OFF_RAMP_RIGHT
|
|
MERGE_LEFT OFF_RAMP_LEFT
|
|
FORK_RIGHT TURN_KEEP_RIGHT ON_RAMP_KEEP_RIGHT OFF_RAMP_KEEP_RIGHT
|
|
FORK_LEFT TURN_KEEP_LEFT ON_RAMP_KEEP_LEFT OFF_RAMP_KEEP_LEFT
|
|
MERGE_UNSPECIFIED
|
|
DESTINATION
|
|
DESTINATION_RIGHT
|
|
DESTINATION_LEFT
|
|
FERRY_BOAT
|
|
FERRY_TRAIN
|