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

मैप की नई स्टाइल, जल्द ही Google Maps Platform पर उपलब्ध होगी. मैप की स्टाइल में हुए इस अपडेट में, नया डिफ़ॉल्ट कलर पटल जोड़ा गया है. साथ ही, मैप के अनुभवों और उसे इस्तेमाल करने के तरीके में सुधार भी किए गए हैं. मार्च 2025 में, सभी मैप स्टाइल अपने-आप अपडेट हो जाएंगी. उपलब्धता और जल्दी ऑप्ट इन करने के तरीके के बारे में ज़्यादा जानकारी के लिए, Google Maps Platform के लिए नई मैप स्टाइल देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

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

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

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

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

खास जानकारी

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

Maven का इस्तेमाल करके अपने प्रोजेक्ट में TurnByTurn लाइब्रेरी जोड़ें (सुझाया गया)

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

होस्ट Maven का डेटा स्टोर करने की जगह को ऐक्सेस करने के लिए, अपना एनवायरमेंट सेट अप करें. ऐसा करने के लिए, यात्रा और ऑर्डर से जुड़े दस्तावेज़ में मौजूद ड्राइविंग SDK टूल का इस्तेमाल शुरू करना सेक्शन में बताए गए तरीके का इस्तेमाल करें.

अपने Maven या Gradle कॉन्फ़िगरेशन में यह डिपेंडेंसी जोड़ें:

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 लाइब्रेरी इस SDK फ़ोल्डर में JAR फ़ाइल के तौर पर उपलब्ध होती है. अगर आपके पास ऐक्सेस नहीं है, तो अपने प्रतिनिधि से संपर्क करें.

google_turnbyturn_*.jar को डाउनलोड करें और अनज़िप करें.
डाउनलोड की गई JAR फ़ाइल को अपने प्रोजेक्ट की app/libs डायरेक्ट्री में कॉपी करें.
अपने बिल्ड में JAR शामिल करने के लिए, अपने build.gradle में ये जोड़ें.
```
dependencies {
   ...
   api fileTree(include: ['*.jar'], dir: 'libs')
}
```

TurnByTurn लाइब्रेरी का इस्तेमाल करना

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

नेविगेशन अपडेट पाने के लिए कोई सेवा बनाएं.
सेवा को रजिस्टर करें.
नेविगेशन स्थितियों को समझना.
ज़रूरी एलिमेंट दिखाने वाला नेविगेशन डिसप्ले का उदाहरण देखें.

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

नेविगेशन 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 की वैल्यू पर सेट होती है.

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

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

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

सेवा शुरू और बंद करना

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

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

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

navigator.unregisterServiceForNavUpdates();

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

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

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

फ़ीड डिसप्ले को पॉप्युलेट करें

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

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

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

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

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

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

लेन गाइड

नेविगेशन SDK टूल, नेविगेशन टर्न कार्ड में लेन को लेन और 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, दोनों बाएं मुड़ने के आइकॉन से मैप कर सकते हैं.

कुछ मैन्युअल में एक और clockwise या counterclockwise लेबल शामिल होता है, जिसे SDK टूल, देश के ड्राइविंग साइड के हिसाब से तय करता है. उदाहरण के लिए, जिन देशों में ड्राइविंग सड़क के बाईं ओर होती है, वहां ड्राइवर घड़ी की दिशा में घूमता है या U-मोड़ लेता है. वहीं, सड़क के दाएँ कोने में मौजूद देश, घड़ी की दिशा में चलते हैं. नेविगेशन 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 कार ऐप्लिकेशन की लाइब्रेरी में मौजूद इमेज के साइज़ से जुड़े दिशा-निर्देशों के मुताबिक हैं. इस लाइब्रेरी में 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 और lansBitmap फ़ील्ड में आइकॉन अपने-आप भर जाता है.

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

Android Auto ऐप्लिकेशन के लिए:
- मैप ड्रॉ करें और नेविगेशन चालू करें.