ShipmentModel

string

চালানের ব্যবহারকারী-নির্ধারিত প্রদর্শিত নাম। এটি সর্বোচ্চ ৬৩ অক্ষর দীর্ঘ হতে পারে এবং এতে UTF-8 অক্ষর ব্যবহার করা যেতে পারে।

object ( VisitRequest )

চালানটির সাথে সম্পর্কিত পিকআপ বিকল্পগুলির একটি সেট। যদি নির্দিষ্ট করে দেওয়া না থাকে, তবে যানবাহনটিকে শুধুমাত্র ডেলিভারিগুলির সাথে সঙ্গতিপূর্ণ একটি স্থানে যেতে হবে।

object ( VisitRequest )

চালানটির সাথে সংশ্লিষ্ট ডেলিভারি বিকল্পসমূহের একটি সেট। যদি নির্দিষ্ট করে দেওয়া না থাকে, তবে যানবাহনটিকে শুধুমাত্র পিকআপের সাথে সঙ্গতিপূর্ণ একটি স্থানে যেতে হবে।

map (key: string, value: object ( Load ))

চালানের লোডের চাহিদাগুলো (যেমন ওজন, আয়তন, প্যালেটের সংখ্যা ইত্যাদি) ম্যাপে উল্লেখ করুন। ম্যাপের কী-গুলো সংশ্লিষ্ট লোডের ধরন বর্ণনা করে এমন আইডেন্টিফায়ার হওয়া উচিত, এবং আদর্শগতভাবে এতে এককও অন্তর্ভুক্ত থাকা বাঞ্ছনীয়। উদাহরণস্বরূপ: 'ওজন_কেজি', 'আয়তন_গ্যালন', 'প্যালেট_সংখ্যা', ইত্যাদি। যদি কোনো নির্দিষ্ট কী ম্যাপে না থাকে, তবে সংশ্লিষ্ট লোডটিকে নাল (null) হিসেবে গণ্য করা হবে।

integer

যেসব যানবাহন এই চালানটি সম্পন্ন করতে পারে। যদি খালি থাকে, তবে সব যানবাহনই এটি সম্পন্ন করতে পারে। ShipmentModel এর vehicles তালিকায় তাদের সূচক দ্বারা যানবাহনগুলো চিহ্নিত করা হয়।

number

প্রতিটি যানবাহনের মাধ্যমে এই চালানটি সরবরাহ করার সময় যে খরচ হয় তা নির্দিষ্ট করে। যদি নির্দিষ্ট করা থাকে, তবে এতে অবশ্যই নিম্নলিখিতগুলির মধ্যে যেকোনো একটি থাকতে হবে:

• costsPerVehicleIndices এর সমান সংখ্যক উপাদান। costsPerVehicle[i] মডেলের যানবাহন costsPerVehicleIndices[i] এর সাথে সঙ্গতিপূর্ণ।
• মডেলে যতগুলো যানবাহন আছে, উপাদানের সংখ্যাও তত। i-তম উপাদানটি মডেলের i-তম যানবাহনটিকে নির্দেশ করে।

এই খরচগুলো অবশ্যই penaltyCost -এর এককের সমান হতে হবে এবং ঋণাত্মক হওয়া যাবে না। যদি এই ধরনের কোনো খরচ না থাকে, তবে এই ক্ষেত্রটি খালি রাখুন।

integer

যেসব যানবাহনের ক্ষেত্রে costsPerVehicle প্রযোজ্য, তাদের সূচকসমূহ। যদি এটি খালি না থাকে, তবে এতে costsPerVehicle এর সমান সংখ্যক উপাদান থাকতে হবে। একটি গাড়ির সূচক একাধিকবার উল্লেখ করা যাবে না। যদি কোনো গাড়িকে costsPerVehicleIndices থেকে বাদ দেওয়া হয়, তবে তার খরচ শূন্য হবে।

string ( Duration format)

পিকআপ থেকে ডেলিভারি পর্যন্ত সংক্ষিপ্ততম পথের তুলনায় সর্বাধিক প্রকৃত অতিরিক্ত সময় নির্দিষ্ট করে। যদি এটি নির্দিষ্ট করা হয়, তবে তা অবশ্যই অঋণাত্মক হতে হবে এবং চালানটিতে অন্তত একটি পিকআপ ও একটি ডেলিভারি থাকতে হবে।

উদাহরণস্বরূপ, ধরা যাক t হলো নির্বাচিত পিকআপ বিকল্প থেকে সরাসরি নির্বাচিত ডেলিভারি বিকল্পে যাওয়ার জন্য প্রয়োজনীয় সর্বনিম্ন সময়। তাহলে pickupToDeliveryAbsoluteDetourLimit সেট করলে যা কার্যকর হয় তা হলো:

startTime(delivery) - startTime(pickup) <=
t + pickupToDeliveryAbsoluteDetourLimit

যদি একই চালানের জন্য আপেক্ষিক এবং পরম উভয় সীমা নির্দিষ্ট করা থাকে, তবে প্রতিটি সম্ভাব্য পিকআপ/ডেলিভারি জোড়ার জন্য অধিক সীমাবদ্ধকারী সীমাটি ব্যবহৃত হয়। ২০১৭/১০ তারিখ অনুযায়ী, বিকল্প পথ শুধুমাত্র তখনই সমর্থিত হয় যখন ভ্রমণের সময়কাল যানবাহনের উপর নির্ভরশীল না হয়।

সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' s ' থাকে। উদাহরণ: "3.5s" ।

string ( Duration format)

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

সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' s ' থাকে। উদাহরণ: "3.5s" ।

string

এই চালানের জন্য একটি 'ধরন' নির্দিষ্টকারী একটি অ-খালি স্ট্রিং। এই বৈশিষ্ট্যটি shipment_types মধ্যে অসামঞ্জস্যতা বা প্রয়োজনীয়তা সংজ্ঞায়িত করতে ব্যবহার করা যেতে পারে ( ShipmentModel এ shipmentTypeIncompatibilities এবং shipmentTypeRequirements দেখুন)।

এটি visitTypes থেকে ভিন্ন, যা একটিমাত্র পরিদর্শনের জন্য নির্দিষ্ট করা হয়: একই চালানের অন্তর্গত সমস্ত পিকআপ/ডেলিভারি একই shipmentType শেয়ার করে।

string

এই চালানের জন্য একটি লেবেল নির্দিষ্ট করে। এই লেবেলটি রেসপন্সে সংশ্লিষ্ট ShipmentRoute.Visit এর shipmentLabel এ রিপোর্ট করা হয়।

boolean

যদি সত্য হয়, তাহলে এই চালানটি বাদ দিন, কিন্তু কোনো penaltyCost প্রয়োগ করবেন না।

মডেলে কোনো shipmentTypeRequirements থাকলে, কোনো চালান উপেক্ষা করলে একটি ভ্যালিডেশন ত্রুটি দেখা দেয়।

injectedFirstSolutionRoutes বা injectedSolutionConstraint এ সম্পাদিত কোনো চালান উপেক্ষা করার অনুমতি আছে; সলভারটি সম্পাদনকারী রুট থেকে সংশ্লিষ্ট পিকআপ/ডেলিভারি ভিজিটগুলো সরিয়ে দেয়। উপেক্ষা করা চালানগুলোকে উল্লেখ করে এমন precedenceRules উপেক্ষা করা হবে।

number

যদি চালানটি সম্পন্ন না হয়, তবে এই জরিমানা রুটগুলোর মোট খরচের সাথে যোগ করা হয়। একটি চালানকে সম্পন্ন বলে গণ্য করা হয় যদি এর পিকআপ এবং ডেলিভারির বিকল্পগুলোর মধ্যে একটিতে যাওয়া হয়। খরচটি মডেলের অন্যান্য সমস্ত খরচ-সম্পর্কিত ক্ষেত্রের জন্য ব্যবহৃত একই এককে প্রকাশ করা যেতে পারে এবং এটি অবশ্যই ধনাত্মক হতে হবে।

গুরুত্বপূর্ণ : যদি এই জরিমানা নির্দিষ্ট করা না থাকে, তবে তা অনির্দিষ্টকালের জন্য প্রযোজ্য বলে গণ্য হবে, অর্থাৎ চালানটি অবশ্যই সম্পন্ন করতে হবে।

number

পিকআপ থেকে ডেলিভারি পর্যন্ত সংক্ষিপ্ততম পথের তুলনায় সর্বাধিক আপেক্ষিক ঘুরপথের সময় নির্দিষ্ট করে। যদি এটি নির্দিষ্ট করা হয়, তবে তা অবশ্যই অঋণাত্মক হতে হবে এবং চালানটিতে অন্তত একটি পিকআপ ও একটি ডেলিভারি থাকতে হবে।

উদাহরণস্বরূপ, ধরা যাক t হলো নির্বাচিত পিকআপ বিকল্প থেকে সরাসরি নির্বাচিত ডেলিভারি বিকল্পে যাওয়ার জন্য প্রয়োজনীয় সর্বনিম্ন সময়। তাহলে pickupToDeliveryRelativeDetourLimit সেট করলে যা কার্যকর হয় তা হলো:

startTime(delivery) - startTime(pickup) <=
std::ceil(t * (1.0 + pickupToDeliveryRelativeDetourLimit))

যদি একই চালানের জন্য আপেক্ষিক এবং পরম উভয় সীমা নির্দিষ্ট করা থাকে, তবে প্রতিটি সম্ভাব্য পিকআপ/ডেলিভারি জোড়ার জন্য অধিক সীমাবদ্ধকারী সীমাটি ব্যবহৃত হয়। ২০১৭/১০ তারিখ অনুযায়ী, বিকল্প পথ শুধুমাত্র তখনই সমর্থিত হয় যখন ভ্রমণের সময়কাল যানবাহনের উপর নির্ভরশীল না হয়।

object ( LatLng )

এই VisitRequest সম্পাদন করার সময় যানবাহনটি যে ভৌগোলিক অবস্থানে পৌঁছায়। যদি শিপমেন্ট মডেলে ডিউরেশন ডিসটেন্স ম্যাট্রিক্স থাকে, arrivalLocation নির্দিষ্ট করা যাবে না।

object ( Waypoint )

এই VisitRequest সম্পাদন করার সময় যানবাহনটি যে ওয়েপয়েন্টে এসে পৌঁছায়। যদি শিপমেন্ট মডেলে ডিউরেশন ডিসটেন্স ম্যাট্রিক্স থাকে, তাহলে arrivalWaypoint নির্দিষ্ট করা যাবে না।

object ( LatLng )

এই VisitRequest সম্পন্ন করার পর যানবাহনটি যে ভৌগোলিক অবস্থান থেকে যাত্রা শুরু করে। যদি এটি arrivalLocation সমান হয়, তবে এটি বাদ দেওয়া যেতে পারে। যদি শিপমেন্ট মডেলে ডিউরেশন ডিসটেন্স ম্যাট্রিক্স থাকে, তবে departureLocation অবশ্যই উল্লেখ করা যাবে না।

object ( Waypoint )

এই VisitRequest সম্পন্ন করার পর যানবাহনটি যে ওয়েপয়েন্ট থেকে যাত্রা শুরু করে। যদি এটি arrivalWaypoint এর সমান হয়, তবে এটি বাদ দেওয়া যেতে পারে। যদি শিপমেন্ট মডেলে ডিউরেশন ডিসটেন্স ম্যাট্রিক্স থাকে, তবে departureWaypoint অবশ্যই উল্লেখ করা যাবে না।

string

ভিজিট অনুরোধের সাথে সংযুক্ত ট্যাগগুলো নির্দিষ্ট করে। খালি বা সদৃশ স্ট্রিং অনুমোদিত নয়।

object ( TimeWindow )

সময়সীমা যা কোনো পরিদর্শনের জন্য আগমনের সময়কে সীমাবদ্ধ করে। উল্লেখ্য যে, একটি যানবাহন আগমনের সময়সীমার বাইরেও রওনা হতে পারে, অর্থাৎ আগমনের সময় ও সময়কালকে একটি নির্দিষ্ট সময়সীমার মধ্যে থাকতে হবে এমন কোনো বাধ্যবাধকতা নেই। এর ফলে অপেক্ষার সময় তৈরি হতে পারে, যদি যানবাহনটি TimeWindow.start_time আগে এসে পৌঁছায়।

TimeWindow না থাকার অর্থ হলো, যানবাহনটি যেকোনো সময় এই পরিদর্শনটি সম্পন্ন করতে পারে।

সময়কালগুলো অবশ্যই পরস্পর বিচ্ছিন্ন হতে হবে, অর্থাৎ কোনো সময়কাল অন্যটির সাথে ওভারল্যাপ করবে না বা সংলগ্ন হবে না, এবং সেগুলো অবশ্যই ক্রমবর্ধমান ক্রমে থাকতে হবে।

costPerHourAfterSoftEndTime এবং softEndTime শুধুমাত্র তখনই সেট করা যাবে, যদি একটিমাত্র সময়সীমা থাকে।

string ( Duration format)

পরিদর্শনের সময়কাল, অর্থাৎ যানবাহনটির আগমন এবং প্রস্থানের মধ্যবর্তী সময় (যা সম্ভাব্য অপেক্ষার সময়ের সাথে যোগ করতে হবে; timeWindows দেখুন)।

সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' s ' থাকে। উদাহরণ: "3.5s" ।

number

একটি যানবাহন রুটে এই ভিজিট অনুরোধটি পরিষেবা দেওয়ার খরচ। এটি একটি চালানের প্রতিটি বিকল্প পিকআপ বা ডেলিভারির জন্য বিভিন্ন খরচ পরিশোধ করতে ব্যবহার করা যেতে পারে। এই খরচ অবশ্যই Shipment.penalty_cost এর মতো একই এককে হতে হবে এবং এটি ঋণাত্মক হতে পারবে না।

map (key: string, value: object ( Load ))

এই ভিজিট রিকোয়েস্টের ডিমান্ডগুলো লোড করুন। এটি Shipment.load_demands ফিল্ডের মতোই, তবে পার্থক্য হলো এটি পুরো Shipment পরিবর্তে শুধুমাত্র এই VisitRequest জন্য প্রযোজ্য। এখানে তালিকাভুক্ত ডিমান্ডগুলো Shipment.load_demands এ তালিকাভুক্ত ডিমান্ডগুলোর সাথে যুক্ত হয়।

string

পরিদর্শনের ধরণ নির্দিষ্ট করে। কোনো যানবাহনের এই পরিদর্শনটি সম্পন্ন করার জন্য প্রয়োজনীয় অতিরিক্ত সময় বরাদ্দ করতে এটি ব্যবহার করা যেতে পারে (দেখুন Vehicle.extra_visit_duration_for_visit_type )।

একটি প্রকার কেবল একবারই প্রদর্শিত হতে পারে।

string

এই VisitRequest জন্য একটি লেবেল নির্দিষ্ট করে। এই লেবেলটি রেসপন্সে সংশ্লিষ্ট ShipmentRoute.Visit এর visitLabel হিসেবে রিপোর্ট করা হয়।

boolean

এই স্থানে গাড়ি চালানোর পথে ইউ-টার্ন এড়ানো হবে কিনা তা নির্দিষ্ট করে। ইউ-টার্ন এড়ানোর জন্য সর্বোচ্চ চেষ্টা করা হয় এবং সম্পূর্ণ এড়ানোর কোনো নিশ্চয়তা নেই। এটি একটি পরীক্ষামূলক বৈশিষ্ট্য এবং এর আচরণ পরিবর্তন সাপেক্ষ।

পরীক্ষামূলক: আরও বিস্তারিত জানতে https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request দেখুন।

number

অক্ষাংশ ডিগ্রিতে। এটি অবশ্যই [-90.0, +90.0] সীমার মধ্যে হতে হবে।

number

দ্রাঘিমাংশ ডিগ্রিতে। এটি অবশ্যই [-180.0, +180.0] সীমার মধ্যে হতে হবে।

boolean

ঐচ্ছিক। এটি নির্দেশ করে যে, এই ওয়েপয়েন্টের অবস্থানটি এমনভাবে তৈরি করা হয়েছে যাতে যানবাহনটি রাস্তার একটি নির্দিষ্ট পাশে থামতে পছন্দ করে। আপনি যখন এই মানটি সেট করবেন, তখন রুটটি সেই অবস্থানের মধ্য দিয়ে এমনভাবে যাবে যাতে যানবাহনটি রাস্তার সেই পাশে থামতে পারে, যেদিকে অবস্থানটি রাস্তার কেন্দ্র থেকে ঝুঁকে আছে। এই বিকল্পটি 'হাঁটা' (WALKING) ভ্রমণ মোডের জন্য কাজ করে না।

boolean

এটি নির্দেশ করে যে ওয়েপয়েন্টটি যানবাহন থামার জন্য নির্ধারিত, যেখানে যাত্রী ওঠানো বা নামানোর উদ্দেশ্য রয়েছে। এই বিকল্পটি শুধুমাত্র 'ড্রাইভিং' ট্র্যাভেল মোডের জন্য এবং যখন 'লোকেশনটাইপ' 'লোকেশন' হয়, তখনই কাজ করে।

পরীক্ষামূলক: ভবিষ্যতে এই ক্ষেত্রের আচরণ বা অস্তিত্ব পরিবর্তিত হতে পারে।

object ( Location )

ভৌগোলিক স্থানাঙ্ক ব্যবহার করে নির্দিষ্ট একটি বিন্দু, যেখানে একটি ঐচ্ছিক শিরোনাম অন্তর্ভুক্ত থাকতে পারে।

string

ওয়েপয়েন্টটির সাথে সংশ্লিষ্ট POI স্থান আইডি।

কোনো VisitRequest-এর আগমন বা প্রস্থানের স্থান নির্দিষ্ট করতে প্লেস আইডি ব্যবহার করার সময়, এমন একটি প্লেস আইডি ব্যবহার করুন যা সেই স্থানে নেভিগেশনের জন্য অক্ষাংশ-দ্রাঘিমাংশ (LatLng) অবস্থান নির্ধারণ করতে যথেষ্ট সুনির্দিষ্ট। উদাহরণস্বরূপ, একটি ভবনের প্রতিনিধিত্বকারী প্লেস আইডি উপযুক্ত, কিন্তু একটি রাস্তার প্রতিনিধিত্বকারী প্লেস আইডি ব্যবহার নিরুৎসাহিত করা হয়।

object ( LatLng )

ওয়েপয়েন্টটির ভৌগোলিক স্থানাঙ্ক।

integer

যানবাহন চলাচলের দিকের সাথে সম্পর্কিত কম্পাস হেডিং। যাত্রী ওঠানো এবং নামানোর জন্য রাস্তার কোন পাশ ব্যবহার করতে হবে, তা নির্দিষ্ট করতে এই মানটি ব্যবহৃত হয়। হেডিং-এর মান ০ থেকে ৩৬০ পর্যন্ত হতে পারে, যেখানে ০ সরাসরি উত্তর দিক, ৯০ সরাসরি পূর্ব দিক ইত্যাদি নির্দেশ করে।

string ( Timestamp format)

হার্ড টাইম উইন্ডো শুরুর সময়। যদি এটি নির্দিষ্ট না করা হয়, তবে এটি ShipmentModel.global_start_time এ সেট করা হবে।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

string ( Timestamp format)

নির্দিষ্ট সময়সীমার শেষ সময়। যদি এটি অনির্দিষ্ট থাকে, তবে এটি ShipmentModel.global_end_time এ সেট করা হবে।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

string ( Timestamp format)

সময়সীমাটির সফট স্টার্ট টাইম।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

string ( Timestamp format)

সময়সীমাটির নরম সমাপ্তির সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

number

যদি ঘটনাটি softStartTime-এর আগে ঘটে, তাহলে মডেলে থাকা অন্যান্য খরচের সাথে প্রতি ঘণ্টার একটি খরচ যোগ করা হবে, যা নিম্নরূপে গণনা করা হয়:

   max(0, softStartTime - t.seconds)
                          * costPerHourBeforeSoftStartTime / 3600,
t being the time of the event.

এই খরচ অবশ্যই ধনাত্মক হতে হবে, এবং softStartTime সেট করা হলেই কেবল এই ফিল্ডটি সেট করা যাবে।

number

যদি ইভেন্টটি softEndTime পরে ঘটে, তাহলে মডেলে থাকা অন্যান্য খরচের সাথে প্রতি ঘণ্টার একটি খরচ যোগ করা হয়, যা নিম্নরূপে গণনা করা হয়:

   max(0, t.seconds - softEndTime.seconds)
                    * costPerHourAfterSoftEndTime / 3600,
t being the time of the event.

This cost must be positive, and the field can only be set if softEndTime has been set.

string

গাড়ির ব্যবহারকারী-নির্ধারিত প্রদর্শিত নাম। এটি সর্বোচ্চ ৬৩ অক্ষর দীর্ঘ হতে পারে এবং এতে UTF-8 অক্ষর ব্যবহার করা যেতে পারে।

enum ( TravelMode )

ভ্রমণের ধরণ যা যানবাহনের ব্যবহারযোগ্য রাস্তা এবং তার গতিকে প্রভাবিত করে। আরও দেখুন travelDurationMultiple ।

object ( RouteModifiers )

কিছু শর্তের সমষ্টি যা প্রদত্ত যানবাহনটির জন্য পথ গণনার পদ্ধতিকে প্রভাবিত করে।

object ( LatLng )

ভৌগোলিক অবস্থান যেখান থেকে যানবাহনটি কোনো চালান তোলার আগে যাত্রা শুরু করে। যদি নির্দিষ্ট করা না থাকে, তবে যানবাহনটি তার প্রথম পিকআপ থেকে যাত্রা শুরু করে। যদি চালান মডেলে সময়কাল এবং দূরত্বের ম্যাট্রিক্স থাকে, তবে startLocation নির্দিষ্ট করা যাবে না।

object ( Waypoint )

ওয়েপয়েন্ট হলো একটি ভৌগোলিক অবস্থান, যেখান থেকে যানবাহনটি কোনো চালান তোলার আগে যাত্রা শুরু করে। যদি startWaypoint বা startLocation কোনোটিই নির্দিষ্ট করা না থাকে, তবে যানবাহনটি তার প্রথম পিকআপের স্থান থেকে যাত্রা শুরু করে। যদি চালান মডেলে সময়কাল এবং দূরত্বের ম্যাট্রিক্স থাকে, তবে startWaypoint অবশ্যই নির্দিষ্ট করা যাবে না।

object ( LatLng )

ভৌগোলিক অবস্থান যেখানে যানবাহনটি তার শেষ VisitRequest সম্পন্ন করার পর শেষ হয়। যদি নির্দিষ্ট না করা হয়, তাহলে যানবাহনটির ShipmentRoute তার শেষ VisitRequest সম্পন্ন করার সাথে সাথেই শেষ হয়ে যায়। যদি শিপমেন্ট মডেলে ডিউরেশন এবং ডিসটেন্স ম্যাট্রিক্স থাকে, তাহলে endLocation অবশ্যই নির্দিষ্ট করা যাবে না।

object ( Waypoint )

ওয়েপয়েন্ট হলো একটি ভৌগোলিক অবস্থান যেখানে যানটি তার শেষ VisitRequest সম্পন্ন করার পর যাত্রা শেষ করে। যদি endWaypoint বা endLocation কোনোটিই নির্দিষ্ট করা না থাকে, তাহলে যানটির ShipmentRoute তার শেষ VisitRequest সম্পন্ন করার সাথে সাথেই শেষ হয়ে যায়। যদি শিপমেন্ট মডেলে ডিউরেশন এবং ডিসটেন্স ম্যাট্রিক্স থাকে, তবে endWaypoint নির্দিষ্ট করা যাবে না।

string

যানবাহনটির যাত্রাপথের শুরুতে সংযুক্ত ট্যাগগুলো নির্দিষ্ট করে।

খালি বা সদৃশ স্ট্রিং অনুমোদিত নয়।

string

যানবাহনের যাত্রাপথের শেষে সংযুক্ত ট্যাগগুলো নির্দিষ্ট করে।

খালি বা সদৃশ স্ট্রিং অনুমোদিত নয়।

object ( TimeWindow )

যে সময়সীমার মধ্যে যানটি তার প্রারম্ভিক স্থান থেকে যাত্রা শুরু করতে পারে। এই সময়সীমা অবশ্যই বৈশ্বিক সময়সীমার মধ্যে হতে হবে (দেখুন ShipmentModel.global_* ফিল্ড)। যদি নির্দিষ্ট করা না থাকে, তবে সেই বৈশ্বিক সময়সীমা ছাড়া অন্য কোনো সীমাবদ্ধতা নেই।

একই পুনরাবৃত্ত ক্ষেত্রের অন্তর্গত সময়কালগুলো অবশ্যই পরস্পর বিচ্ছিন্ন হতে হবে, অর্থাৎ কোনো সময়কাল অন্যটির সাথে উপরিপাতিত বা সংলগ্ন হতে পারবে না, এবং সেগুলোকে অবশ্যই কালানুক্রমিক ক্রমে থাকতে হবে।

costPerHourAfterSoftEndTime এবং softEndTime শুধুমাত্র তখনই সেট করা যাবে, যদি একটিমাত্র সময়সীমা থাকে।

object ( TimeWindow )

যে নির্দিষ্ট সময়সীমার মধ্যে যানবাহনটি তার গন্তব্যে পৌঁছাতে পারে। এই সময়সীমা অবশ্যই বৈশ্বিক সময়সীমার মধ্যে হতে হবে (দেখুন ShipmentModel.global_* ফিল্ড)। যদি নির্দিষ্ট করা না থাকে, তবে সেই বৈশ্বিক সময়সীমা ছাড়া অন্য কোনো সীমাবদ্ধতা নেই।

একই পুনরাবৃত্ত ক্ষেত্রের অন্তর্গত সময়কালগুলো অবশ্যই পরস্পর বিচ্ছিন্ন হতে হবে, অর্থাৎ কোনো সময়কাল অন্যটির সাথে উপরিপাতিত বা সংলগ্ন হতে পারবে না, এবং সেগুলোকে অবশ্যই কালানুক্রমিক ক্রমে থাকতে হবে।

costPerHourAfterSoftEndTime এবং softEndTime শুধুমাত্র তখনই সেট করা যাবে, যদি একটিমাত্র সময়সীমা থাকে।

enum ( UnloadingPolicy )

গাড়িতে মালামাল খালাস সংক্রান্ত নীতিমালা বলবৎ করা হয়েছে।

map (key: string, value: object ( LoadLimit ))

যানবাহনের ধারণক্ষমতা (যেমন ওজন, আয়তন, প্যালেটের সংখ্যা)। ম্যাপের কী-গুলো হলো লোডের প্রকারের শনাক্তকারী, যা Shipment.load_demands ফিল্ডের কী-গুলোর সাথে সামঞ্জস্যপূর্ণ। যদি কোনো নির্দিষ্ট কী এই ম্যাপে অনুপস্থিত থাকে, তবে সংশ্লিষ্ট ধারণক্ষমতাকে অসীম বলে গণ্য করা হয়।

number

যানবাহনের খরচ: সমস্ত খরচ যোগ হয় এবং এর একক অবশ্যই Shipment.penalty_cost এর এককের সমান হতে হবে।

যানবাহন রুটের প্রতি ঘণ্টার খরচ। এই খরচটি রুটের মোট সময়ের উপর প্রযোজ্য হয় এবং এতে ভ্রমণের সময়, অপেক্ষার সময় এবং পরিদর্শনের সময় অন্তর্ভুক্ত থাকে। শুধুমাত্র costPerTraveledHour এর পরিবর্তে costPerHour ব্যবহার করলে অতিরিক্ত বিলম্ব হতে পারে।

number

যানবাহন রুটের প্রতি ভ্রমণ ঘণ্টার খরচ। এই খরচটি শুধুমাত্র রুটের ভ্রমণ সময়ের উপর প্রযোজ্য (অর্থাৎ, যা ShipmentRoute.transitions এ রিপোর্ট করা হয়), এবং এতে অপেক্ষার সময় ও পরিদর্শনের সময় অন্তর্ভুক্ত নয়।

number

যানবাহন পথের প্রতি কিলোমিটার খরচ। এই খরচটি ShipmentRoute.transitions এ উল্লিখিত দূরত্বের উপর প্রযোজ্য এবং একটি একক VisitRequest এর arrivalLocation থেকে departureLocation পর্যন্ত পরোক্ষভাবে ভ্রমণ করা কোনো দূরত্বের উপর প্রযোজ্য নয়।

number

এই যানবাহনটি কোনো চালান পরিবহনের জন্য ব্যবহৃত হলে নির্দিষ্ট খরচ প্রযোজ্য হবে।

boolean

এই ক্ষেত্রটি শুধুমাত্র সেইসব যানবাহনের ক্ষেত্রে প্রযোজ্য, যেগুলোর রুটে কোনো চালান থাকে না। এই ক্ষেত্রে যানবাহনটিকে ব্যবহৃত হিসেবে গণ্য করা হবে কি না, তা এটি নির্দেশ করে।

যদি সত্য হয়, তবে যানবাহনটি কোনো চালান সরবরাহ না করলেও তার শুরু থেকে শেষ অবস্থানে যায় এবং এর শুরু থেকে শেষ পর্যন্ত যাত্রার ফলে উদ্ভূত সময় ও দূরত্বের খরচ হিসাব করা হয়।

অন্যথায়, এটি তার শুরু থেকে শেষ অবস্থানে যায় না এবং এই যানটির জন্য কোনো breakRule বা delay ( TransitionAttributes থেকে) নির্ধারিত থাকে না। এই ক্ষেত্রে, যানটির ShipmentRoute এ গাড়ির ইনডেক্স এবং লেবেল ছাড়া অন্য কোনো তথ্য থাকে না।

object ( DurationLimit )

যানবাহনটির যাত্রাপথের মোট সময়কালের উপর সীমা আরোপ করা হয়েছে। একটি নির্দিষ্ট OptimizeToursResponse এ, একটি যানবাহনের যাত্রাপথের সময়কাল হলো তার vehicleEndTime এবং vehicleStartTime পার্থক্য।

object ( DurationLimit )

যানবাহনের রুটের ভ্রমণকালের উপর সীমা আরোপ করা হয়েছে। একটি নির্দিষ্ট OptimizeToursResponse এ, রুটের ভ্রমণকাল হলো এর সমস্ত transitions.travel_duration এর সমষ্টি।

object ( DistanceLimit )

যানবাহনের যাত্রাপথের মোট দূরত্বের উপর সীমা আরোপ করা হয়েছে। একটি নির্দিষ্ট OptimizeToursResponse এ, যাত্রাপথের দূরত্ব হলো এর সমস্ত transitions.travel_distance_meters এর যোগফল।

map (key: string, value: string ( Duration format))

visitTypes স্ট্রিং থেকে সময়কাল পর্যন্ত একটি ম্যাপ নির্দিষ্ট করে। এই সময়কাল হলো VisitRequest.duration এর অতিরিক্ত সময়, যা নির্দিষ্ট visitTypes যুক্ত ভিজিটগুলোতে গণনা করা হয়। যদি costPerHour নির্দিষ্ট করা থাকে, তবে এই অতিরিক্ত ভিজিট সময়কালের জন্য খরচ যুক্ত হয়। কী (অর্থাৎ visitTypes ) খালি স্ট্রিং হতে পারে না।

যদি কোনো পরিদর্শন অনুরোধের একাধিক প্রকার থাকে, তাহলে মানচিত্রে প্রতিটি প্রকারের জন্য একটি সময়কাল যোগ করা হবে।

object ( BreakRule )

এই যানবাহনের জন্য প্রযোজ্য বিরতির সময়সূচী বর্ণনা করা হলো। যানবাহনটি খালি থাকলে, এর জন্য কোনো বিরতি নির্ধারিত থাকবে না।

string

এই যানবাহনটির জন্য একটি লেবেল নির্দিষ্ট করে। এই লেবেলটি রেসপন্সে সংশ্লিষ্ট ShipmentRoute এর vehicleLabel হিসেবে রিপোর্ট করা হয়।

boolean

যদি সত্য হয়, তাহলে usedIfRouteIsEmpty অবশ্যই মিথ্যা হতে হবে এবং এই যানটি অব্যবহৃত থাকবে।

যদি injectedFirstSolutionRoutes এ উপেক্ষিত কোনো যানবাহন দ্বারা কোনো চালান সম্পন্ন করা হয়, তবে তা প্রথম সমাধানে বাদ দেওয়া হয় কিন্তু প্রতিক্রিয়ায় তা সম্পন্ন করার জন্য উন্মুক্ত থাকে।

যদি injectedSolutionConstraint এ থাকা কোনো উপেক্ষিত যানবাহন দ্বারা কোনো চালান সম্পন্ন করা হয় এবং এর সাথে সম্পর্কিত কোনো পিকআপ/ডেলিভারি সেই যানবাহনেই সীমাবদ্ধ থাকে (অর্থাৎ, RELAX_ALL_AFTER_THRESHOLD স্তরে শিথিল করা না হয়), তবে প্রতিক্রিয়া থেকে এটি বাদ দেওয়া হয়। যদি কোনো চালানের allowedVehicleIndices ফিল্ডটি খালি না থাকে এবং সমস্ত অনুমোদিত যানবাহন উপেক্ষিত হয়, তবে প্রতিক্রিয়া থেকে এটি বাদ দেওয়া হয়।

number

Specifies a multiplicative factor that can be used to increase or decrease travel times of this vehicle. For example, setting this to 2.0 means that this vehicle is slower and has travel times that are twice what they are for standard vehicles. This multiple does not affect visit durations. It does affect cost if costPerHour or costPerTraveledHour are specified. This must be in the range [0.001, 1000.0]. If unset, the vehicle is standard, and this multiple is considered 1.0.

সতর্কীকরণ: এই গুণকটি প্রয়োগ করার পর কিন্তু যেকোনো সংখ্যাসূচক অপারেশন করার আগে, ভ্রমণের সময়কে নিকটতম সেকেন্ডে রাউন্ড করা হবে, সুতরাং, একটি ছোট গুণকের ফলে নির্ভুলতা হ্রাস পেতে পারে।

নিচে extraVisitDurationForVisitType ও দেখুন।

boolean

যুক্তিসঙ্গত ক্ষেত্রে টোল রোড এড়িয়ে চলা হবে কিনা তা নির্দিষ্ট করে। টোল রোড নেই এমন রুটকে অগ্রাধিকার দেওয়া হবে। শুধুমাত্র মোটরচালিত যানবাহনের ক্ষেত্রে প্রযোজ্য।

boolean

যুক্তিসঙ্গত ক্ষেত্রে মহাসড়ক পরিহার করা হবে কিনা তা নির্দিষ্ট করে। যেসব পথে মহাসড়ক নেই, সেগুলোকে অগ্রাধিকার দেওয়া হবে। এটি শুধুমাত্র মোটরচালিত যানবাহনের ক্ষেত্রে প্রযোজ্য।

boolean

যুক্তিসঙ্গত ক্ষেত্রে ফেরি পরিহার করা হবে কিনা তা নির্দিষ্ট করে। যেসব রুটে ফেরি চলাচল করে না, সেগুলোকে অগ্রাধিকার দেওয়া হবে। এটি শুধুমাত্র মোটরচালিত ভ্রমণ মাধ্যমের ক্ষেত্রে প্রযোজ্য।

boolean

ঐচ্ছিক। যুক্তিসঙ্গত ক্ষেত্রে অন্দরমহলের নেভিগেশন এড়িয়ে চলা হবে কিনা তা নির্দিষ্ট করে। যেসব রুটে অন্দরমহলের নেভিগেশন নেই, সেগুলোকে অগ্রাধিকার দেওয়া হবে। শুধুমাত্র WALKING ভ্রমণ মোডের জন্য প্রযোজ্য।

string ( int64 format)

লোডের একটি নমনীয় সীমা। costPerUnitAboveSoftMax দেখুন।

number

এই গাড়ির রুটে লোড যদি কখনও softMaxLoad অতিক্রম করে, তাহলে নিম্নলিখিত খরচ জরিমানা প্রযোজ্য হবে (প্রতি গাড়িতে শুধুমাত্র একবার): (লোড - softMaxLoad ) * costPerUnitAboveSoftMax । সমস্ত খরচ যোগ হয় এবং Shipment.penalty_cost মতো একই এককে থাকতে হবে। সফট লিমিট শুধুমাত্র সেইসব ধরনের ক্ষেত্রে সংজ্ঞায়িত করা যেতে পারে যা মডেল জুড়ে শুধুমাত্র পিকআপ অথবা শুধুমাত্র ডেলিভারির জন্য প্রযোজ্য।

object ( Interval )

রুটের শুরুতে যানবাহনের গ্রহণযোগ্য ভার বহনের ব্যবধান।

object ( Interval )

রুটের শেষে যানবাহনের গ্রহণযোগ্য লোড ব্যবধান।

string ( int64 format)

সর্বোচ্চ গ্রহণযোগ্য ভারের পরিমাণ।

object ( LoadCost )

এই যানটির জন্য এক কিলোমিটার দূরত্বে এক একক ভার বহনের খরচ। এটিকে জ্বালানি খরচের একটি পরোক্ষ পরিমাপক হিসেবে ব্যবহার করা যেতে পারে: যদি ভারটি একটি ওজন (নিউটন এককে) হয়, তবে ভার*কিলোমিটারের মাত্রা হবে শক্তির মাত্রা।

পরীক্ষামূলক: আরও বিস্তারিত জানতে https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request দেখুন।

object ( LoadCost )

এই যানবাহনটির জন্য এক ঘণ্টায় প্রতি ইউনিট ভার বহনের খরচ।

পরীক্ষামূলক: আরও বিস্তারিত জানতে https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request দেখুন।

string ( int64 format)

সর্বনিম্ন গ্রহণযোগ্য লোড। এটি অবশ্যই ≥ ০ হতে হবে। যদি উভয়ই নির্দিষ্ট করা থাকে, তবে min অবশ্যই max হতে হবে।

string ( int64 format)

A maximum acceptable load. Must be ≥ 0. If unspecified, the maximum load is unrestricted by this message. If they're both specified, min must be ≤ max .

string ( int64 format)

ভারের সেই পরিমাণ, যার উপরে প্রতি ইউনিট ভার সরানোর খরচ 'threshold-এর নিচের প্রতি ইউনিটের খরচ' থেকে 'threshold-এর উপরের প্রতি ইউনিটের খরচ'-এ পরিবর্তিত হয়। এর মান অবশ্যই >= ০ হতে হবে।

number

০ এবং নির্ধারিত সীমার মধ্যবর্তী প্রতিটি এককের জন্য, এক ইউনিট ভার সরানোর খরচ। মানটি অবশ্যই সসীম হতে হবে এবং ০ বা তার বেশি হতে হবে।

number

Cost of moving a unit of load, for each unit above threshold. In the special case threshold = 0, this is a fixed cost per unit. Must be a finite value, and >= 0.

string ( Duration format)

A hard limit constraining the duration to be at most maxDuration.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string ( Duration format)

A soft limit not enforcing a maximum duration limit, but when violated makes the route incur a cost. This cost adds up to other costs defined in the model, with the same unit.

If defined, softMaxDuration must be nonnegative. If maxDuration is also defined, softMaxDuration must be less than maxDuration.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string ( Duration format)

A soft limit not enforcing a maximum duration limit, but when violated makes the route incur a cost, quadratic in the duration. This cost adds up to other costs defined in the model, with the same unit.

If quadraticSoftMaxDuration is set, the following conditions must be met:

• It must be non-negative.
• maxDuration must be defined.
• quadraticSoftMaxDuration must be less than maxDuration .
• The difference must be no more than one day: maxDuration - quadraticSoftMaxDuration <= 86400 seconds

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

number

Cost per hour incurred if the softMaxDuration threshold is violated. The additional cost is 0 if the duration is under the threshold, otherwise the cost depends on the duration as follows:

  costPerHourAfterSoftMax * (duration - softMaxDuration)

The cost must be nonnegative.

number

Cost per square hour incurred if the quadraticSoftMaxDuration threshold is violated.

The additional cost is 0 if the duration is under the threshold, otherwise the cost depends on the duration as follows:

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

The cost must be nonnegative.

string ( int64 format)

A hard limit constraining the distance to be at most maxMeters. The limit must be nonnegative.

string ( int64 format)

A soft limit not enforcing a maximum distance limit, but when violated results in a cost which adds up to other costs defined in the model, with the same unit.

If defined softMaxMeters must be less than maxMeters and must be nonnegative.

number

Cost per kilometer incurred, increasing up to softMaxMeters , with formula:

  min(distanceMeters, softMaxMeters) / 1000.0 *
  costPerKilometerBelowSoftMax.

This cost is not supported in routeDistanceLimit .

number

Cost per kilometer incurred if distance is above softMaxMeters limit. The additional cost is 0 if the distance is under the limit, otherwise the formula used to compute the cost is the following:

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

The cost must be nonnegative.

object ( BreakRequest )

Sequence of breaks. See the BreakRequest message.

object ( FrequencyConstraint )

Several FrequencyConstraint may apply. They must all be satisfied by the BreakRequest s of this BreakRule . See FrequencyConstraint .

string ( Timestamp format)

Required. Lower bound (inclusive) on the start of the break.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .

string ( Timestamp format)

Required. Upper bound (inclusive) on the start of the break.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .

string ( Duration format)

Required. Minimum duration of the break. Must be positive.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string ( Duration format)

Required. Minimum break duration for this constraint. Nonnegative. See description of FrequencyConstraint .

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string ( Duration format)

Required. Maximum allowed span of any interval of time in the route that does not include at least partially a break of duration >= minBreakDuration . Must be positive.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

enum ( Type )

The type of the objective.

number

How much this objective should count relatively to the others. This can be any non-negative number, weights do not have to sum to 1. Weights default to 1.0.

object ( Row )

Specifies the rows of the duration and distance matrix. It must have as many elements as ShipmentModel.duration_distance_matrix_src_tags .

string

Tag defining to which vehicles this duration and distance matrix applies. If empty, this applies to all vehicles, and there can only be a single matrix.

Each vehicle start must match exactly one matrix, ie exactly one of their startTags field must match the vehicleStartTag of a matrix (and of that matrix only).

All matrices must have a different vehicleStartTag .

string ( Duration format)

Duration values for a given row. It must have as many elements as ShipmentModel.duration_distance_matrix_dst_tags .

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

number

Distance values for a given row. If no costs or constraints refer to distances in the model, this can be left empty; otherwise it must have as many elements as durations .

string

Tags defining the set of (src->dst) transitions these attributes apply to.

A source visit or vehicle start matches iff its VisitRequest.tags or Vehicle.start_tags either contains srcTag or does not contain excludedSrcTag (depending on which of these two fields is non-empty).

string

See srcTag . Exactly one of srcTag and excludedSrcTag must be non-empty.

string

A destination visit or vehicle end matches iff its VisitRequest.tags or Vehicle.end_tags either contains dstTag or does not contain excludedDstTag (depending on which of these two fields is non-empty).

string

See dstTag . Exactly one of dstTag and excludedDstTag must be non-empty.

number

Specifies a cost for performing this transition. This is in the same unit as all other costs in the model and must not be negative. It is applied on top of all other existing costs.

number

Specifies a cost per kilometer applied to the distance traveled while performing this transition. It adds up to any Vehicle.cost_per_kilometer specified on vehicles.

object ( DistanceLimit )

Specifies a limit on the distance traveled while performing this transition.

As of 2021/06, only soft limits are supported.

string ( Duration format)

Specifies a delay incurred when performing this transition.

This delay always occurs after finishing the source visit and before starting the destination visit.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string

List of incompatible types. Two shipments having different shipment_types among those listed are "incompatible".

enum ( IncompatibilityMode )

Mode applied to the incompatibility.

string

List of alternative shipment types required by the dependentShipmentTypes .

string

All shipments with a type in the dependentShipmentTypes field require at least one shipment of type requiredShipmentTypeAlternatives to be visited on the same route.

NOTE: Chains of requirements such that a shipmentType depends on itself are not allowed.

enum ( RequirementMode )

Mode applied to the requirement.

boolean

Indicates if the "first" event is a delivery.

boolean

Indicates if the "second" event is a delivery.

string ( Duration format)

The offset between the "first" and "second" event. It can be negative.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

integer

Shipment index of the "first" event. This field must be specified.

integer

Shipment index of the "second" event. This field must be specified.