मोड़-दर-मोड़ डेटा फ़ीड उन डिवाइस को सिर्फ़ नेविगेशन की जानकारी देता है जो इसे मैप पर आधारित नेविगेशन के लिए डिज़ाइन किया गया है. यह टेक्नोलॉजी, टेक्नोलॉजी, एलिमेंट जो आपने दिए हैं:
- आइकॉन (बाएं, दाएं, यू-टर्न)
- गोल-चक्कर पर नंबर चलाओ
- सड़क के नाम
- नेविगेशन के अगले चरण या आखिरी चरण तक पहुंचने में लगने वाला अनुमानित दूरी और समय मंज़िल
आप मोड़-दर-मोड़ फ़ीड का इस्तेमाल करके ऐसे अनुभव बना सकते हैं जहां पूरा नेविगेशन SDK टूल का यूज़र इंटरफ़ेस (यूआई) सही नहीं है. जैसे, Android Auto या छोटे साइज़ के लिए ऐसी स्क्रीन दिखती हैं जहां पूरा Android स्टैक उपलब्ध नहीं है. उदाहरण के लिए, आपके दोपहिया वाहन चलाने वाले ड्राइवर के लिए इसका इस्तेमाल किया जा सकता है, जहां सिर्फ़ नेविगेशन से जुड़े दिशा-निर्देश, जिनकी मदद से वे अपने डेस्टिनेशन पर तेज़ी से और ज़्यादा तेज़ी से पहुंच सकते हैं और ध्यान भटकाए बिना.
SDK टूल का इस्तेमाल करने के लिए, आपको एक सेवा बनानी होगी और उसे Android के लिए नेविगेशन SDK, ताकि यह नई नेविगेशन की जानकारी पा सके रीयल टाइम में देखा जा सकता है (नेविगेशन के दौरान, एक सेकंड में करीब एक बार).
इस दस्तावेज़ में ऐसी नेविगेशन सेवा को बनाने और रजिस्टर करने का तरीका बताया गया है जो SDK टूल से नेविगेशन की जानकारी मिलती है और नेविगेशन के स्टेटस की जानकारी मिलती है पाने वाले डिवाइस पर भेजें.
खास जानकारी
इस सेक्शन में बताया गया है कि अपने प्रोजेक्ट में TurnByTurn लाइब्रेरी कैसे जोड़ें और इसमें, हर मोड़ पर चलने वाले फ़ंक्शन बनाने के हाई-लेवल फ़्लो के बारे में जानकारी दी गई है.
Maven का इस्तेमाल करके, अपने प्रोजेक्ट में TurnByTurn लाइब्रेरी जोड़ें (सुझाया गया)
मुड़ने की सुविधा की लाइब्रेरी का स्टैंडअलोन वर्शन इस्तेमाल करने के लिए, यह तरीका अपनाएं:
- होस्ट 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() }
अपने 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 लाइब्रेरी इस एसडीके फ़ोल्डर में JAR फ़ाइल के तौर पर उपलब्ध है. अगर आपके पास इसका ऐक्सेस नहीं है, तो अपने प्रतिनिधि से संपर्क करें.
google_turnbyturn_*.jar
को डाउनलोड और अनज़िप करें.- डाउनलोड की गई JAR फ़ाइल को अपने प्रोजेक्ट की
app/libs
डायरेक्ट्री में कॉपी करें. अपने बिल्ड में JAR शामिल करने के लिए,
build.gradle
में इन्हें जोड़ें.dependencies { ... api fileTree(include: ['*.jar'], dir: 'libs') }
मुड़ने की सुविधा की लाइब्रेरी का इस्तेमाल करना
मोड़-दर-मोड़ फ़ंक्शन चालू करने के लिए, यहां बताए गए बुनियादी तरीके अपनाएं. कॉन्टेंट बनाने सेक्शन में, हर चरण के बारे में जानकारी मिलती है.
नेविगेशन के अपडेट पाने के लिए सेवा बनाएं
नेविगेशन 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())); }
मैसेज के कोड
NavInfo
मैसेज की पहचान, इनके ज़रिए की जा सकती है:
Message.what
Message
क्लास का फ़ील्ड, जो इसके मान पर सेट होता है
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
का मतलब है कि नेविगेशन प्रगति में है, लेकिन नेविगेटर नए रास्ते की तलाश में है. आगे होने वाले दांव-पेच का चरण यह नहीं है उपलब्ध है, क्योंकि अभी तक कोई नया रास्ता नहीं है. सैंपल ऐप्लिकेशन में, "फिर से रूट किया जा रहा है..." मैसेज इसमें दिखता है नेविगेशन की जानकारी डिसप्ले पर दिखेगी. रास्ता मिलने के बाद,NavInfo
मैसेज दिखेगाENROUTE
स्थिति के साथ भेजा गया.बंद है -
STOPPED
का मतलब है कि नेविगेशन खत्म हो गया है. उदाहरण के लिए, नेविगेशन जब उपयोगकर्ता ऐप्लिकेशन में नेविगेशन बंद करता है, तब रुक जाता है. सैंपल ऐप्लिकेशन में,STOPPED
की स्थिति, नेविगेशन की जानकारी के डिसप्ले को हटा देती है, ताकि चरण को बीच में न रोका जा सके निर्देश नहीं दिखाए जा सकते.
फ़ीड डिसप्ले में जानकारी अपने-आप भर जाए
अब आपने मोड़-दर-मोड़ सेवा सेट अप कर ली है, इसलिए इस सेक्शन में विज़ुअल और टेक्स्ट एलिमेंट का इस्तेमाल करके, मोड़-दर-मोड़ फ़ीड पाएं.
नेविगेशन कार्ड की जानकारी वाले फ़ील्ड
जब उपयोगकर्ता, निर्देशों वाले नेविगेशन पर जाता है, तो सबसे ऊपर एक नेविगेशन कार्ड दिखता है, जिसमें वह नेविगेशन डेटा शामिल है जो नेविगेशन 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
|
जनरेट किए गए आइकॉन का इस्तेमाल करें
Android Auto के इस्तेमाल के उदाहरणों के लिए, नेविगेशन SDK टूल, कंट्रोल और लेन जनरेट करने में मदद करता है दिशा-निर्देश आइकॉन. ये आइकॉन, Android Auto की इमेज के साइज़ से जुड़े दिशा-निर्देश के मुताबिक हैं कार ऐप्लिकेशन की लाइब्रेरी, जिसमें 500 x 74 dp के बाउंडिंग बॉक्स को टारगेट करने का सुझाव दिया जाता है. यहां जाएं: 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 ऐप्लिकेशन के लिए: