ব্যবহার করার জন্য ট্রাফিক মডেলের ধরন নির্দিষ্ট করুন

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর ডেভেলপার

আপনার বিলিং ঠিকানা ইউরোপীয় অর্থনৈতিক অঞ্চলে হলে, ৮ জুলাই ২০২৫ থেকে কার্যকর, Google Maps Platform EEA পরিষেবার শর্তাবলী আপনার পরিষেবা ব্যবহারের ক্ষেত্রে প্রযোজ্য হবে। অঞ্চল অনুযায়ী কার্যকারিতা আলাদা আলাদা হয়। আরও জানুন।

এই প্রোডাক্ট বা ফিচার পরীক্ষামূলক (প্রি-GA) পর্যায়ে রয়েছে। প্রি-GA প্রোডাক্ট ও ফিচারের ক্ষেত্রে সীমিত সহায়তা থাকতে পারে এবং প্রি-GA প্রোডাক্ট ও ফিচারে করা পরিবর্তন অন্যান্য প্রি-GA ভার্সনের সাথে মানানসই নাও হতে পারে। Pre-GA অফারিং Google Maps Platform-এর পরিষেবা সম্পর্কিত নির্দিষ্ট শর্তাবলী দ্বারা কভার করা হয়। আরও তথ্যের জন্য, লঞ্চের বিভিন্ন স্টেজের বিবরণ দেখুন।

ট্রাফিক মডেল নির্দিষ্ট অ্যালগরিদম এবং ফ্যাক্টর ব্যবহার করে ট্রাফিক পরিস্থিতি কীভাবে একটি নির্দিষ্ট রুটের জন্য মোট ভ্রমণের সময়কে প্রভাবিত করে তা অনুমান করে। Routes API ট্রাফিকের মধ্যে সময় হিসেব করার জন্য ব্যবহৃত বিভিন্ন ফ্যাক্টরকে অগ্রাধিকার দিতে বিভিন্ন ট্রাফিক মডেলের ধরন অফার করে। আপনার রুট বা রুট ম্যাট্রিক্সের জন্য সময়সীমা গণনা করার সময়, আপনি যে ধরনের ট্রাফিক মডেল ব্যবহার করতে চান তা নির্দিষ্ট করতে পারবেন। আপনি ট্রাফিক মডেলের ধরন সেট করলে, আপনার বেছে নেওয়া ট্রাফিক মডেলের উপর নির্ভর করে duration ফিল্ডে রিটার্ন করা ভ্যালু আলাদা আলাদা হয়।

Routes API Compute Routes এবং Compute Route Matrix পদ্ধতি, উভয়ই ট্রাফিক মডেলের ধরনকে সাপোর্ট করে।

সাধারণত, দুটি পদ্ধতিতেই BEST_GUESS ট্রাফিক মডেলের ধরন ব্যবহার করা হয়।

ট্রাফিকের ধরন নির্দিষ্ট করতে

1. আপনার যাত্রা শুরুর জায়গা ও গন্তব্য সেট করুন।

2. আপনার ছাড়ার সময় ভবিষ্যতে হলে, departure_time প্যারামিটার ব্যবহার করে সময় যোগ করুন। আপনি ছাড়ার সময় উল্লেখ না করলে, এটি ডিফল্ট হিসেবে এখনকার সময় সেট করে।

3. routingPreference প্যারামিটার TRAFFIC_AWARE_OPTIMAL-এ সেট করুন। routingPreference-কে TRAFFIC_UNAWARE বা TRAFFIC_AWARE-এ সেট করা trafficModel প্যারামিটারের সাথে মানানসই নয়।

4. trafficModel প্যারামিটারের সাথে ব্যবহার করার জন্য ট্রাফিক মডেল বেছে নিন এবং নিচে উল্লেখ করা ধরনগুলির মধ্যে একটি বেছে নিন:

   • BEST_GUESS (ডিফল্ট) যাতে রিটার্ন করা duration_in_traffic ঐতিহাসিক ট্রাফিক পরিস্থিতি ও লাইভ ট্রাফিক, এই দু'টি সম্পর্কে যা জানা আছে তার ভিত্তিতে ভ্রমণের সময়ের সেরা আনুমানিক হিসেব হয়। departure_time যত বর্তমান সময়ের কাছাকাছি হবে, লাইভ ট্রাফিক তত বেশি গুরুত্বপূর্ণ হয়ে উঠবে। BEST_GUESS-এর ডিফল্ট ধরন ব্যবহার করলে, বেশিরভাগ ব্যবহারের ক্ষেত্রে সবচেয়ে উপযোগী ভবিষ্যদ্বাণী পাওয়া যায়।

   • PESSIMISTIC অনুরোধ করে যে ফেরত আসা duration_in_traffic মডেলটি খারাপ ট্রাফিক দিনে ঐতিহাসিক ট্রাফিক পরিস্থিতির উপর ভিত্তি করে সময় দেখায়। এই ধরনের ক্ষেত্রে, আনুমানিক সময়সীমা দেওয়া হয় যা বেশিরভাগ দিনেই প্রকৃত ভ্রমণের সময়ের চেয়ে বেশি হয়। কখনও কখনও বিশেষ খারাপ পরিস্থিতি হলে, এই আনুমানিক সময়সীমা অতিক্রম করতে পারে।

   • OPTIMISTIC যাতে ফেরত আসা duration_in_traffic মডেলটি ভাল ট্রাফিক দিনে ঐতিহাসিক ট্রাফিক অবস্থার উপর ভিত্তি করে সময় দেখায়। এই ধরনের ক্ষেত্রে, আনুমানিক সময়সীমা দেওয়া হয় যা বেশিরভাগ দিনেই প্রকৃত ভ্রমণের সময়ের থেকে কম হয়। বিশেষ করে ভাল কন্ডিশন থাকলে, কোনও কোনও দিন এই আনুমানিক সময়ের চেয়েও কম সময় লাগতে পারে।

   যেমন:

   "trafficModel": "OPTIMISTIC"

   মনে রাখবেন: BEST_GUESS লাইভ ট্রাফিক সংক্রান্ত তথ্য যেভাবে ইন্টিগ্রেট করে, তার জন্য BEST_GUESS ভ্রমণের সময় সংক্রান্ত পূর্বাভাস OPTIMISTIC-এর থেকে কম বা PESSIMISTIC-এর থেকে বেশি হতে পারে।

5. ফিল্ড মাস্কে routes.duration ফিল্ড নির্দিষ্ট করুন।

   REST

   -H X-Goog-FieldMask: routes.duration

   RPC

   const (fieldMask = "routes.duration")

Routes API ট্রাফিকে সময় অনুমান করার সময়, আপনার অনুরোধ করা ট্রাফিক মডেলের ধরন ব্যবহার করে।

উদাহরণ: ট্রাফিক মডেল সংক্রান্ত অনুরোধ

যেমন, এই অনুরোধে নির্দিষ্ট করা হয়েছে যে OPTIMISTIC নির্দিষ্ট ছাড়ার সময়ে ট্রাফিক মডেলের ধরন ব্যবহার করে সময়সীমা আনুমানিক হিসেব করতে হবে:

curl -X POST -H 'content-type: application/json' -d ' {
"origin": {
  "address": "Kyoto, Japan"
  },
"destination": {
  "placeId": "ChIJrYtcv-urAWAR3XzWvXv8n_s"
  },
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE_OPTIMAL",
"trafficModel": "OPTIMISTIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

এই অনুরোধ ট্রিপের জন্য OPTIMISTIC ট্রাফিক মডেল টাইপ ব্যবহার করে আনুমানিক সময় দেখায়:

"duration": "1238s"

আপনি ট্রাফিক মডেলের ধরন পরিবর্তন করে PESSIMISTIC করলে, রিটার্ন করা সময়সীমা আরও বেশি হবে:

"duration": "2436s"

মনে রাখবেন: আপনি departureTime উল্লেখ না করলে, অনুরোধ করার সময়কেই প্রস্থান করার সময় হিসেবে ধরে নেওয়া হবে। এর অর্থ হল, অনুরোধ পাঠানোর সময়ের উপর নির্ভর করে আপনি আলাদা আলাদা ভ্যালু পেতে পারেন।