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

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

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

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

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

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

खास जानकारी

इस सेक्शन में अपने प्रोजेक्ट में TurnByTurn लाइब्रेरी जोड़ने का तरीका बताया गया है. साथ ही, इसमें मोड़-दर-मोड़ फ़ंक्शन बनाने के हाई-लेवल फ़्लो की खास जानकारी भी दी गई है.

मुड़ने की सुविधा की लाइब्रेरी का स्टैंडअलोन वर्शन इस्तेमाल करने के लिए, यह तरीका अपनाएं:

  1. होस्ट Maven रिपॉज़िटरी को ऐक्सेस करने के लिए, अपना एनवायरमेंट सेट अप करें:

    Maven

    अपनी pom.xml फ़ाइल में ये चीज़ें जोड़ें:

        <project>
      ...
      <repositories>
        <repository>
          <id>google-maven-repository</id>
          <url>https://maven.google.com</url>
        </repository>
      </repositories>
      ...
    </project>

    ग्रेडल

    अपनी build.gradle फ़ाइल में ये चीज़ें जोड़ें:

    repositories {
    ...
    google()
}
    2. अपने Maven या Gradle कॉन्फ़िगरेशन में ये डिपेंडेंसी जोड़ें:

  2. Maven

    <dependencies>
...
<dependency>
      <groupId>com.google.android.maps</groupId>
      <artifactId>google_turnbyturn</artifactId>
      <version>1.0.0</version>
</dependency>
</dependencies>

    ग्रेडल

    dependencies {
  ...
  implementation 'com.google.android.maps:google_turnbyturn:1.0.0'
}

डाउनलोड की गई JAR फ़ाइल (वैकल्पिक) का इस्तेमाल करके, अपने प्रोजेक्ट में TurnByTurn लाइब्रेरी जोड़ें

TurnByTurn लाइब्रेरी इस एसडीके फ़ोल्डर में JAR फ़ाइल के तौर पर उपलब्ध है. अगर आपके पास इसका ऐक्सेस नहीं है, तो अपने प्रतिनिधि से संपर्क करें.

  1. google_turnbyturn_*.jar को डाउनलोड और अनज़िप करें.
  2. डाउनलोड की गई JAR फ़ाइल को अपने प्रोजेक्ट की app/libs डायरेक्ट्री में कॉपी करें.

  3. अपने बिल्ड में JAR शामिल करने के लिए, build.gradle में इन्हें जोड़ें.

    dependencies {
   ...
   api fileTree(include: ['*.jar'], dir: 'libs')
}

मुड़ने की सुविधा की लाइब्रेरी का इस्तेमाल करना

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

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

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

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

  4. ज़रूरी एलिमेंट दिखाने वाले नेविगेशन डिसप्ले का उदाहरण देखें.

नेविगेशन के अपडेट पाने के लिए सेवा बनाएं

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

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

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

/**
 *   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()));
}

मैसेज के कोड

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

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

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

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

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

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

सेवा का पंजीकरण रद्द करना

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

navigator.unregisterServiceForNavUpdates();

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

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

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

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

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

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

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

एक मोबाइल स्क्रीन जो आने वाले समय के बाएं मोड़ को 100 फ़ीट में W Ahवानी Ave पर 100 फ़ीट बाद दिखाती है. स्क्रीन के नीचे, मंज़िल तक पहुंचने में 46 मिनट और 39 मील बाकी है.

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

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

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

लेन गाइड

नेविगेशन 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 इनम में, नेविगेट करने के दौरान होने वाली हर संभावित गतिविधि के बारे में बताया गया है. साथ ही, StepInfo.getManeuver() तरीके से बताए गए चरण के हिसाब से गतिविधि की जानकारी भी दी जा सकती है.

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

कुछ कलाओं में एक अतिरिक्त 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

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

नेविगेशन SDK टूल से जनरेट हुए आइकॉन की एक छोटी सूची.

Android Auto को इस्तेमाल करने के लिए, नेविगेशन SDK टूल की मदद से, कंट्रोल और लेन वाले आइकॉन जनरेट किए जा सकते हैं. ये आइकॉन, Android Auto Car ऐप्लिकेशन की लाइब्रेरी में मौजूद इमेज के साइज़ से जुड़े दिशा-निर्देशों के मुताबिक हैं. इन आइकॉन में, 500 x 74 dp वाले बाउंडिंग बॉक्स को टारगेट करने का सुझाव दिया गया है. ज़्यादा जानकारी के लिए, 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 फ़ील्ड में जानकारी भरता है.

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