वेपॉइंट मैनेज करें

सूचना: fromLatLng() और fromPlaceId() के इस्तेमाल पर रोक लगा दी गई है. हालांकि, ये बिना किसी अपडेट के उपलब्ध रहेंगे. हमारा सुझाव है कि आप नए Waypoint.Builder पर माइग्रेट करें.

Android के लिए Navigation SDK, डिफ़ॉल्ट रूप से किसी वेपॉइंट तक पहुंचने का सबसे तेज़ रास्ता ढूंढता है. हालांकि, इससे यह गारंटी नहीं मिलती कि वाहन सड़क के उस किनारे पर पहुंचेगा जहां उपभोक्ता इंतज़ार कर रहा है. साथ ही, इससे यह भी गारंटी नहीं मिलती कि ड्राइवर के लिए वाहन रोकने की जगह सुरक्षित है. इस गाइड में, इन स्थितियों में इस्तेमाल की जा सकने वाली दो सुविधाओं के बारे में बताया गया है:

• सड़क के किस ओर से ड्राइविंग करनी है, इसके लिए प्राथमिकता सेट करना
• स्टॉपओवर की सुविधा

रास्ते के किस ओर से जाना है, इसके लिए राउटिंग की प्राथमिकता

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

सड़क के एक ही तरफ़ से यात्रा करने को प्राथमिकता दें

आपको वेपॉइंट के भौगोलिक निर्देशांक देने होते हैं. इसके बाद, आपको एक फ़्लैग (setPreferSameSideOfRoad) सेट करना होता है. इससे पता चलता है कि आपको वेपॉइंट के हिसाब से सड़क के उसी तरफ़ पहुंचना है. यह फ़्लैग, सड़क के सबसे नज़दीकी फ़ुटपाथ पर स्नैप किया जाता है.

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setPreferSameSideOfRoad(true)
           .build()

अहम जानकारी: कुछ मामलों में, जब वेपॉइंट को सबसे नज़दीकी सड़क के किनारे पर स्नैप किया जाता है, तो हो सकता है कि वह सड़क सही न हो. उदाहरण के लिए, हो सकता है कि यह सड़क, इंतज़ार कर रहे उपभोक्ता के घर के आस-पास हो. setPreferSameSideOfRoad के बजाय setPreferredHeading का इस्तेमाल करके, इस समस्या को होने से रोका जा सकता है.

ज़्यादा जानकारी के लिए, अगला सेक्शन देखें.

पहुंचने की जगह का हेडिंग सेट करना

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

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setPreferredHeading(preferredHeading)
           .build()

Navigation SDK, वेपॉइंट के सबसे नज़दीक मौजूद सड़क के हिस्से को चुनता है. साथ ही, यह देखता है कि लेन की दिशा, वेपॉइंट की सड़क के किनारे से +/- 55 डिग्री के अंदर हो.

स्टॉपओवर की प्राथमिकता सेट करना

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

यह कैसे काम करता है

किसी स्टॉप के लिए वेपॉइंट बनाते समय, स्टॉपओवर के लिए प्राथमिकता सेट की जाती है. इसके लिए, setVehicleStopover प्राथमिकता को इस उदाहरण में दिखाए गए तरीके से तय करें:

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setVehicleStopover(true)
           .build()