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

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

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

सड़क के किस ओर से रूट करना है, इसके लिए प्राथमिकता सेट करना

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

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

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

सड़क के एक ही तरफ़ चलना पसंद है

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

(nullable instancetype)initWithLocation:(CLLocationCoordinate2D)location
                                  title:(NSString *)title
                   preferSameSideOfRoad:(BOOL)preferSameSideOfRoad;

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

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

आने वाली फ़्लाइट की दिशा सेट करें

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

(nullable instancetype)initWithLocation:(CLLocationCoordinate2D)location
                                  title:(NSString *)title
                preferredSegmentHeading:(int32_t)preferredSegmentHeading;

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

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

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

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

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

Swift

let location = CLLocationCoordinate2D(latitude: 47.67, longitude: -122.20)
let waypoint = GMSNavigationMutableWaypoint(location: location, title: "waypoint from location")!
waypoint.vehicleStopover = true
mapView.navigator?.setDestinations([waypoint], routingOptions: routingOptions, callback: {...})

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationMutableWaypoint *waypoint =
    [[GMSNavigationMutableWaypoint alloc] initWithLocation:location
                                                     title:@"waypoint from location"];
waypoint.vehicleStopover = YES;
[_mapView.navigator setDestinations:@[waypoint1]
                     routingOptions:routingOptions
                           callback:^(GMSRouteStatus routeStatus){...}];