मोड़-दर-मोड़ डेटा फ़ीड के बारे में जानकारी

मोड़-दर-मोड़ निर्देश देने वाला डेटा फ़ीड, उन डिवाइसों को सिर्फ़ नेविगेशन की जानकारी देता है जिन्हें मैप पर नेविगेशन के लिए डिज़ाइन नहीं किया गया है. यह आपके दिए गए एलिमेंट के साथ, आने वाले समय में होने वाले बदलावों की जानकारी देता है:

  • आइकॉन (बाईं ओर, दाईं ओर, यू-टर्न)
  • राउंडअबाउट में टर्न की संख्या
  • सड़कों के नाम
  • नेविगेशन के अगले चरण या आखिरी मंज़िल तक पहुंचने में लगने वाला अनुमानित समय और दूरी

छोटे स्क्रीन डिसप्ले जैसी जगहों पर, नेविगेशन SDK टूल के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल नहीं किया जा सकता. ऐसे में, टर्न-बाय-टर्न फ़ीड का इस्तेमाल करके, बेहतर अनुभव दिए जा सकते हैं. उदाहरण के लिए, इसका इस्तेमाल दोपहिया वाहन चलाने वालों के लिए किया जा सकता है. इसमें सिर्फ़ नेविगेशन से जुड़े निर्देश दिखाए जा सकते हैं, ताकि वे कम से कम रुकावटों के साथ अपने डेस्टिनेशन तक तेज़ी से और ज़्यादा भरोसे के साथ पहुंच सकें.

ज़रूरी नेविगेशन डिसप्ले एलिमेंट

मोबाइल स्क्रीन, जिसमें दिख रहा है कि चर्च स्ट्रीट पर 50 फ़ीट के बाद, दाईं ओर मुड़ना है. स्क्रीन पर सबसे नीचे, डेस्टिनेशन तक पहुंचने में बचे समय के तौर पर 13 मिनट और दूरी के तौर पर 2.1 मील दिख रहा है.

नेविगेशन के हर चरण के लिए मुख्य फ़ील्ड, सड़क का पूरा नाम, मानेवर, और चरण की कुल दूरी है. ये फ़ील्ड, GMSNavigationStepInfo में उपलब्ध हैं.

पूरी यात्रा के लिए, हो सकता है कि आप मौजूदा चरण या डेस्टिनेशन तक बचे हुए समय और दूरी को दिखाना चाहें. ये सभी जानकारी GMSNavigationNavInfo में उपलब्ध है. दाईं ओर दी गई इमेज में, नेविगेशन के इन ज़रूरी एलिमेंट का उदाहरण दिया गया है.

इवेंट लिसनर सेट अप करना

सिर्फ़ नेविगेशन डेटा का इस्तेमाल करने के लिए, आपको didChangeNavInfo इवेंट के लिए इवेंट लिसनर लागू करना होगा. इवेंट लिसनर में, अपने उपयोगकर्ताओं को टर्न-बाय-टर्न नेविगेशन देने के लिए, यात्रा और चरण की जानकारी ऐक्सेस करें.

इवेंट हैंडलर लागू करने के लिए, मैप के व्यू कंट्रोलर को GMSNavigatorListener प्रोटोकॉल लागू करना होगा. iOS के लिए Navigation SDK में इवेंट मैनेज करने के बारे में ज़्यादा जानकारी के लिए, नेविगेशन इवेंट सुनना लेख पढ़ें.

didChangeNavInfo इवेंट को मैनेज करना

अपने ऐप्लिकेशन में, बारी-बारी से निर्देश सुनाने की सुविधा जोड़ने के लिए, didChangeNavInfo इवेंट के लिए एक लिसनर बनाएं. इवेंट लिसनर में, बारी-बारी से निर्देश सुनाने की सुविधा को कंट्रोल करने के लिए, इन क्लास और एनम का इस्तेमाल करें:

  • GMSNavigationNavInfo — नेविगेशन की स्थिति के बारे में जानकारी देने वाली क्लास.

  • GMSNavigationStepInfo — नेविगेशन रूट के किसी एक चरण के बारे में जानकारी देने वाली क्लास.

  • GMSNavigationNavState — नेविगेशन की मौजूदा स्थिति बताने वाला एन्म्. जैसे, रास्ते पर है, फिर से रास्ता तय किया जा रहा है या रुका हुआ है.

  • GMSNavigationDrivingSide — यह एन्म् (enum) बताता है कि यह चरण, दाईं ओर या बाईं ओर ड्राइव करने वाले रास्ते पर है.

  • GMSNavigationManeuver — नेविगेशन ऐक्शन तय करने वाला एन्म् (Enum), जैसे कि बाईं ओर मुड़ें या दाईं ओर मुड़ें.

यहां didChangeNavInfo इवेंट के लिए, इवेंट लिसनर के उदाहरण दिए गए हैं:

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
          ...
        }
      }
    }
  }

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;
        ...
      }
    }
    ...
  }

नेविगेशन की मौजूदा स्थिति जानने के लिए, GMSNavigationNavInfo की navState प्रॉपर्टी का इस्तेमाल करें. यह स्थिति इनमें से कोई एक होती है:

  • रास्ते पर है - GMSNavigationNavStateEnroute स्थिति का मतलब है कि निर्देशों वाला नेविगेशन फ़िलहाल चालू है और उपयोगकर्ता दिए गए रास्ते पर है. अगले चरण के बारे में जानकारी उपलब्ध है.

  • रास्ता बदलना - GMSNavigationNavStateRerouting का मतलब है कि नेविगेशन की प्रोसेस जारी है, लेकिन नेविगेटर नया रास्ता ढूंढ रहा है. आगे की कार्रवाई का चरण उपलब्ध नहीं है, क्योंकि अभी तक कोई नया रास्ता नहीं चुना गया है.

  • बंद है - GMSNavigationNavStateStopped का मतलब है कि नेविगेशन खत्म हो गया है. उदाहरण के लिए, ऐप्लिकेशन में नेविगेशन से बाहर निकलने पर नेविगेशन बंद हो जाता है. सैंपल ऐप्लिकेशन में, GMSNavigationNavStateStopped स्टेटस नेविगेशन की जानकारी वाले डिसप्ले को हटा देता है, ताकि चरण के निर्देशों को दिखाने से रोका जा सके.

लेन गाइड

Navigation SDK, नेविगेशन के मुड़ने के कार्ड में लेन को GMSNavigationLane और GMSNavigationLaneDirection डेटा ऑब्जेक्ट के तौर पर दिखाता है. नेविगेशन के दौरान, GMSNavigationLane ऑब्जेक्ट किसी खास लेन को दिखाता है. साथ ही, इसमें GMSNavigationLaneDirection ऑब्जेक्ट की एक सूची होती है, जिसमें इस लेन से किए जा सकने वाले सभी मोड़ों के बारे में बताया जाता है.

recommended फ़ील्ड का इस्तेमाल करके, ड्राइवर को किसी लेन में जाने के लिए सुझाई गई दिशा को मार्क किया जाता है.

लेन के लिए निर्देश देने की सुविधा का उदाहरण

नीचे दिए गए स्निपेट में, पिछले स्क्रीनशॉट में दिखाई गई लेन का डेटा दिखाया गया है.

// Lane 1
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 2
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 3
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false}]

// Lane 4
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false},
{/*GMSNavigationLaneShape=*/ GMSNavigationLaneShapeNormalRight, /*recommended=*/ false}]

लेन के लिए दिशा-निर्देश वाली इमेज

Navigation SDK, नेविगेशन के हर चरण के लिए, लेन की इमेज जनरेट करने की सुविधा देता है, जैसा कि GMSNavigationStepInfo में बताया गया है. ये आइकॉन, CarPlay पर इमेज के साइज़ से जुड़े दिशा-निर्देशों के मुताबिक होते हैं.

Swift

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)

Objective-C

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];

मैन्युवर के लिए आइकॉन बनाना

मैन्युवर आइकॉन

GMSNavigationManeuver सूची, नेविगेट करते समय होने वाले हर संभावित बदलाव के बारे में बताती है. साथ ही, GMSNavigationStepInfo की maneuver प्रॉपर्टी से, किसी चरण के लिए बदलाव की जानकारी मिल सकती है.

आपको मैन्युवर के आइकॉन बनाने होंगे और उन्हें मैन्युवर से जोड़ना होगा. कुछ मैन्युवर के लिए, किसी आइकॉन के लिए एक-से-एक मैपिंग सेट अप की जा सकती है. जैसे, GMSNavigationManeuverDestinationLeft और GMSNavigationManeuverDestinationRight. हालांकि, कुछ मैन्युवर की विशेषताएं एक जैसी होती हैं. इसलिए, हो सकता है कि आप एक से ज़्यादा मैन्युवर को एक आइकॉन पर मैप करना चाहें. उदाहरण के लिए, GMSNavigationManeuverTurnLeft और GMSNavigationManeuverOnRampLeft, दोनों को बाईं ओर मुड़ने के आइकॉन पर मैप किया जा सकता है.

कुछ मैन्युवर में "घड़ी की दिशा में" या "घड़ी की दिशा के उलट" लेबल होता है. 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

जनरेट किए गए आइकॉन का इस्तेमाल करना

नेविगेशन SDK टूल, किसी दिए गए GMSNavigationStepInfo के लिए, मैन्युवर आइकॉन जनरेट करने की सुविधा देता है. ये आइकॉन, CarPlay पर इमेज के साइज़ सेट करने के लिए दिए गए दिशा-निर्देशों के मुताबिक होते हैं.

Swift

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)

Objective-C

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];