ড্রাইভারের জন্য নিরাপদে ধাপে ধাপে নেভিগেশন সেশন চালু করতে, আপনার ব্যাকএন্ডকে অবশ্যই একটি ট্রিপ তৈরি করতে হবে এবং Navigation Connect API থেকে একটি যাচাইকৃত ট্রিপ টোকেন পেতে হবে।
Navigation Connect-এ, ট্রিপ বলতে একটি গন্তব্যে নেভিগেশন সেশনকে
বোঝায়। ট্রিপ তৈরি করতে এবং সেশন অনুমোদিত করার জন্য প্রয়োজনীয় যাচাই করা ট্রিপ টোকেন
(authToken) পেতে, CreateTrip পদ্ধতিতে একটি CreateTripRequest
মেসেজ পাঠান। Google Maps বা Waze-এর লঞ্চ URL-এ অন্তর্ভুক্ত করতে
আপনার মোবাইল অ্যাপে ট্রিপ টোকেন পাস করুন।
এই গাইডে অনন্য ট্রিপ আইডি তৈরি করে এবং আপনার API অনুরোধ জমা দিয়ে কীভাবে এই প্রসেস সম্পূর্ণ করতে হয় তা বর্ণনা করা হয়েছে।
CreateTripRequest মেসেজ তৈরি করুন
ট্রিপ তৈরি করতে এবং ট্রিপ টোকেন পেতে, CreateTripRequest মেসেজ তৈরি ও পাঠানোর জন্য
নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
- যাচাইকরণ: আপনার অনুরোধ অনুমোদন করার জন্য অ্যাক্সেস টোকেন পেতে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল (ADC) ব্যবহার করুন। আরও জানতে, OAuth টোকেন তৈরি করুন দেখুন।
- ট্রিপ আইডি তৈরি করা: আপনার সার্ভারে ট্রিপ শনাক্ত করার জন্য
UUIDv4
ফর্ম্যাটে একটি অনন্য ট্রিপ আইডি (
tripId) তৈরি করুন। - পেলোড তৈরি করুন: আপনার অ্যাপ আইডি ও কনফিগারেশন সেটিংস সহ JSON পেলোড তৈরি করুন।
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 |
অ্যাক্টিভ রুট পলিলাইন ও রিয়েল-টাইম ট্রাফিক পরিস্থিতি সংক্রান্ত তথ্য পেতে, ড্রাইভারদের Android-এ Waze ভার্সন 5.20.0.2 বা তার পরের ভার্সন, iOS-এ 5.20.0.1 বা তার পরের ভার্সন অথবা Android-এর জন্য Google Maps ভার্সন 26.27 বা তার পরের ভার্সন থাকতে হবে। |
| রুট ডেভিয়েশন সংক্রান্ত রিপোর্টিং (শুধুমাত্র Waze) | boolean |
ড্রাইভার কখন রুট থেকে সরে যাচ্ছেন তা ট্র্যাক করতে, ড্রাইভারদের Waze-এর 5.22 বা তার পরবর্তী যেকোনও ভার্সন প্রয়োজন। |
| ট্রিপ আপডেট করার ফ্রিকোয়েন্সি | boolean |
ডিফল্ট হিসেবে, Navigation Connect প্রতি ৬০ সেকেন্ড অন্তর ট্রিপ ডেটা আপডেট করে। হাই-ফ্রিকোয়েন্সি আপডেট (প্রতি ৫ সেকেন্ডে) চালু করতে, |
| Google Cloud Pub/Sub ইভেন্ট তৈরি করা | boolean |
Google Cloud Pub/Sub ব্যবহার করে ট্রিপ ইভেন্ট জেনারেশন চালু করতে, |
| Google Cloud Pub/Sub ফিল্ড মাস্ক | FieldMask |
পেলোডের সাইজ ম্যানেজ করতে এবং ব্যাকএন্ড প্রসেসিং লোড বা Google Cloud Pub/Sub ব্যবহারের খরচ কমাতে, আপনার ইভেন্ট স্ট্রিম থেকে ভারী ফিল্ড (যেমন |
উত্তর থেকে ট্রিপ টোকেন পাওয়া
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 লঞ্চ করতে ট্রিপ টোকেন ব্যবহার করুন।