একটি ট্রিপ তৈরি করুন এবং একটি ট্রিপ টোকেন পান

দ্রষ্টব্য: এই নথিটি ধরে নেয় যে আপনি নেভিগেশন কানেক্ট এপিআই সেটআপ সম্পন্ন করেছেন।

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

ন্যাভিগেশন কানেক্ট-এ, একটি ট্রিপ একটি নির্দিষ্ট গন্তব্যের জন্য একটি ন্যাভিগেশন সেশনকে বোঝায়। একটি ট্রিপ তৈরি করতে এবং সেশনটিকে অনুমোদন করার জন্য প্রয়োজনীয় অথেনটিকেটেড ট্রিপ টোকেন ( authToken ) পেতে, CreateTrip মেথডে একটি CreateTripRequest মেসেজ পাঠান। গুগল ম্যাপস বা ওয়েজ-এর লঞ্চ ইউআরএল-এ অন্তর্ভুক্ত করার জন্য আপনার মোবাইল অ্যাপে ট্রিপ টোকেনটি পাঠান।

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

একটি 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 মেসেজে নিম্নলিখিত সেটিংস পরিবর্তন করে আপনি ট্রিপের ডেটা কাস্টমাইজ করতে পারেন:

বৈশিষ্ট্য	প্রকার	বর্ণনা
অবশিষ্ট রুটের প্রতিবেদন (শুধুমাত্র Waze-এর জন্য)	boolean	সক্রিয় রুট পলিলাইন এবং রিয়েল-টাইম ট্র্যাফিক পরিস্থিতি পেতে, config.enableRemainingRouteReporting true তে সেট করুন।
ট্রিপ আপডেটের ফ্রিকোয়েন্সি	boolean	ডিফল্টরূপে, নেভিগেশন কানেক্ট প্রতি ৬০ সেকেন্ডে ট্রিপ ডেটা আপডেট করে। ঘন ঘন আপডেট (প্রতি ৫ সেকেন্ডে) চালু করতে, config.enableHighFrequencyUpdates true তে সেট করুন।
গুগল ক্লাউড পাব/সাব ইভেন্ট জেনারেশন	boolean	Google Cloud Pub/Sub ব্যবহার করে ট্রিপ ইভেন্ট তৈরি করা চালু করতে, config.enablePubsub true তে সেট করুন। এই ফিচারটি ডিফল্টরূপে নিষ্ক্রিয় থাকে। দ্রষ্টব্য: গুগল ক্লাউড পাব/সাব ব্যবহারের জন্য আলাদাভাবে চার্জ করে। আরও তথ্যের জন্য, পাব/সাব মূল্যতালিকা দেখুন।
গুগল ক্লাউড পাব/সাব ফিল্ড মাস্ক	FieldMask	পেলোড সাইজ পরিচালনা করতে এবং ব্যাকএন্ড প্রসেসিং লোড বা গুগল ক্লাউড পাব/সাব ব্যবহারের খরচ কমাতে, আপনার ইভেন্ট স্ট্রিম থেকে ভারী ফিল্ড (যেমন execution.remainingRoute ) বাদ দিতে config.pubsubFieldMask ব্যবহার করুন। অবশিষ্ট রুট ডেটার পেলোড সাইজ সম্পর্কে আরও তথ্যের জন্য, "Handle remaining route data" দেখুন।

প্রতিক্রিয়া থেকে ট্রিপ টোকেনটি সংগ্রহ করুন।

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

নিম্নলিখিত কোড নমুনাটি একটি উদাহরণ প্রতিক্রিয়া দেখায়:

{
    "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 : আপনার প্রজেক্টের জন্য একটি অনন্য সংখ্যাসূচক শনাক্তকারী। এটি আপনার আলফানিউমেরিক প্রজেক্ট আইডি থেকে আলাদা, কিন্তু একই গুগল ক্লাউড প্রজেক্টকে বোঝায়।
• TRIP_ID : আপনার ব্যাকএন্ড দ্বারা UUIDv4 ফরম্যাটে তৈরি ট্রিপ আইডি।
• BASE64_ENCODED_TRIP_TOKEN : CreateTrip মেথড দ্বারা ফেরত দেওয়া প্রমাণীকৃত ট্রিপ টোকেন ( authToken.token )। Google Maps বা Waze-এ ট্র্যাক করা টার্ন-বাই-টার্ন নেভিগেশন শুরু করতে এই টোকেনটি আপনার মোবাইল অ্যাপে পাঠান।

দ্রষ্টব্য: ট্রিপ টোকেনটি ১২ ঘন্টা পর মেয়াদোত্তীর্ণ হয়ে যায়। এপিআই (API) রেসপন্সে সঠিক মেয়াদোত্তীর্ণের সময় উল্লেখ থাকে। ড্রাইভার ট্রিপটি পরিচালনা শুরু করার আগেই যদি টোকেনটির মেয়াদ শেষ হয়ে যায়, তবে আপনাকে অবশ্যই একটি নতুন টোকেনের জন্য অনুরোধ করতে হবে।

এরপর কী?

ট্রিপ টোকেনটি ব্যবহার করে গুগল ম্যাপস বা ওয়েজ চালু করুন।

গুগল ম্যাপস বা ওয়েজ চালু করুন