Google Maps या Waze लॉन्च करें

नेविगेशन सेशन शुरू करने के लिए, आपके ऐप्लिकेशन को डाइनैमिक तौर पर एक लॉन्च यूआरएल बनाना होगा, ताकि Google Maps या Waze को खोला जा सके. इस गाइड में, यात्रा बनाएं से मिले, पुष्टि किए गए यात्रा टोकन का इस्तेमाल करके, Google Maps या Waze को लॉन्च करने का तरीका बताया गया है. साथ ही, इसमें आपके ऐप्लिकेशन पर वापस आने के अनुभव को कॉन्फ़िगर करने का तरीका भी बताया गया है.

Google Maps या Waze को लॉन्च करने का तरीका

Google Maps या Waze को लॉन्च करने के लिए, आपको ड्राइवर को अपने ऐप्लिकेशन से नेविगेशन सेशन शुरू करने का विकल्प देना होगा. साथ ही, ज़रूरी पैरामीटर के साथ लॉन्च यूआरएल बनाना होगा और सेशन को एट्रिब्यूट करने के लिए अपना ऐप्लिकेशन आईडी देना होगा.

ड्राइवर आपके ऐप्लिकेशन से नेविगेशन शुरू कर सकें

आपको ड्राइवर को अपने ऐप्लिकेशन से नेविगेशन शुरू करने का विकल्प देना चाहिए. अगर ड्राइवर को किसी बटन का इस्तेमाल करके, Google Maps या Waze लॉन्च करने की अनुमति दी जाती है, तो पक्का करें कि उसे सही एट्रिब्यूशन मिले. साथ ही, उसे साफ़ तौर पर लेबल करें, ताकि कोई भ्रम न हो. उदाहरण के लिए, बटन पर या उसके आस-पास "Google Maps" या "Waze" टेक्स्ट डालें.

लॉन्च यूआरएल बनाना

नेविगेशन सेशन शुरू करने के लिए, Navigation Connect का लॉन्च यूआरएल बनाएं. यह यूआरएल एक स्ट्रिंग है, जिसमें डेस्टिनेशन, यात्रा का टोकन, और नेविगेशन के लिए ज़रूरी पैरामीटर शामिल होते हैं. यह स्टैंडर्ड Google Maps यूआरएल या Waze डीप लिंक की तरह ही काम करता है.

ड्राइवर के डिवाइस पर Google Maps या Waze लॉन्च करने के लिए, प्लैटफ़ॉर्म के हिसाब से उपलब्ध तरीके का इस्तेमाल करें:

  • Android: यूआरएल स्ट्रिंग को Intent में पास करें.
  • iOS: यूआरएल स्ट्रिंग को यूनिवर्सल लिंक (या डीप लिंक) के तौर पर इस्तेमाल करें.

डेस्टिनेशन को फ़ॉर्मैट करना

यह पक्का करने के लिए कि Google Maps या Waze किसी रास्ते का हिसाब सही तरीके से लगा सके, अपनी मंज़िल को फ़ॉर्मैट करते समय इन नियमों का पालन करें:

  • पहुंचने के लिए सिर्फ़ एक डेस्टिनेशन तय करें. मंज़िल को पते की स्ट्रिंग, अक्षांश/देशांतर के निर्देशांक या जगह के आईडी के तौर पर पास किया जा सकता है.

  • एक से ज़्यादा वेपॉइंट का इस्तेमाल न करें. अगर यूआरएल में सीधे तौर पर कई वेपॉइंट पास किए जाते हैं, तो Google Maps या Waze में गड़बड़ी का मैसेज दिखता है. इसके बजाय, अलग-अलग यात्राएं बनाएं.

यात्रा का टोकन और नेविगेशन पैरामीटर जोड़ना

लॉन्च यूआरएल को पूरा करने के लिए, आपको पुष्टि किया गया वह यात्रा टोकन शामिल करना होगा जो आपको यात्रा बनाएं अनुरोध से मिला है. आपको नेविगेशन पैरामीटर भी शामिल करने होंगे, जो Google Maps या Waze को ऐक्टिव नेविगेशन शुरू करने के लिए कहते हैं.

Google Maps

Google Maps के लिए, अपने लॉन्च यूआरएल में ये पैरामीटर शामिल करें:

  • dir_action=navigate: यह पैरामीटर, ऐक्टिव नेविगेशन को लागू करता है.
  • action_token: यह पैरामीटर, पुष्टि किए गए आपके ट्रिप टोकन की जानकारी देता है.

यहां दिए गए उदाहरणों में, मंज़िल के अलग-अलग फ़ॉर्मैट का इस्तेमाल करके, Google Maps के लिए लॉन्च यूआरएल को फ़ॉर्मैट करने का तरीका बताया गया है:

  • अक्षांश/देशांतर के कोऑर्डिनेट:
    https://www.google.com/maps/dir/?api=1&destination=-33.8569%2C151.2152&dir_action=navigate&action_token=TRIP_TOKEN
  • पते की स्ट्रिंग:
    https://www.google.com/maps/dir/?api=1&destination=1600%20Amphitheatre%20Parkway...&dir_action=navigate&action_token=TRIP_TOKEN
  • जगह का आईडी:
    https://www.google.com/maps/dir/?api=1&destination_place_id=PLACE_ID&dir_action=navigate&action_token=TRIP_TOKEN

Waze

Waze के लिए, अपने लॉन्च यूआरएल में ये पैरामीटर शामिल करें:

  • navigate=yes: इस पैरामीटर की मदद से, ऐक्टिव नेविगेशन को ज़बरदस्ती चालू किया जाता है.
  • external_trip_token: यह पैरामीटर, पुष्टि किए गए आपके ट्रिप टोकन की जानकारी देता है.

यहां दिए गए उदाहरणों में, मंज़िल के अलग-अलग फ़ॉर्मैट का इस्तेमाल करके, Waze के लिए लॉन्च यूआरएल को फ़ॉर्मैट करने का तरीका बताया गया है:

  • अक्षांश/देशांतर के कोऑर्डिनेट:
    https://waze.com/ul?ll=-33.8569%2C151.2152&navigate=yes&external_trip_token=TRIP_TOKEN
  • पते की स्ट्रिंग:
    https://waze.com/ul?&q=1600%20Amphitheatre...&navigate=yes&external_trip_token=TRIP_TOKEN
  • जगह का आईडी:
    https://waze.com/ul?google_place_id=PLACE_ID&navigate=yes&external_trip_token=TRIP_TOKEN

अपना ऐप्लिकेशन आईडी सबमिट करें (सिर्फ़ Android के लिए)

Navigation Connect की मदद से यात्रा शुरू करने के लिए, आपको Android पर अपने ऐप्लिकेशन में नेविगेशन सेशन एट्रिब्यूट करना होगा. इसके लिए, पुष्टि किया गया अपना ऐप्लिकेशन आईडी दें. इससे आपके ऐप्लिकेशन की पहचान, यात्रा के सोर्स के तौर पर होती है. इससे Google Maps या Waze, चालू यात्रा को आपके प्लैटफ़ॉर्म से वापस लिंक कर सकता है. ऐप्लिकेशन आईडी मौजूद न होने या अमान्य होने पर, यात्रा के टोकन की पुष्टि नहीं हो पाती.

ऐप्लिकेशन आईडी देने पर, ये सुविधाएं चालू हो जाती हैं:

  • डेटा शेयर करने की अनुमति देना: इससे यह पुष्टि होती है कि आपके ऐप्लिकेशन को चालू यात्रा का डेटा पाने की अनुमति है.
  • ड्राइवर की सहमति पाने की सुविधा चालू करें: इससे सहमति वाली स्क्रीन पर, आपके कारोबार का नाम और निजता नीति अपने-आप भर जाती है. इससे यह पक्का होता है कि ड्राइवर को पता हो कि उसकी जगह की रीयल-टाइम जानकारी और ईटीए किसे मिल रहा है.
  • वापस जाने का बटन चालू करना: इससे Google Maps या Waze को ब्रैंडेड वापस जाने का बटन बनाने की सुविधा मिलती है, ताकि ड्राइवर आपके ऐप्लिकेशन पर वापस जा सकें.

Android पर Google Maps या Waze को ऐप्लिकेशन आईडी पास करने के लिए, Intent.EXTRA_REFERRER_NAME का इस्तेमाल करके, लॉन्च इंटेंट (जिसमें लॉन्च यूआरएल स्ट्रिंग होती है) में अपने पैकेज का नाम जोड़ें.

नीचे दिए गए उदाहरण में, इंटेंट में पैकेज का नाम जोड़ने का तरीका बताया गया है:

intent.putExtra(Intent.EXTRA_REFERRER_NAME, "android-app://${application.packageName}")

ड्राइवर को आपके ऐप्लिकेशन पर वापस जाने की सुविधा देने का तरीका

Google Maps ऐप्लिकेशन में सबसे नीचे एक बार है. इसमें बाईं ओर, 'वापस जाएं' बटन, ऐप्लिकेशन का नाम, और डेटा शेयर करने का आइकॉन है. दाईं ओर, ब्रैंड के लोगो वाले 'वापस जाएं' बटन के साथ Waze ऐप्लिकेशन.

Navigation Connect, Google Maps में सबसे नीचे एक बार दिखाता है. वहीं, Waze में यह ब्रैंडेड 'वापस जाएं' बटन दिखाता है. इससे ड्राइवर, यात्रा के दौरान या मंज़िल पर पहुंचने के बाद, किसी भी समय आपके ऐप्लिकेशन पर वापस जा सकता है.

Android

आपको एक ऐसा PendingIntent बनाना होगा जो आपके ऐप्लिकेशन की गतिविधि पर वापस ले जाए. इस PendingIntent को लॉन्च इंटेंट में अतिरिक्त जानकारी के तौर पर अटैच करें. इसके लिए, सटीक कुंजी "pendingIntent" का इस्तेमाल करें. जब उपयोगकर्ता 'वापस जाएं' बटन पर टैप करता है, तो Google Maps या Waze इस इंटेंट को लागू करता है, ताकि आपके ऐप्लिकेशन को फ़ोरग्राउंड में लाया जा सके.

intent.putExtra("pendingIntent", getPendingIntent())

iOS (सिर्फ़ Waze)

'वापस जाएं' बटन को चालू करने के लिए, आपको लॉन्च यूआरएल में कुछ भी जोड़ने की ज़रूरत नहीं है. Waze, अपने-आप उस यूनिवर्सल लिंक का इस्तेमाल करता है जिसे आपने अपने ऐप्लिकेशन की पुष्टि करते समय रजिस्टर किया था.

कोड सैंपल

यहां दिए गए कोड सैंपल से पता चलता है कि नेविगेशन कनेक्ट का इस्तेमाल करके, अपने ऐप्लिकेशन से Google Maps या Waze को कैसे लॉन्च किया जा सकता है. साथ ही, "ऐप्लिकेशन पर वापस जाएं" बटन को कैसे चालू किया जा सकता है.

Google Maps (Android)

यहां दिए गए Kotlin कोड में, एक सैंपल फ़ंक्शन दिखाया गया है. यह फ़ंक्शन, ज़रूरी पैरामीटर के साथ Navigation Connect सेशन लॉन्च करता है.

private val destinationAddress = "1600 Amphitheatre Parkway, Mountain View, CA 94043"

        private fun launchNavConnect() {
           val jwtToken = "TRIP_TOKEN"

           try {
               // URL Encode the destination
               val encodedDestination = URLEncoder.encode(destinationAddress, "UTF-8")
               val navConnectUrl = "https://www.google.com/maps/dir/?api=1" +
                       "&destination=$encodedDestination" +
                       "&dir_action=navigate" +
                       "&action_token=$jwtToken"

               val intent = Intent(Intent.ACTION_VIEW, Uri.parse(navConnectUrl))
               // Explicitly set GMM package to ensure it opens in Google Maps
               intent.setPackage("com.google.android.apps.maps")
               // Add your application ID to the intent
               intent.putExtra(Intent.EXTRA_REFERRER_NAME, "android-app://${application.packageName}")
               // set up the NavConnect back button
               intent.putExtra("pendingIntent", getPendingIntent())
               startActivity(intent)

           } catch (e: Exception) {
               // handle errors
           }
        }

        private fun getPendingIntent(): PendingIntent? {
          val returnIntent = Intent(application, MainActivity::class.java) // replace with your activity to launch
          returnIntent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_SINGLE_TOP)
          val flags = PendingIntent.FLAG_IMMUTABLE
          if (Build.VERSION.SDK_INT < Build.VERSION_CODES.VANILLA_ICE_CREAM) {
            return PendingIntent.getActivity(application, 0, returnIntent, flags)
          }

          val options =
            ActivityOptions.makeBasic()
              .setPendingIntentCreatorBackgroundActivityStartMode(
                ActivityOptions.MODE_BACKGROUND_ACTIVITY_START_ALLOWED
              )

          return PendingIntent.getActivity(application, 0, returnIntent, flags, options.toBundle())
        }

Waze (Android)

यहां दिए गए Kotlin कोड में, एक सैंपल फ़ंक्शन दिखाया गया है. यह फ़ंक्शन, ज़रूरी पैरामीटर के साथ Navigation Connect सेशन लॉन्च करता है.

private val destinationAddress = "1600 Amphitheatre Parkway, Mountain View, CA 94043"

         private fun launchNavConnect() {
            val tripToken = "TRIP_TOKEN"

            try {
                // URL Encode the destination
                val encodedDestination = URLEncoder.encode(destinationAddress, "UTF-8")
                val navConnectUrl = "https://waze.com/ul?" +
                        "&q=$encodedDestination" +
                        "&navigate=yes" +
                        "&external_trip_token=$tripToken"

                val intent = Intent(Intent.ACTION_VIEW, Uri.parse(navConnectUrl))
                // Explicitly set package name to ensure it opens in Waze
                intent.setPackage("com.waze")
                // Add your application ID to the intent
                val referrerName = "android-app://${application.packageName}"
                intent.putExtra(Intent.EXTRA_REFERRER_NAME, referrerName)

                // set up the NavConnect back button
                intent.putExtra("pendingIntent", getPendingIntent())
                startActivity(intent)

            } catch (e: Exception) {
                // handle errors
            }
         }

         private fun getPendingIntent(): PendingIntent? {
           val returnIntent = Intent(application, MainActivity::class.java) // replace with your activity to launch
           returnIntent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_SINGLE_TOP)
           val flags = PendingIntent.FLAG_IMMUTABLE
           if (Build.VERSION.SDK_INT < Build.VERSION_CODES.VANILLA_ICE_CREAM) {
             return PendingIntent.getActivity(application, 0, returnIntent, flags)
           }

           val options =
             ActivityOptions.makeBasic()
               .setPendingIntentCreatorBackgroundActivityStartMode(
                 ActivityOptions.MODE_BACKGROUND_ACTIVITY_START_ALLOWED
               )

           return PendingIntent.getActivity(application, 0, returnIntent, flags, options.toBundle())
         }

Waze (iOS)

यहां दिए गए Swift कोड में, एक सैंपल फ़ंक्शन दिखाया गया है. यह फ़ंक्शन, ज़रूरी पैरामीटर के साथ Navigation Connect सेशन लॉन्च करता है.

openWazeUrl(queryItems: [URLQueryItem(name: "q", value: "1600 Amphitheatre Parkway")])

        private func openWazeUrl(queryItems: [URLQueryItem]) {
          var components = URLComponents()
          components.scheme = "https"
          components.host = "waze.com"
          components.path = "/ul"

          // Create a mutable copy of the queryItems.
          var mutableQueryItems = queryItems

          // Add Trip Token
          guard let tokenText = tokenField.text, !tokenText.isEmpty else {
            return
          }
          let token = URLQueryItem(name: "external_trip_token", value: tokenText)

          mutableQueryItems.append(token)

          // Add compulsory params
          mutableQueryItems.append(URLQueryItem(name: "navigate", value: "yes"))

          // Construct and Launch URL
          components.queryItems = mutableQueryItems

          guard let url = components.url else {
            return
          }

          UIApplication.shared.open(url, options: [:], completionHandler: nil)
        }
       }