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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

नेविगेशन पॉइंट टोकन की मदद से, किसी मंज़िल के बारे में काम की जानकारी को Android के लिए Navigation SDK टूल, iOS के लिए Navigation SDK टूल या Routes API पर भेजा जा सकता है. इससे, रूटिंग और ड्राइवर के अनुभव को बेहतर बनाने में मदद मिलती है. यह खाना डिलीवर करने या राइड शेयर करने जैसी सेवाओं के लिए मददगार है. इन सेवाओं में, उपयोगकर्ता के इनपुट के बिना पिकअप या ड्रॉपऑफ़ पॉइंट की जानकारी साफ़ तौर पर नहीं मिल पाती.

नेविगेशन पॉइंट टोकन बनाने और उसे पास करने के लिए, Geocoding API के डेस्टिनेशन मेथड का इस्तेमाल करें. इससे आपके उपयोगकर्ता, नेविगेशन पॉइंट की सूची से अपनी पसंदीदा जगह चुन सकेंगे. उपयोगकर्ता की चुनी गई जगह, नेविगेशन पॉइंट बन जाती है. इसे Geocoding API के Destinations तरीके से दिखाया जाता है.

इसके बाद, नेविगेशन पॉइंट टोकन को Android के लिए Navigation SDK, iOS के लिए Navigation SDK या Routes API को पास किया जा सकता है. इस टोकन में, मंज़िल के निर्देशांक और काम की जानकारी, दोनों शामिल होती हैं. इससे सटीक रास्ते की जानकारी देने के लिए, एक वेपॉइंट बनाया जाता है. Navigation SDK, ड्राइवर के लिए डेस्टिनेशन को हाइलाइट करेगा. यह उस जगह के आधार पर होगा जिससे टोकन जुड़ा हुआ है.

उदाहरण: राइड शेयरिंग के लिए इस्तेमाल का उदाहरण

खास जानकारी

इस उदाहरण में, Geocoding API, Routes API, और iOS या Android के लिए Navigation SDK को जोड़ने का तरीका बताया गया है. इससे राइड शेयर करने वाला ऐसा ऐप्लिकेशन बनाया जा सकता है जो रास्ते का किराया कैलकुलेट करता है और ड्राइवर को पिकअप पॉइंट की सही जानकारी देता है.

इसके लिए, यह तरीका अपनाएं:

  1. Geocoding API की मदद से, नेविगेशन पॉइंट टोकन पाएं.
  2. किसी रास्ते का हिसाब लगाने और उसे रूट टोकन में एन्कोड करने के लिए, Routes API का इस्तेमाल करें.
  3. नेविगेशन पॉइंट टोकन और रूट टोकन, दोनों को Navigation SDK टूल को पास करें.
  4. ड्राइवर को सही पिकअप पॉइंट तक पहुंचाने के लिए, Navigation SDK का इस्तेमाल करें.

Routes API, iOS के लिए Navigation SDK, और Android के लिए Navigation SDK के दस्तावेज़ों के लिंक के लिए, ज़्यादा जानकारी सेक्शन देखें.

इस डायग्राम में दिखाया गया है कि राइड शेयर करने या डिलीवरी करने वाला कोई ऐप्लिकेशन, Geocoding API, Routes API, और iOS या Android के लिए Navigation SDK का इस्तेमाल कैसे करेगा. इससे ड्राइवर को रूट टोकन और नेविगेशन पॉइंट टोकन का इस्तेमाल करके रास्ता दिखाया जा सकेगा:

राइडशेयर या डिलीवरी के इस्तेमाल के उदाहरण का डायग्राम
राइड शेयरिंग या डिलीवरी के इस्तेमाल के उदाहरण का डायग्राम

राइडशेयर का उदाहरण

राइड शेयर करने की सुविधा का उदाहरण लें. इसमें उपभोक्ता के लिए राइड बुक करने का एक ऐप्लिकेशन होता है. वहीं, ड्राइवर के लिए एक दूसरा ऐप्लिकेशन होता है, जिससे उसे राइड की सूचना और मंज़िल तक पहुंचने के रास्ते की जानकारी मिलती है.

इस इमेज में, राइड शेयर करने वाले उपभोक्ता ऐप्लिकेशन के उदाहरण दिखाए गए हैं. इसमें नेविगेशन पॉइंट को चुना गया है. साथ ही, ड्राइवर को सटीक रास्ता दिखाने के लिए, Android के लिए Navigation SDK का इस्तेमाल करने वाला ड्राइवर ऐप्लिकेशन दिखाया गया है.

उपभोक्ता और ड्राइवर ऐप्लिकेशन के उदाहरण

जब कोई उपभोक्ता, उपभोक्ता ऐप्लिकेशन खोलता है, तो ऐप्लिकेशन Geocoding API के डेस्टिनेशन मेथड को कॉल करता है. साथ ही, उपभोक्ता को संभावित नेविगेशन पॉइंट का विकल्प देता है:

उपभोक्ता, ड्रॉप ऑफ़ पॉइंट चुन रहा है

उपयोगकर्ता अपनी पसंद का पॉइंट चुनता है. यह पॉइंट, SearchDestinations अनुरोध के रिस्पॉन्स के मुख्य हिस्से में मौजूद navigationPoints के कलेक्शन में से एक होता है:

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
    }
]

ऐप्लिकेशन का बैकएंड, Routes API को नेविगेशन पॉइंट टोकन देता है, ताकि वह रास्ते का हिसाब लगा सके और रूट टोकन हासिल कर सके.

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

इस बारे में और पढ़ें