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

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

• साइड ऑफ़ सड़क रूटिंग प्राथमिकताएं
• स्टॉपओवर

सड़क के रास्ते की प्राथमिकता सेट करें

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

स्पेस कैसे काम करता है

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

सड़क के किनारे वाली तरफ़ को प्राथमिकता दी जा रही है

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

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

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

पसंदीदा सेगमेंट का टाइटल

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

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

नेविगेशन 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){...}];