नेविगेशन पॉइंट तक पहुंचने का रास्ता

iOS के लिए Navigation SDK टूल, वेपॉइंट तय करने के बेहतर तरीके उपलब्ध कराता है. इससे, रूट की ज़्यादा सटीक जानकारी मिलती है और गंतव्य पर पहुंचने का बेहतर अनुभव मिलता है. खास तौर पर, उन जगहों के लिए जहां कई प्रवेश द्वार या ऐक्सेस पॉइंट होते हैं. navigationPointToken का इस्तेमाल करके या जगह के निर्देशांकों को प्लेस आईडी के साथ जोड़कर, सटीक जगहों पर रूट किया जा सकता है. इससे ज़्यादा जानकारी मिलती है.

अगर लागू हो, तो डेस्टिनेशन हाइलाइट करने की सुविधा काम करती रहेगी.

बैकग्राउंड

v10.10 से पहले, जगह के निर्देशांक या जगह के आईडी का इस्तेमाल करके, Waypoint तय किया जा सकता था. सिर्फ़ अक्षांश और देशांतर के हिसाब से रूट तय करने से, कभी-कभी पिक-अप या ड्रॉप-ऑफ़ के सही पॉइंट नहीं मिलते. ऐसा खास तौर पर, बड़े वेन्यू, पार्क या कई दरवाज़ों वाली इमारतों के लिए होता है. ऐसा हो सकता है कि नतीजा, सड़क के सबसे नज़दीकी सेगमेंट पर स्नैप हो जाए. हालांकि, ऐसा हो सकता है कि यह सबसे सही या सुविधाजनक ऐक्सेस पॉइंट न हो.

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

नेविगेशन पॉइंट टोकन का इस्तेमाल करना

किसी खास ऐक्सेस पॉइंट, जैसे कि प्रवेश द्वार, लोडिंग डॉक या पिक-अप के लिए तय की गई जगह पर पहुंचने के लिए, navigationPointToken का इस्तेमाल किया जा सकता है.

यह टोकन, Geocoding API के Destinations तरीके को कॉल करके मिलता है. यह किसी जगह से जुड़े, नेविगेशन के लिए इस्तेमाल किए जा सकने वाले पॉइंट को दिखाता है.

नेविगेशन पॉइंट टोकन तय करने के लिए:

Geocoding API के Destinations तरीके के जवाब से navigationPointToken पाएं.
GMSNavigationWaypoint बनाते समय, navigationPointToken तय करें.

ध्यान दें: किसी जगह और PlaceID के साथ-साथ, नेविगेशन पॉइंट टोकन एक साथ नहीं दिया जा सकता.

Swift

// Create a waypoint using a navigation endpoint token
let waypointTwo = GMSNavigationWaypoint(
  navigationPointToken: "ChIJALijSXPhQkARHmIozCCbXsASEgkFVjYHGH6PgBFrbM7wl3.."
  title: "Sydney Opera House")

// Route to the waypoint
navigator.setDestinations([waypointTwo]) { [weak self] routeStatus in
   self?.handleRouteCallback(status: routeStatus)
}

Objective-C

GMSNavigationWaypoint *waypointTwo = [[GMSNavigationWaypoint alloc] initWithNavigationPointToek:@"sampleNavigationPointToken"

जगह का आईडी और जगह की जानकारी को एक साथ इस्तेमाल करना

v10.10 से, वेपॉइंट बनाते समय, प्लेस आईडी और जगह के कोऑर्डिनेट, दोनों दिए जा सकते हैं. यह तरीका तब काम आता है, जब आपको किसी जगह के बारे में सटीक जानकारी (जगह की जानकारी) देनी हो. साथ ही, आपको उस जगह के बारे में सामान्य जानकारी (जगह का आईडी) भी देनी हो. इससे Navigation SDK को, गंतव्य पर पहुंचने का बेहतर अनुभव देने में मदद मिलती है. इसके लिए, वह गंतव्य की इमारत को हाइलाइट करता है या Place ID से जुड़े आस-पास के दिलचस्पी वाले पॉइंट दिखाता है.

Swift

// Create a waypoint using both the latlng and placeID
let waypoint = GMSNavigationWaypoint(
  location: CLLocationCoordinate2DMake(-33.85657945261524, 151.21535034203333),  
  placeID: "ChIJ3S-JXmauEmsRUcIaWtf4MzE",
  title: "Sydney Opera House")

// Route to the waypoint
navigator.setDestinations([waypoint]) { [weak self] routeStatus in
   self?.handleRouteCallback(status: routeStatus)
}

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationWaypoint *waypoint = [[GMSNavigationWaypoint alloc] initWithLocation:placeID:coordinate title:@"waypoint from location and placeiD"];

इन बातों पर ध्यान दें:

placeID और location, दोनों एट्रिब्यूट की वैल्यू देने पर:

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

मान्य वेपॉइंट कॉन्फ़िगरेशन की खास जानकारी

खास जानकारी	`location`	`placeID`	`navigationPointToken`	रूटिंग का तरीका	डेस्टिनेशन को हाइलाइट करना
सिर्फ़ जगह के निर्देशांक	सेट करो	अनुपस्थित	अनुपस्थित	तय किए गए निर्देशांकों के सबसे नज़दीकी सड़क के हिस्से तक पहुंचने के रास्ते	अगर डेस्टिनेशन का पता सटीक तरीके से लगाया जा सकता है, तो यह विकल्प दिखता है
सिर्फ़ जगह का आईडी	अनुपस्थित	सेट करो	अनुपस्थित	जगह के आईडी के लिए, डिफ़ॉल्ट नेविगेशन पॉइंट तक पहुंचने के रास्ते	जगह के आईडी से
सिर्फ़ नेविगेशन पॉइंट टोकन	अनुपस्थित	अनुपस्थित	सेट करो	टोकन से दिखाए गए सटीक नेविगेशन पॉइंट तक पहुंचने के रास्ते	यह जानकारी, Geocoding API के destinations तरीके के मूल अनुरोध में तय की गई मंज़िल से मिलती है
जगह के निर्देशांक और जगह का आईडी एक साथ	se	सेट करो	अनुपस्थित	तय किए गए निर्देशांकों के सबसे नज़दीकी सड़क के हिस्से तक पहुंचने के रास्ते	जगह के आईडी से, हालांकि अगर जगह का आईडी अक्षांश/देशांतर निर्देशांकों से बहुत दूर है, तो यह नहीं दिखता