ট্রিপ তৈরি করে ট্রিপ টোকেন পাওয়া

ড্রাইভারের জন্য নিরাপদে ধাপে ধাপে নেভিগেশন সেশন চালু করতে, আপনার ব্যাকএন্ডকে অবশ্যই একটি ট্রিপ তৈরি করতে হবে এবং Navigation Connect API থেকে একটি যাচাইকৃত ট্রিপ টোকেন পেতে হবে।

Navigation Connect-এ, ট্রিপ বলতে একটি গন্তব্যে নেভিগেশন সেশনকে বোঝায়। ট্রিপ তৈরি করতে এবং সেশন অনুমোদিত করার জন্য প্রয়োজনীয় যাচাই করা ট্রিপ টোকেন (authToken) পেতে, CreateTrip পদ্ধতিতে একটি CreateTripRequest মেসেজ পাঠান। Google Maps বা Waze-এর লঞ্চ URL-এ অন্তর্ভুক্ত করতে আপনার মোবাইল অ্যাপে ট্রিপ টোকেন পাস করুন।

এই গাইডে অনন্য ট্রিপ আইডি তৈরি করে এবং আপনার API অনুরোধ জমা দিয়ে কীভাবে এই প্রসেস সম্পূর্ণ করতে হয় তা বর্ণনা করা হয়েছে।

CreateTripRequest মেসেজ তৈরি করুন

ট্রিপ তৈরি করতে এবং ট্রিপ টোকেন পেতে, CreateTripRequest মেসেজ তৈরি ও পাঠানোর জন্য নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

  1. যাচাইকরণ: আপনার অনুরোধ অনুমোদন করার জন্য অ্যাক্সেস টোকেন পেতে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল (ADC) ব্যবহার করুন। আরও জানতে, OAuth টোকেন তৈরি করুন দেখুন।
  2. ট্রিপ আইডি তৈরি করা: আপনার সার্ভারে ট্রিপ শনাক্ত করার জন্য UUIDv4 ফর্ম্যাটে একটি অনন্য ট্রিপ আইডি (tripId) তৈরি করুন।
  3. পেলোড তৈরি করুন: আপনার অ্যাপ আইডি ও কনফিগারেশন সেটিংস সহ JSON পেলোড তৈরি করুন।
  4. CreateTrip মেথড কল করুন: হেডারে অ্যাক্সেস টোকেন ও বডিতে পেলোড সহ API-তে POST অনুরোধ পাঠান।

নিম্নলিখিত উদাহরণে দেখানো হয়েছে যে কীভাবে CreateTripRequest মেসেজ পাঠিয়ে ট্রিপ তৈরি করতে হয়:

#!/bin/bash

# Authenticate with ADC
access_token="$(gcloud auth application-default login --impersonate-service-account=SERVICE_ACCOUNT_EMAIL)"

# Generate a unique Trip ID
trip_id="$(uuidgen)"

# Construct the payload
payload=$(cat <<EOF
{
  "androidAppId": "ANDROID_APP_ID",
  "iosAppId": "IOS_APP_ID",
  "config": {
    "enablePubsub": true
  }
}
EOF
)

# Call the CreateTrip method to request a trip token
curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json" \
-d "${payload}"

ঐচ্ছিক কনফিগারেশন

CreateTripRequest মেসেজে নিম্নলিখিত সেটিংস অ্যাডজাস্ট করে আপনি ট্রিপের ডেটা কাস্টমাইজ করতে পারবেন:

ফিচার ধরন বিবরণ
বাকি রুটের ব্যাপারে রিপোর্ট করা boolean

অ্যাক্টিভ রুট পলিলাইন ও রিয়েল-টাইম ট্রাফিক পরিস্থিতি সংক্রান্ত তথ্য পেতে, config.enableRemainingRouteReporting-কে true হিসেবে সেট করুন।

ড্রাইভারদের Android-এ Waze ভার্সন 5.20.0.2 বা তার পরের ভার্সন, iOS-এ 5.20.0.1 বা তার পরের ভার্সন অথবা Android-এর জন্য Google Maps ভার্সন 26.27 বা তার পরের ভার্সন থাকতে হবে।

রুট ডেভিয়েশন সংক্রান্ত রিপোর্টিং (শুধুমাত্র Waze) boolean

ড্রাইভার কখন রুট থেকে সরে যাচ্ছেন তা ট্র্যাক করতে, config.enableRouteDeviationReporting-কে true-এ সেট করুন।

ড্রাইভারদের Waze-এর 5.22 বা তার পরবর্তী যেকোনও ভার্সন প্রয়োজন।

ট্রিপ আপডেট করার ফ্রিকোয়েন্সি boolean

ডিফল্ট হিসেবে, Navigation Connect প্রতি ৬০ সেকেন্ড অন্তর ট্রিপ ডেটা আপডেট করে। হাই-ফ্রিকোয়েন্সি আপডেট (প্রতি ৫ সেকেন্ডে) চালু করতে, config.enableHighFrequencyUpdates-কে true-এ সেট করুন।

Google Cloud Pub/Sub ইভেন্ট তৈরি করা boolean

Google Cloud Pub/Sub ব্যবহার করে ট্রিপ ইভেন্ট জেনারেশন চালু করতে, config.enablePubsub-কে true-এ সেট করুন। এই ফিচার সাধারণত বন্ধ করা থাকে।

Google Cloud Pub/Sub ফিল্ড মাস্ক FieldMask

পেলোডের সাইজ ম্যানেজ করতে এবং ব্যাকএন্ড প্রসেসিং লোড বা Google Cloud Pub/Sub ব্যবহারের খরচ কমাতে, আপনার ইভেন্ট স্ট্রিম থেকে ভারী ফিল্ড (যেমন execution.remainingRoute) বাদ দিতে config.pubsubFieldMask ব্যবহার করুন। বাকি থাকা রুট ডেটার জন্য পেলোড সাইজ সম্পর্কে আরও তথ্য পেতে, বাকি থাকা রুট ডেটা ম্যানেজ করুন দেখুন।

উত্তর থেকে ট্রিপ টোকেন পাওয়া

CreateTrip পদ্ধতিটি যাচাই করা ট্রিপ টোকেন সহ একটি উত্তর প্রদান করে। নেভিগেশন সেশন অনুমোদন করতে, রেসপন্স থেকে এই টোকেন এক্সট্র্যাক্ট করুন এবং লঞ্চ URL-এ অন্তর্ভুক্ত করার জন্য আপনার মোবাইল অ্যাপে এটি পাস করুন।

নিম্নলিখিত কোড স্যাম্পেল থেকে উত্তরের উদাহরণ দেখানো হয়েছে:

{
    "name": "projects/PROJECT_NUMBER/trips/TRIP_ID",
  "authToken": {
    "token": "BASE64_ENCODED_TRIP_TOKEN",
    "expireTime": "2026-03-06T11:09:47.476942Z"
  },
  "state": "NEW",
  "execution": {
    "traveledDistanceMeters": 0,
    "stopAddedInRoute": false
  },
  "createTime": "2026-03-05T23:09:50.768959Z",
  "updateTime": "2026-03-05T23:09:50.768959Z"
}

এই উত্তরে নিম্নলিখিত ভ্যালু অন্তর্ভুক্ত:

  • PROJECT_NUMBER: আপনার প্রোজেক্টের জন্য একটি অনন্য সংখ্যাসূচক শনাক্তকারী। এটি আপনার আলফানিউমেরিক প্রোজেক্ট আইডি থেকে আলাদা হলেও একই Google Cloud প্রোজেক্টকে বোঝায়।
  • TRIP_ID: UUIDv4 ফর্ম্যাটে আপনার ব্যাকএন্ডের মাধ্যমে তৈরি করা ট্রিপ আইডি।
  • BASE64_ENCODED_TRIP_TOKEN: CreateTrip পদ্ধতি দ্বারা ফেরত পাঠানো যাচাই করা ট্রিপ টোকেন (authToken.token)। Google Maps বা Waze-এ ট্র্যাক করা ধাপে ধাপে নেভিগেশন শুরু করতে আপনার মোবাইল অ্যাপে এই টোকেন পাস করুন।

এর পরে কী করতে হবে

Google Maps বা Waze লঞ্চ করতে ট্রিপ টোকেন ব্যবহার করুন।

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