मोड़-दर-मोड़ डेटा फ़ीड की सुविधा चालू करें

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

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

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

एसडीके का इस्तेमाल करने के लिए, आपको एक सेवा बनानी होगी और उसे Navigation SDK for Android के साथ रजिस्टर करना होगा. इससे, रीयल टाइम में नेविगेशन की नई जानकारी मिल सकेगी. नेविगेशन के दौरान, यह जानकारी हर सेकंड में करीब एक बार मिलेगी.

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

खास जानकारी

इस सेक्शन में, मोड़-दर-मोड़ सुविधा को चालू करने के लिए, हाई-लेवल फ़्लो के बारे में खास जानकारी दी गई है.

TurnByTurn सुविधा का इस्तेमाल करना

मोड़-दर-मोड़ दिशा-निर्देश देने वाली सुविधा को चालू करने के लिए, यहां कुछ मुख्य चरण दिए गए हैं. यहां दिए गए सेक्शन में, हर चरण के बारे में जानकारी दी गई है.

1. नेविगेशन से जुड़े अपडेट पाने के लिए कोई सेवा बनाएं.

2. सेवा को रजिस्टर करें.

3. नेविगेशन की स्थितियों को समझना.

नेविगेशन से जुड़े अपडेट पाने के लिए कोई सेवा बनाना

Navigation SDK, आपकी TurnByTurn सेवा से जुड़ जाता है और Android Messenger के ज़रिए उसे नेविगेशन से जुड़े अपडेट भेजता है. इन अपडेट के लिए, नई नेविगेशन सेवा बनाई जा सकती है या किसी मौजूदा सेवा का इस्तेमाल किया जा सकता है.

नेविगेशन से जुड़े अपडेट पाने के लिए किसी सेवा का इस्तेमाल करने का फ़ायदा यह है कि वह सेवा, बैकग्राउंड में चल रही किसी अलग प्रोसेस में मौजूद हो सकती है.

यहां दिए गए उदाहरण में, सेवा को नेविगेशन की जानकारी मिलती है. साथ ही, डेटा को NavInfo ऑब्जेक्ट में बदलने के लिए, TurnByTurnManager का इस्तेमाल किया जाता है. इस ऑब्जेक्ट में नेविगेशन की जानकारी होती है.

/**
 *   Receives turn-by-turn navigation information forwarded from NavSDK.
 */
public class NavInfoReceivingService extends Service {
  /** The messenger used by the service to receive nav step updates. */
  private Messenger incomingMessenger;
  private TurnByTurnManager turnByTurnManager;

  private final class IncomingNavStepHandler extends Handler {
    public IncomingNavStepHandler(Looper looper) {
      super(looper);
    }

    @Override
    public void handleMessage(Message msg) {
      // Identify the message through the msg.what field.
      if (TurnByTurnManager.MSG_NAV_INFO == msg.what) {
        // Extract the NavInfo object using the TurnByTurnManager.
        NavInfo navInfo = turnByTurnManager
          .readNavInfoFromBundle(msg.getData()));
      // Do something with the NavInfo
    }
  }
}

@Nullable
@Override
public IBinder onBind(Intent intent) {
  return incomingMessenger.getBinder();
}

@Override
public void onCreate() {
  turnByTurnManager = TurnByTurnManager.createInstance();
  HandlerThread thread =
    new HandlerThread("NavInfoReceivingService",
      Process.THREAD_PRIORITY_DEFAULT);
  thread.start();
  incomingMessenger = new Messenger(
    new IncomingNavStepHandler(thread.getLooper()));
}

मैसेज कोड

NavInfo मैसेज की पहचान, Message क्लास के Message.what फ़ील्ड से की जा सकती है. इसे TurnByTurnManager.MSG_NAV_INFO की वैल्यू पर सेट किया जाता है.

ध्यान दें: मैसेज कोड के लिए, 7200-7299 की वैल्यू रेंज को अलग रखना न भूलें, क्योंकि Navigation SDK आने वाले समय में इस रेंज में मैसेज कोड का इस्तेमाल कर सकता है.

नेविगेशन से जुड़े अपडेट के लिए सेवा को रजिस्टर करना

यहां दिए गए कोड स्निपेट, नेविगेशन सेवा को रजिस्टर करते हैं.

boolean isNavInfoReceivingServiceRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(), NavInfoReceivingService.class.getName(), numNextStepsToPreview);

सेवा को चालू और बंद करना

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

सेवा का रजिस्ट्रेशन रद्द करना

नेविगेशन से जुड़े अपडेट पाना बंद करने के लिए, Navigation SDK से सेवा का रजिस्ट्रेशन रद्द करें.

navigator.unregisterServiceForNavUpdates();

नेविगेशन की स्थितियों के बारे में जानकारी

नेविगेशन की मौजूदा स्थिति जानने के लिए, NavInfo.getNavState() का इस्तेमाल करें. यह इनमें से कोई एक हो सकती है:

• रास्ते में - ENROUTE स्थिति का मतलब है कि गाइडेड नेविगेशन चालू है और उपयोगकर्ता दिए गए रास्ते पर है. मौजूदा और आने वाले समय में होने वाले मैन्यूवर के चरण की जानकारी उपलब्ध है.

• रास्ता बदला जा रहा है - REROUTING का मतलब है कि नेविगेशन की सुविधा चालू है, लेकिन नेविगेटर नया रास्ता खोज रहा है. रास्ता बदलने का अगला चरण उपलब्ध नहीं है, क्योंकि अभी तक कोई नया रास्ता नहीं मिला है. सैंपल के तौर पर मिले ऐप्लिकेशन में, नेविगेशन की जानकारी वाले डिसप्ले में "रास्ता बदला जा रहा है..." मैसेज दिखता है. रास्ता मिलने के बाद, NavInfo मैसेज भेजा जाता है. इसमें ENROUTE स्टेटस होता है.

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

फ़ीड डिसप्ले में जानकारी भरना

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

नेविगेशन कार्ड की जानकारी वाले फ़ील्ड

जब उपयोगकर्ता, गाइड किए गए नेविगेशन मोड में जाता है, तो सबसे ऊपर एक नेविगेशन कार्ड दिखता है. इसमें Navigation SDK से भरा गया नेविगेशन डेटा होता है. यहां दी गई इमेज में, नेविगेशन के इन ज़रूरी एलिमेंट का उदाहरण दिखाया गया है.

इस टेबल में, नेविगेशन की जानकारी वाले फ़ील्ड और उन्हें ढूंढने की जगह के बारे में बताया गया है.

नेविगेशन के हर चरण के लिए फ़ील्ड	पूरी यात्रा के लिए फ़ील्ड
StepInfo में मिला	NavInfo में मिला
सड़क का पूरा नाम	बचा हुआ समय
रास्ता बदलने का आइकॉन	मंज़िल से दूरी
अगले चरण तक की दूरी
लेन गाइड के फ़ील्ड

लेन गाइड

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

किसी लेन में उपयोगकर्ता को किस दिशा में जाना चाहिए, यह isRecommended फ़ील्ड से पता चलता है.

लेन गाइड का उदाहरण

नीचे दिया गया स्निपेट, ऊपर दिखाई गई लेन के डेटा को दिखाता है.

// Lane 1
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false},
                  {/*laneShape=*/ SLIGHT_LEFT, /*isRecommended=*/ true}]

// Lane 2
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false}]

रास्ते के निर्देशों के लिए आइकॉन बनाना

Maneuver enum, नेविगेट करते समय होने वाले हर संभावित मैन्यूवर को तय करता है. साथ ही, StepInfo.getManeuver() तरीके से किसी चरण के लिए मैन्यूवर पाया जा सकता है.

आपको दिशा-निर्देशों के आइकॉन बनाने होंगे और उन्हें उनसे जुड़े दिशा-निर्देशों के साथ जोड़ना होगा. कुछ निर्देशों के लिए, आइकॉन के साथ वन-टू-वन मैपिंग सेट अप की जा सकती है. जैसे, DESTINATION_LEFT और DESTINATION_RIGHT. हालांकि, कुछ निर्देश एक जैसे होते हैं. इसलिए, हो सकता है कि आप एक से ज़्यादा निर्देशों को एक ही आइकॉन पर मैप करना चाहें. उदाहरण के लिए, TURN_LEFT और ON_RAMP_LEFT, दोनों को बाईं ओर मुड़ने वाले आइकॉन पर मैप किया जा सकता है.

Android Auto के लिए निर्देश: Navigation SDK में मौजूद निर्देश, Android Auto के साथ वन-टू-वन मैपिंग करते हैं. हालांकि, आपको टाइप को Android Auto के लिए सही फ़ॉर्मैट में बदलना होगा. Android Auto के लिए नेविगेशन की सुविधा चालू करें में जाकर, सही मैन्यूवर टाइप की पुष्टि करें देखें.

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

अलग-अलग तरह के मैन्यूवर के उदाहरण वाले आइकॉन देखने के लिए, इसे बड़ा करें

सैंपल आइकॉन	TurnByTurn Maneuvers
	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

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

Android Auto के इस्तेमाल के उदाहरणों को आसान बनाने के लिए, नेविगेशन एसडीके, लेन और दिशा-निर्देश के आइकॉन जनरेट करने की सुविधा देता है. ये आइकॉन, Android Auto के लिए कार में इस्तेमाल किए जाने वाले ऐप्लिकेशन की लाइब्रेरी में दिए गए इमेज के साइज़ से जुड़े दिशा-निर्देशों के मुताबिक होते हैं. इन दिशा-निर्देशों में, 500 x 74 डीपी वाले बाउंडिंग बॉक्स को टारगेट करने का सुझाव दिया जाता है. ज़्यादा जानकारी के लिए, Android के रेफ़रंस दस्तावेज़ में setsLaneImage और CarIcon देखें.

ध्यान दें: आइकॉन जनरेट करने की सुविधा डिफ़ॉल्ट रूप से बंद रहती है.

आइकॉन जनरेट करने का उदाहरण

NavigationUpdatesOptions options =
  NavigationUpdatesOptions.builder()
             .setNumNextStepsToPreview(numNextStepsToPreview)
             .setGeneratedStepImagesType(GeneratedStepImagesType.BITMAP)
             .setDisplayMetrics(getResources().getDisplayMetrics())
             .build();
boolean isRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(),
              NavInfoReceivingService.class.getName(),
              options);

आइकॉन जनरेट करने की सुविधा चालू करने के बाद, TurnbyTurn StepInfo ऑब्जेक्ट, maneuverBitmap और lanesBitmap फ़ील्ड को आइकॉन से भर देता है.

आगे क्या करना है

• Android Auto ऐप्लिकेशन के लिए:
  • मैप बनाएं और नेविगेशन की सुविधा चालू करें.