Google Maps বা Waze চালু করুন

নেভিগেশন সেশন শুরু করতে, আপনার অ্যাপকে অবশ্যই Google Maps বা Waze খোলার জন্য একটি লঞ্চ URL ডাইনামিকভাবে তৈরি করতে হবে। এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে ট্রিপ তৈরি করুন থেকে যাচাই করা ট্রিপ টোকেন ব্যবহার করে Google Maps বা Waze চালু করবেন এবং আপনার অ্যাপে ফিরে আসার অভিজ্ঞতা কনফিগার করবেন।

Google Maps বা Waze কীভাবে লঞ্চ করবেন

Google Maps বা Waze চালু করতে, আপনাকে অবশ্যই এমন একটি উপায় প্রদান করতে হবে যাতে ড্রাইভাররা আপনার অ্যাপ থেকে একটি নেভিগেশন সেশন শুরু করতে পারে, প্রয়োজনীয় প্যারামিটার সহ লঞ্চ URL তৈরি করতে পারে এবং সেশনের অ্যাট্রিবিউট দিতে আপনার অ্যাপ্লিকেশন আইডি প্রদান করতে পারে।

ড্রাইভারদের আপনার অ্যাপ থেকে নেভিগেশন শুরু করতে দিন

আপনার অ্যাপ থেকে ড্রাইভারদের নেভিগেশন শুরু করার সুবিধা প্রদান করা উচিত। আপনি যদি ড্রাইভারদের একটি বোতাম ব্যবহার করে Google Maps বা Waze চালু করতে দেন, তাহলে সঠিক অ্যাট্রিবিউশন নিশ্চিত করুন এবং এটিকে স্পষ্টভাবে লেবেল করে বিভ্রান্তি এড়ান। যেমন, বোতামের উপরে বা কাছাকাছি "Google Maps" বা "Waze" টেক্সটটি রাখুন।

লঞ্চ URL তৈরি করুন

নেভিগেশন সেশন শুরু করতে, Navigation Connect লঞ্চ URL তৈরি করুন। এই URL হল একটি স্ট্রিং যাতে গন্তব্য, ট্রিপ টোকেন এবং প্রয়োজনীয় নেভিগেশন প্যারামিটার থাকে। এটি স্ট্যান্ডার্ড Google Maps URL বা Waze ডিপ লিঙ্কের মতো একইভাবে কাজ করে।

ড্রাইভারের ডিভাইসে Google Maps বা Waze চালু করতে, প্ল্যাটফর্ম-নির্দিষ্ট মেকানিজম ব্যবহার করুন:

  • Android: Intent-এ URL স্ট্রিং পাস করুন।
  • iOS: URL স্ট্রিং ইউনিভার্সাল লিঙ্ক (বা ডিপ লিঙ্ক) হিসেবে ব্যবহার করুন।

গন্তব্য ফর্ম্যাট করুন

Google Maps বা Waze যাতে কোনও রুট সঠিকভাবে গণনা করতে পারে তা নিশ্চিত করতে, আপনার গন্তব্য ফর্ম্যাট করার সময় নিম্নলিখিত নিয়মগুলি মেনে চলুন:

  • ঠিক একটি পৌঁছানো যায় এমন গন্তব্য নির্দিষ্ট করুন। আপনি গন্তব্যকে ঠিকানার স্ট্রিং, অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট বা কোনও জায়গার আইডি হিসেবে পাস করতে পারেন।

  • একাধিক ওয়েপয়েন্ট ব্যবহার করবেন না। URL-এ সরাসরি একাধিক ওয়েপয়েন্ট পাস করলে, Google Maps বা Waze-এ সমস্যা সংক্রান্ত মেসেজ দেখানো হয়। পরিবর্তে, আলাদা আলাদা ট্রিপ তৈরি করুন।

ট্রিপ টোকেন ও নেভিগেশন প্যারামিটার যোগ করা

লঞ্চ URL সম্পূর্ণ করতে, আপনাকে অবশ্যই যাচাই করা ট্রিপ টোকেন অন্তর্ভুক্ত করতে হবে যা আপনি ট্রিপ তৈরি করুন অনুরোধ থেকে পেয়েছেন। এছাড়াও, আপনাকে নেভিগেশন প্যারামিটার অন্তর্ভুক্ত করতে হবে যা Google Maps বা Waze-কে অ্যাক্টিভ নেভিগেশন শুরু করতে বলে।

Google Maps

Google Maps-এর জন্য, আপনার লঞ্চ URL-এ নিম্নলিখিত প্যারামিটারগুলি অন্তর্ভুক্ত করুন:

  • dir_action=navigate: এই প্যারামিটার অ্যাক্টিভ নেভিগেশনকে বাধ্য করে।
  • action_token: এই প্যারামিটার আপনার যাচাই করা ট্রিপ টোকেন প্রদান করে।

নিচের উদাহরণগুলি থেকে বোঝা যাবে যে বিভিন্ন গন্তব্য ফর্ম্যাট ব্যবহার করে Google Maps-এর জন্য লঞ্চ URL কীভাবে ফর্ম্যাট করতে হয়:

  • অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট:
    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-এর জন্য, আপনার লঞ্চ URL-এ নিম্নলিখিত প্যারামিটারগুলি অন্তর্ভুক্ত করুন:

  • navigate=yes: এই প্যারামিটার অ্যাক্টিভ নেভিগেশন চালু করতে বাধ্য করে।
  • external_trip_token: এই প্যারামিটার আপনার যাচাই করা ট্রিপ টোকেন প্রদান করে।

নিচের উদাহরণগুলি থেকে বোঝা যাবে যে বিভিন্ন গন্তব্য ফর্ম্যাট ব্যবহার করে Waze-এর জন্য লঞ্চ URL কীভাবে ফর্ম্যাট করতে হয়:

  • অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট:
    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 আপনার প্ল্যাটফর্মে অ্যাক্টিভ ট্রিপ লিঙ্ক করতে পারে। অ্যাপ্লিকেশন আইডি না থাকলে বা ভুল হলে ট্রিপ টোকেন যাচাইকরণ করা যায় না।

আপনার অ্যাপ্লিকেশন আইডি প্রদান করলে নিম্নলিখিত ফিচার চালু হয়:

  • ডেটা শেয়ার করার অনুমতি দেওয়া: আপনার অ্যাপ অ্যাক্টিভ ট্রিপের ডেটা পাওয়ার জন্য অনুমোদিত কিনা তা যাচাই করে।
  • ড্রাইভারের সম্মতি চালু করুন: আপনার ব্যবসার নাম এবং গোপনীয়তা নীতি সহ সম্মতি সংক্রান্ত স্ক্রিন দেখায়, যাতে ড্রাইভার জানতে পারেন যে কে তার রিয়েল-টাইম লোকেশন এবং ETA-এর তথ্য পাচ্ছেন।
  • ফেরত আসার বোতাম চালু করুন: Google Maps বা Waze-কে ব্র্যান্ডেড ফেরত আসার বোতাম তৈরি করার অনুমতি দেয় যাতে ড্রাইভাররা আপনার অ্যাপে ফিরে আসতে পারেন।

Android-এ Google Maps বা Waze-এ অ্যাপ্লিকেশন আইডি পাস করতে, Intent.EXTRA_REFERRER_NAME ব্যবহার করে লঞ্চ ইনটেন্টে (যা লঞ্চ URL স্ট্রিং বহন করে) আপনার প্যাকেজের নাম যোগ করুন।

ইনটেন্টে কীভাবে প্যাকেজের নাম যোগ করতে হয় তা নিম্নলিখিত উদাহরণ থেকে দেখুন:

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

ড্রাইভারদের কীভাবে আপনার অ্যাপে ফিরিয়ে আনবেন

Google Maps অ্যাপের নিচের বারে বাঁদিকে ফিরে যাওয়ার বোতাম, অ্যাপের নাম ও ডেটা শেয়ারিং আইকন আছে। ডানদিকে ব্র্যান্ডেড ব্যাক বোতাম সহ Waze অ্যাপ।

নেভিগেশন কানেক্ট একটি নিচের বার (Google Maps) বা একটি ব্র্যান্ডেড ব্যাক বোতাম (Waze) দেখায় যাতে ড্রাইভার ট্রিপের সময় বা গন্তব্যে পৌঁছানোর সময় যেকোনও পয়েন্টে নির্বিঘ্নে আপনার অ্যাপে ফিরে যেতে পারে।

Android

আপনাকে অবশ্যই একটি PendingIntent তৈরি করতে হবে যা আপনার অ্যাপের অ্যাক্টিভিটিতে ফিরে আসে। লঞ্চ ইনটেন্টে অতিরিক্ত হিসেবে এই PendingIntent অ্যাটাচ করুন সঠিক কী "pendingIntent" ব্যবহার করে। ব্যবহারকারী ফিরে আসার বোতামে ট্যাপ করলে, Google Maps বা Waze আপনার অ্যাপকে ফোরগ্রাউন্ডে নিয়ে আসার জন্য এই ইনটেন্ট এক্সিকিউট করে।

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

iOS (শুধুমাত্র Waze)

ফিরে আসার বোতাম চালু করার জন্য লঞ্চ URL-এ আপনাকে কিছু যোগ করতে হবে না। 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)
        }
       }