সূচক
-
RouteOptimization(ইন্টারফেস) -
AggregatedMetrics(বার্তা) -
BatchOptimizeToursMetadata(বার্তা) -
BatchOptimizeToursRequest(বার্তা) -
BatchOptimizeToursRequest.AsyncModelConfig(বার্তা) -
BatchOptimizeToursResponse(বার্তা) -
BreakRule(বার্তা) -
BreakRule.BreakRequest(বার্তা) -
BreakRule.FrequencyConstraint(বার্তা) -
DataFormat(এনাম) -
DistanceLimit(বার্তা) -
GcsDestination(বার্তা) -
GcsSource(বার্তা) -
InjectedSolutionConstraint(বার্তা) -
InjectedSolutionConstraint.ConstraintRelaxation(বার্তা) -
InjectedSolutionConstraint.ConstraintRelaxation.Relaxation(বার্তা) -
InjectedSolutionConstraint.ConstraintRelaxation.Relaxation.Level(enum) -
InputConfig(বার্তা) -
Location(বার্তা) -
OptimizeToursRequest(বার্তা) -
OptimizeToursRequest.SearchMode(enum) -
OptimizeToursRequest.SolvingMode(enum) -
OptimizeToursResponse(বার্তা) -
OptimizeToursResponse.Metrics(বার্তা) -
OptimizeToursValidationError(বার্তা) -
OptimizeToursValidationError.FieldReference(বার্তা) -
OutputConfig(বার্তা) -
RouteModifiers(বার্তা) -
Shipment(বার্তা) -
Shipment.Load(বার্তা) -
Shipment.VisitRequest(বার্তা) -
ShipmentModel(বার্তা) -
ShipmentModel.DurationDistanceMatrix(বার্তা) -
ShipmentModel.DurationDistanceMatrix.Row(বার্তা) -
ShipmentModel.PrecedenceRule(বার্তা) -
ShipmentRoute(বার্তা) -
ShipmentRoute.Break(বার্তা) -
ShipmentRoute.EncodedPolyline(বার্তা) -
ShipmentRoute.Transition(বার্তা) -
ShipmentRoute.VehicleLoad(বার্তা) -
ShipmentRoute.Visit(বার্তা) -
ShipmentTypeIncompatibility(বার্তা) -
ShipmentTypeIncompatibility.IncompatibilityMode(enum) -
ShipmentTypeRequirement(বার্তা) -
ShipmentTypeRequirement.RequirementMode(enum) -
SkippedShipment(বার্তা) -
SkippedShipment.Reasonকারণ (বার্তা) -
SkippedShipment.Reason.Code(enum) -
TimeWindow(বার্তা) -
TransitionAttributes(বার্তা) -
Vehicle(বার্তা) -
Vehicle.DurationLimit(বার্তা) -
Vehicle.LoadLimit(বার্তা) -
Vehicle.LoadLimit.Interval(বার্তা) -
Vehicle.TravelMode(এনাম) -
Vehicle.UnloadingPolicyনীতি (এনাম) -
Waypoint(বার্তা)
রুট অপ্টিমাইজেশান
যানবাহন ট্যুর অপ্টিমাইজ করার জন্য একটি পরিষেবা।
নির্দিষ্ট ধরণের ক্ষেত্রের বৈধতা:
-
google.protobuf.Timestamp- সময়গুলি ইউনিক্স সময়ে: 1970-01-01T00:00:00+00:00 থেকে সেকেন্ড।
- সেকেন্ড অবশ্যই [0, 253402300799], অর্থাৎ [1970-01-01T00:00:00+00:00, 9999-12-31T23:59:59+00:00]-এ হতে হবে।
- nanos আনসেট বা 0 এ সেট করা আবশ্যক।
-
google.protobuf.Duration- সেকেন্ড অবশ্যই [0, 253402300799], অর্থাৎ [1970-01-01T00:00:00+00:00, 9999-12-31T23:59:59+00:00]-এ হতে হবে।
- nanos আনসেট বা 0 এ সেট করা আবশ্যক।
-
google.type.LatLng- অক্ষাংশ অবশ্যই [-90.0, 90.0]-এ হতে হবে।
- দ্রাঘিমাংশ অবশ্যই [-180.0, 180.0]-এর মধ্যে হতে হবে।
- অক্ষাংশ এবং দ্রাঘিমাংশের অন্তত একটি অ-শূন্য হতে হবে।
| ব্যাচঅপ্টিমাইজ ট্যুরস |
|---|
একটি ব্যাচ হিসাবে এক বা একাধিক এই পদ্ধতিটি একটি লং রানিং অপারেশন (LRO)। অপ্টিমাইজেশনের জন্য ইনপুট ( ব্যবহারকারী ভোট যদি LRO এর যদি LRO এর
|
| অপটিমাইজ ট্যুরস |
|---|
একটি একটি লক্ষ্য হল
|
সমষ্টিগত মেট্রিক্স
ShipmentRoute এর জন্য সমষ্টিগত মেট্রিক্স ( OptimizeToursResponse জন্য সমস্ত Transition এবং/অথবা Visit (সমস্ত ShipmentRoute উপর রেসপন্স) উপাদান।
| ক্ষেত্র | |
|---|---|
performed_shipment_count | সঞ্চালিত চালানের সংখ্যা. মনে রাখবেন যে একটি পিকআপ এবং ডেলিভারি জুটি শুধুমাত্র একবার গণনা করা হয়। |
travel_duration | একটি রুট বা একটি সমাধানের জন্য মোট ভ্রমণের সময়কাল। |
wait_duration | একটি রুট বা একটি সমাধানের জন্য মোট অপেক্ষার সময়কাল। |
delay_duration | একটি রুট বা একটি সমাধানের জন্য মোট বিলম্বের সময়কাল। |
break_duration | একটি রুট বা একটি সমাধানের জন্য মোট বিরতির সময়কাল। |
visit_duration | একটি রুট বা একটি সমাধানের জন্য মোট পরিদর্শন সময়কাল। |
total_duration | মোট সময়কাল উপরের সমস্ত সময়কালের যোগফলের সমান হওয়া উচিত। রুটের জন্য, এটি এর সাথেও মিলে যায়: |
travel_distance_meters | একটি রুট বা একটি সমাধানের জন্য মোট ভ্রমণ দূরত্ব। |
max_loads | এই রুটের প্রতিটি পরিমাণের জন্য (resp. সমাধান) সমগ্র রুটে অর্জিত সর্বাধিক লোড (resp. solution), সমস্ত |
BatchOptimizeToursMetadata
এই ধরনের কোন ক্ষেত্র আছে.
BatchOptimizeToursRequest কলের জন্য অপারেশন মেটাডেটা।
BatchOptimizeToursRequest
একটি অ্যাসিঙ্ক্রোনাস অপারেশন হিসাবে ব্যাচ অপ্টিমাইজ ট্যুর করার অনুরোধ। প্রতিটি ইনপুট ফাইলে একটি OptimizeToursRequest থাকা উচিত এবং প্রতিটি আউটপুট ফাইলে একটি OptimizeToursResponse থাকবে। অনুরোধে ফাইলগুলি পড়া/লেখা এবং পার্স করার তথ্য রয়েছে। সমস্ত ইনপুট এবং আউটপুট ফাইল একই প্রকল্পের অধীনে হওয়া উচিত।
| ক্ষেত্র | |
|---|---|
parent | প্রয়োজন। একটি কল করতে লক্ষ্য প্রকল্প এবং অবস্থান. বিন্যাস: * কোনো অবস্থান নির্দিষ্ট না থাকলে, একটি অঞ্চল স্বয়ংক্রিয়ভাবে বেছে নেওয়া হবে। |
model_configs[] | প্রয়োজন। প্রতিটি ক্রয় মডেলের ইনপুট/আউটপুট তথ্য, যেমন ফাইল পাথ এবং ডেটা ফরম্যাট। |
AsyncModelConfig
অসিঙ্ক্রোনাসভাবে একটি অপ্টিমাইজেশন মডেল সমাধানের জন্য তথ্য।
| ক্ষেত্র | |
|---|---|
display_name | ঐচ্ছিক। ব্যবহারকারীর সংজ্ঞায়িত মডেল নাম, মডেলের ট্র্যাক রাখতে ব্যবহারকারীদের দ্বারা উপনাম হিসাবে ব্যবহার করা যেতে পারে। |
input_config | প্রয়োজন। ইনপুট মডেল সম্পর্কে তথ্য। |
output_config | প্রয়োজন। পছন্দসই আউটপুট অবস্থান তথ্য. |
BatchOptimizeToursResponse
এই ধরনের কোন ক্ষেত্র আছে.
একটি BatchOptimizeToursRequest এর প্রতিক্রিয়া। অপারেশন সম্পূর্ণ হওয়ার পর এটি লং রানিং অপারেশনে ফিরিয়ে দেওয়া হয়।
BreakRule
একটি যানবাহনের জন্য সময় বিরতি তৈরি করার নিয়ম (যেমন লাঞ্চ বিরতি)। একটি বিরতি হল একটি সংলগ্ন সময়কাল যেখানে যানবাহনটি তার বর্তমান অবস্থানে নিষ্ক্রিয় থাকে এবং কোনও পরিদর্শন করতে পারে না। একটি বিরতি ঘটতে পারে:
- দুটি ভিজিটের মধ্যে ভ্রমণের সময় (যার মধ্যে একটি ভিজিটের আগে বা ঠিক পরে সময় থাকে, তবে ভিজিটের মাঝখানে নয়), এই ক্ষেত্রে এটি ভিজিটের মধ্যে সংশ্লিষ্ট ট্রানজিট সময়কে প্রসারিত করে,
- বা যানবাহন শুরু হওয়ার আগে (একটি বিরতির মাঝখানে যানবাহন শুরু নাও হতে পারে), এই ক্ষেত্রে এটি গাড়ির শুরুর সময়কে প্রভাবিত করে না।
- বা যানবাহন শেষ হওয়ার পরে (এভাবে, গাড়ির শেষ সময় সহ)।
| ক্ষেত্র | |
|---|---|
break_requests[] | বিরতির ক্রম। |
frequency_constraints[] | বেশ কিছু |
ব্রেক রিকোয়েস্ট
বিরতির ক্রম (অর্থাৎ তাদের সংখ্যা এবং ক্রম) যা প্রতিটি গাড়ির জন্য প্রযোজ্য তা অবশ্যই আগে থেকেই জানা উচিত। পুনরাবৃত্ত BreakRequest গুলি সেই ক্রমটিকে সংজ্ঞায়িত করে, যে ক্রমে সেগুলি ঘটতে হবে৷ তাদের সময় উইন্ডো ( earliest_start_time / latest_start_time ) ওভারল্যাপ হতে পারে, কিন্তু সেগুলি অবশ্যই অর্ডারের সাথে সামঞ্জস্যপূর্ণ হতে হবে (এটি চেক করা হয়েছে)।
| ক্ষেত্র | |
|---|---|
earliest_start_time | প্রয়োজন। বিরতির শুরুতে লোয়ার বাউন্ড (অন্তর্ভুক্ত)। |
latest_start_time | প্রয়োজন। বিরতির শুরুতে আপার বাউন্ড (ইনক্লুসিভ)। |
min_duration | প্রয়োজন। বিরতির ন্যূনতম সময়কাল। ইতিবাচক হতে হবে। |
ফ্রিকোয়েন্সি সীমাবদ্ধতা
একটি ন্যূনতম বিরতির ফ্রিকোয়েন্সি প্রয়োগ করে উপরে উল্লেখিত বিরতির ফ্রিকোয়েন্সি এবং সময়কালকে আরও সীমাবদ্ধ করতে পারে, যেমন "প্রতি 12 ঘন্টায় কমপক্ষে 1 ঘন্টা বিরতি থাকতে হবে"। ধরে নিলাম যে এটিকে "12 ঘন্টার যেকোনো স্লাইডিং টাইম উইন্ডোর মধ্যে, কমপক্ষে এক ঘন্টার একটি বিরতি থাকতে হবে" হিসাবে ব্যাখ্যা করা যেতে পারে, এই উদাহরণটি নিম্নলিখিত FrequencyConstraint অনুবাদ করবে:
{
min_break_duration { seconds: 3600 } # 1 hour.
max_inter_break_duration { seconds: 39600 } # 11 hours (12 - 1 = 11).
}
সমাধানে বিরতির সময় এবং সময়কাল এই ধরনের সমস্ত সীমাবদ্ধতাকে সম্মান করবে, BreakRequest এ ইতিমধ্যে নির্দিষ্ট করা সময় উইন্ডো এবং ন্যূনতম সময়কাল ছাড়াও।
একটি FrequencyConstraint অনুশীলনে অ-পরপর বিরতিতে প্রযোজ্য হতে পারে। উদাহরণস্বরূপ, নিম্নলিখিত সময়সূচী "প্রতি 12 ঘন্টা" উদাহরণকে সম্মান করে:
04:00 vehicle start
.. performing travel and visits ..
09:00 1 hour break
10:00 end of the break
.. performing travel and visits ..
12:00 20-min lunch break
12:20 end of the break
.. performing travel and visits ..
21:00 1 hour break
22:00 end of the break
.. performing travel and visits ..
23:59 vehicle end
| ক্ষেত্র | |
|---|---|
min_break_duration | প্রয়োজন। এই সীমাবদ্ধতার জন্য ন্যূনতম বিরতির সময়কাল। নেতিবাচক। |
max_inter_break_duration | প্রয়োজন। রুটের যেকোনো সময়ের ব্যবধানের সর্বাধিক অনুমোদিত স্প্যান যা অন্তত আংশিকভাবে |
ডেটা ফরম্যাট
ইনপুট এবং আউটপুট ফাইলের জন্য ডেটা বিন্যাস।
| Enums | |
|---|---|
DATA_FORMAT_UNSPECIFIED | অবৈধ মান, বিন্যাস অবশ্যই অনির্দিষ্ট হওয়া উচিত নয়৷ |
JSON | জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন। |
PROTO_TEXT | প্রোটোকল বাফার টেক্সট ফরম্যাট। https://protobuf.dev/reference/protobuf/textformat-spec/ দেখুন |
দূরত্বসীমা
ভ্রমণ করা যেতে পারে এমন একটি সর্বোচ্চ দূরত্ব সংজ্ঞায়িত করে। এটা শক্ত বা নরম হতে পারে।
যদি একটি নরম সীমা সংজ্ঞায়িত করা হয়, তাহলে soft_max_meters এবং cost_per_kilometer_above_soft_max উভয়কেই সংজ্ঞায়িত করতে হবে এবং অঋণাত্মক হতে হবে।
| ক্ষেত্র | |
|---|---|
max_meters | একটি কঠিন সীমা যা দূরত্বকে সর্বাধিক max_meters হতে বাধা দেয়৷ সীমাটি অবশ্যই নেতিবাচক হতে হবে। |
soft_max_meters | একটি নরম সীমা সর্বোচ্চ দূরত্বের সীমা বলবৎ করে না, কিন্তু লঙ্ঘন করলে একটি খরচ হয় যা একই ইউনিটের সাথে মডেলে সংজ্ঞায়িত অন্যান্য খরচের সাথে যোগ করে। যদি সংজ্ঞায়িত করা হয় soft_max_meters অবশ্যই max_meters এর থেকে কম হতে হবে এবং অবশ্যই nonnegative হতে হবে। |
cost_per_kilometer_below_soft_max | প্রতি কিলোমিটার খরচ, সূত্র সহ এই খরচ |
cost_per_kilometer_above_soft_max | দূরত্ব খরচ nonnegative হতে হবে. |
Gcs গন্তব্য
Google ক্লাউড স্টোরেজের অবস্থান যেখানে আউটপুট ফাইল(গুলি) লেখা হবে৷
| ক্ষেত্র | |
|---|---|
uri | প্রয়োজন। Google ক্লাউড স্টোরেজ ইউআরআই। |
GcsSource
Google ক্লাউড স্টোরেজ অবস্থান যেখান থেকে ইনপুট ফাইল পড়া হবে।
| ক্ষেত্র | |
|---|---|
uri | প্রয়োজন। |
Injected Solution Constraint
কোন ভিজিটগুলিকে সীমাবদ্ধ করা উচিত এবং কীভাবে সেগুলিকে সীমাবদ্ধ করা উচিত সে সম্পর্কে তথ্য সহ অনুরোধে সমাধান ইনজেকশন করা হয়েছে৷
| ক্ষেত্র | |
|---|---|
routes[] | ইনজেকশন সমাধানের রুট। মূল সমাধান থেকে কিছু রুট বাদ দেওয়া যেতে পারে। রুট এবং এড়িয়ে যাওয়া শিপমেন্টগুলিকে অবশ্যই |
skipped_shipments[] | ইনজেকশনের সমাধানের চালান এড়িয়ে গেছে। মূল সমাধান থেকে কিছু বাদ দেওয়া যেতে পারে। |
constraint_relaxations[] | যানবাহনের শূন্য বা তার বেশি গ্রুপের জন্য, কখন এবং কতটা সীমাবদ্ধতা শিথিল করতে হবে তা নির্দিষ্ট করে। যদি এই ক্ষেত্রটি খালি থাকে, সমস্ত অ-খালি যানবাহন রুট সম্পূর্ণরূপে সীমাবদ্ধ। |
সীমাবদ্ধতা শিথিলকরণ
যানবাহনের একটি গ্রুপের জন্য, পরিদর্শনে কোন প্রান্তিক (গুলি) সীমাবদ্ধতা শিথিল করা হবে এবং কোন স্তরে তা নির্দিষ্ট করে৷ skipped_shipment ক্ষেত্রে তালিকাভুক্ত শিপমেন্টগুলি এড়ানোর জন্য সীমাবদ্ধ; অর্থাৎ, তারা সঞ্চালিত করা যাবে না.
| ক্ষেত্র | |
|---|---|
relaxations[] | সমস্ত ভিজিট সীমাবদ্ধতা শিথিলতা যা |
vehicle_indices[] | যানবাহনের সূচকগুলি নির্দিষ্ট করে যেখানে পরিদর্শন সীমাবদ্ধতা একটি গাড়ির সূচী |
শিথিলতা
relaxations খালি থাকলে, routes সমস্ত দর্শনের শুরুর সময় এবং ক্রম সম্পূর্ণরূপে সীমাবদ্ধ থাকে এবং সেই রুটে কোনও নতুন ভিজিট সন্নিবেশ করা বা যোগ করা যাবে না। এছাড়াও, routes একটি গাড়ির শুরু এবং শেষের সময় সম্পূর্ণরূপে সীমাবদ্ধ, যতক্ষণ না গাড়িটি খালি থাকে (অর্থাৎ, কোনও ভিজিট নেই এবং মডেলটিতে মিথ্যা সেট used_if_route_is_empty করা হয়েছে)।
relaxations(i).level একটি পরিদর্শন #j-এ প্রয়োগ করা সীমাবদ্ধতা শিথিলকরণ স্তর নির্দিষ্ট করে যা সন্তুষ্ট করে:
-
route.visits(j).start_time >= relaxations(i).threshold_timeAND -
j + 1 >= relaxations(i).threshold_visit_count
একইভাবে, গাড়ির স্টার্ট relaxations(i).level শিথিল করা হয় যদি এটি সন্তুষ্ট করে:
-
vehicle_start_time >= relaxations(i).threshold_timeAND -
relaxations(i).threshold_visit_count == 0এবং গাড়ির শেষrelaxations(i).levelশিথিল করা হয় যদি এটি সন্তুষ্ট হয়: -
vehicle_end_time >= relaxations(i).threshold_timeএবং -
route.visits_size() + 1 >= relaxations(i).threshold_visit_count
একটি শিথিলকরণ স্তর প্রয়োগ করতে যদি একটি ভিজিট threshold_visit_count বা threshold_time একই level সাথে দুটি relaxations যোগ করে: একটি শুধুমাত্র threshold_visit_count সেট সহ এবং অন্যটি শুধুমাত্র threshold_time সেট সহ। যদি একটি পরিদর্শন একাধিক relaxations শর্তগুলিকে সন্তুষ্ট করে, তবে সবচেয়ে শিথিল স্তরটি প্রযোজ্য। ফলস্বরূপ, যানবাহন শুরু থেকে রুট পরিদর্শনের মধ্য দিয়ে যান শেষ পর্যন্ত, শিথিলকরণ স্তরটি আরও শিথিল হয়ে ওঠে: অর্থাৎ, রুটটি অগ্রসর হওয়ার সাথে সাথে শিথিলকরণ স্তরটি হ্রাস পাচ্ছে না।
রুট ভিজিটের সময় এবং ক্রম যা কোন relaxations থ্রেশহোল্ড শর্ত পূরণ করে না তা সম্পূর্ণরূপে সীমাবদ্ধ এবং এই ক্রমগুলিতে কোন ভিজিট সন্নিবেশিত করা যাবে না। এছাড়াও, যদি একটি গাড়ির শুরু বা শেষ কোনো শিথিলতার শর্ত পূরণ না করে তবে সময় নির্দিষ্ট করা হয়, যদি না গাড়িটি খালি থাকে।
| ক্ষেত্র | |
|---|---|
level | সীমাবদ্ধতা শিথিলকরণ স্তর যা প্রযোজ্য হয় যখন |
threshold_time | যে সময় বা তার পরে শিথিলকরণ |
threshold_visit_count | পরিদর্শনের সংখ্যা বা তার পরে শিথিলকরণ যদি এটি |
স্তর
বিভিন্ন সীমাবদ্ধতা শিথিলকরণ স্তরগুলি প্রকাশ করে, যা একটি পরিদর্শনের জন্য প্রয়োগ করা হয় এবং যেগুলি থ্রেশহোল্ড শর্তগুলিকে সন্তুষ্ট করার সময় অনুসরণ করে৷
নীচের গণনাটি শিথিলকরণ বৃদ্ধির ক্রম অনুসারে।
| Enums | |
|---|---|
LEVEL_UNSPECIFIED | অন্তর্নিহিত ডিফল্ট শিথিলকরণ স্তর: কোন সীমাবদ্ধতা শিথিল করা হয় না, অর্থাৎ, সমস্ত পরিদর্শন সম্পূর্ণরূপে সীমাবদ্ধ। এই মানটি স্পষ্টভাবে |
RELAX_VISIT_TIMES_AFTER_THRESHOLD | ভিজিট শুরুর সময় এবং গাড়ির শুরু/শেষের সময় শিথিল করা হবে, কিন্তু প্রতিটি ভিজিট একই গাড়ির সাথে আবদ্ধ থাকবে এবং ভিজিট সিকোয়েন্স অবশ্যই পালন করতে হবে: তাদের মধ্যে বা তাদের আগে কোন ভিজিট ঢোকানো যাবে না। |
RELAX_VISIT_TIMES_AND_SEQUENCE_AFTER_THRESHOLD | RELAX_VISIT_TIMES_AFTER_THRESHOLD এর মতোই, কিন্তু ভিজিট সিকোয়েন্সটিও শিথিল: ভিজিটগুলি শুধুমাত্র এই গাড়ির মাধ্যমে করা যেতে পারে, কিন্তু সম্ভাব্যভাবে অকার্যকর হয়ে যেতে পারে৷ |
RELAX_ALL_AFTER_THRESHOLD | RELAX_VISIT_TIMES_AND_SEQUENCE_AFTER_THRESHOLD এর মতোই, তবে গাড়িটিও শিথিল: থ্রেশহোল্ডের সময় বা তার পরে পরিদর্শন সম্পূর্ণ বিনামূল্যে এবং সম্ভাব্যভাবে অকার্যকর হয়ে যেতে পারে। |
ইনপুট কনফিগারেশন
[BatchOptimizeTours][google.maps.routeoptimization.v1.RouteOptimizationService.BatchOptimizeTours]-এর জন্য একটি ইনপুট নির্দিষ্ট করুন।
| ক্ষেত্র | |
|---|---|
data_format | প্রয়োজন। ইনপুট তথ্য বিন্যাস. |
ইউনিয়ন ক্ষেত্র source । প্রয়োজন। source নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: | |
gcs_source | একটি Google ক্লাউড স্টোরেজ অবস্থান। এটি একটি একক বস্তু (ফাইল) হতে হবে। |
অবস্থান
একটি অবস্থান (একটি ভৌগলিক বিন্দু, এবং একটি ঐচ্ছিক শিরোনাম) এনক্যাপসুলেট করে।
| ক্ষেত্র | |
|---|---|
lat_lng | ওয়েপয়েন্টের ভৌগলিক স্থানাঙ্ক। |
heading | কম্পাস শিরোনাম ট্র্যাফিক প্রবাহের দিকের সাথে যুক্ত। পিকআপ এবং ড্রপ-অফের জন্য ব্যবহার করার জন্য রাস্তার পাশে নির্দিষ্ট করতে এই মানটি ব্যবহার করা হয়। শিরোনামের মান 0 থেকে 360 পর্যন্ত হতে পারে, যেখানে 0 সঠিক উত্তরের একটি শিরোনাম নির্দিষ্ট করে, 90 পূর্বের পূর্বের শিরোনাম উল্লেখ করে ইত্যাদি। |
অপটিমাইজ ট্যুর রিকোয়েস্ট
একটি ট্যুর অপ্টিমাইজেশান সমাধানকারীকে দেওয়ার অনুরোধ যা সমাধানের জন্য শিপমেন্ট মডেলের পাশাপাশি অপ্টিমাইজেশন প্যারামিটারগুলিকে সংজ্ঞায়িত করে৷
| ক্ষেত্র | |
|---|---|
parent | প্রয়োজন। একটি কল করতে লক্ষ্য প্রকল্প বা অবস্থান. বিন্যাস: * কোনো অবস্থান নির্দিষ্ট না থাকলে, একটি অঞ্চল স্বয়ংক্রিয়ভাবে বেছে নেওয়া হবে। |
timeout | এই টাইমআউট সেট করা থাকলে, টাইমআউট পিরিয়ড অতিবাহিত হওয়ার আগে বা সিঙ্ক্রোনাস অনুরোধের জন্য সার্ভারের সময়সীমা পৌঁছে যাওয়ার আগে সার্ভার একটি প্রতিক্রিয়া প্রদান করে, যেটি তাড়াতাড়ি হয়। অ্যাসিঙ্ক্রোনাস অনুরোধের জন্য, সময় শেষ হওয়ার আগে সার্ভার একটি সমাধান (যদি সম্ভব হয়) তৈরি করবে। |
model | সমাধানের জন্য চালানের মডেল। |
solving_mode | ডিফল্টরূপে, সমাধানের মোড হল |
search_mode | অনুসন্ধান মোড অনুরোধ সমাধান করতে ব্যবহৃত. |
injected_first_solution_routes[] | পূর্ববর্তী সমাধানের অনুরূপ একটি প্রথম সমাধান খুঁজে পেতে অপ্টিমাইজেশান অ্যালগরিদমকে গাইড করুন। প্রথম সমাধান নির্মিত হলে মডেলটি সীমাবদ্ধ। কোনো রুটে সঞ্চালিত নয় এমন কোনো চালান প্রথম সমাধানে পরোক্ষভাবে বাদ দেওয়া হয়, তবে সেগুলো ধারাবাহিক সমাধানে সঞ্চালিত হতে পারে। সমাধানটি অবশ্যই কিছু মৌলিক বৈধতা অনুমান পূরণ করবে:
যদি ইনজেকশন দেওয়া দ্রবণটি সম্ভব না হয়, তবে একটি বৈধতা ত্রুটি অগত্যা ফেরত দেওয়া হয় না এবং এর পরিবর্তে অসম্ভাব্যতা নির্দেশ করে একটি ত্রুটি ফেরত দেওয়া হতে পারে। |
injected_solution_constraint | অপ্টিমাইজেশান অ্যালগরিদম সীমাবদ্ধ করুন একটি চূড়ান্ত সমাধান খুঁজে পেতে যা পূর্ববর্তী সমাধানের মতো। উদাহরণস্বরূপ, এটি রুটের অংশগুলিকে হিমায়িত করতে ব্যবহার করা যেতে পারে যা ইতিমধ্যে সম্পন্ন হয়েছে বা যা সম্পূর্ণ করা হবে কিন্তু সংশোধন করা উচিত নয়। যদি ইনজেকশন দেওয়া দ্রবণটি সম্ভব না হয়, তবে একটি বৈধতা ত্রুটি অগত্যা ফেরত দেওয়া হয় না এবং এর পরিবর্তে অসম্ভাব্যতা নির্দেশ করে একটি ত্রুটি ফেরত দেওয়া হতে পারে। |
refresh_details_routes[] | যদি খালি না হয়, প্রদত্ত রুটগুলি রিফ্রেশ করা হবে, তাদের ভিজিট বা ভ্রমণের সময়গুলির অন্তর্নিহিত ক্রম পরিবর্তন না করে: শুধুমাত্র অন্যান্য বিবরণ আপডেট করা হবে। এটি মডেলের সমাধান করে না। 2020/11 অনুসারে, এটি শুধুমাত্র খালি নয় এমন রুটের পলিলাইনগুলিকে পপুলেট করে এবং প্রয়োজন যে পাস করা রুটের এই ক্ষেত্রটি অবশ্যই |
interpret_injected_solutions_using_labels | সত্য হলে:
এই ব্যাখ্যাটি সত্য হলে, নিম্নলিখিত বিভাগের লেবেলগুলি অবশ্যই তাদের বিভাগে একবারে উপস্থিত হতে হবে:
যদি ইনজেকশনের দ্রবণে একটি একটি ইনজেকশনযুক্ত দ্রবণ থেকে রুট ভিজিট বা সম্পূর্ণ রুটগুলি সরানো অন্তর্নিহিত সীমাবদ্ধতার উপর প্রভাব ফেলতে পারে, যা সমাধানে পরিবর্তন, বৈধতা ত্রুটি বা অসম্ভাব্যতা হতে পারে। দ্রষ্টব্য: কলকারীকে অবশ্যই নিশ্চিত করতে হবে যে প্রতিটি |
consider_road_traffic | |
populate_polylines | সত্য হলে, |
populate_transition_polylines | সত্য হলে, |
allow_large_deadline_despite_interruption_risk | যদি এটি সেট করা থাকে, তাহলে অনুরোধের একটি সময়সীমা থাকতে পারে ( https://grpc.io/blog/deadlines দেখুন) 60 মিনিট পর্যন্ত। অন্যথায়, সর্বোচ্চ সময়সীমা মাত্র 30 মিনিট। মনে রাখবেন যে দীর্ঘস্থায়ী অনুরোধগুলির একটি উল্লেখযোগ্যভাবে বড় (কিন্তু এখনও ছোট) বাধার ঝুঁকি রয়েছে। |
use_geodesic_distances | যদি সত্য হয়, ভ্রমণের দূরত্বগুলি Google মানচিত্রের দূরত্বের পরিবর্তে জিওডেসিক দূরত্ব ব্যবহার করে গণনা করা হবে, এবং ভ্রমণের সময়গুলি জিওডেসিক দূরত্ব ব্যবহার করে গণনা করা হবে |
label | এই অনুরোধ শনাক্ত করতে ব্যবহার করা হতে পারে এমন লেবেল, |
geodesic_meters_per_second | যখন |
max_validation_errors | প্রত্যাবর্তিত বৈধতা ত্রুটির সংখ্যা ছেঁটে ফেলে৷ এই ত্রুটিগুলি সাধারণত একটি INVALID_ARGUMENT ত্রুটির পেলোডের সাথে একটি BadRequest ত্রুটি বিশদ বিবরণ ( https://cloud.google.com/apis/design/errors#error_details ) হিসাবে সংযুক্ত থাকে, যদি না solving_mode=VALIDATE_ONLY: |
অনুসন্ধান মোড
মোড অনুসন্ধানের আচরণকে সংজ্ঞায়িত করে, ট্রেডিং অফ লেটেন্সি বনাম সমাধানের গুণমান। সমস্ত মোডে, বিশ্বব্যাপী অনুরোধের সময়সীমা কার্যকর করা হয়।
| Enums | |
|---|---|
SEARCH_MODE_UNSPECIFIED | অনির্দিষ্ট অনুসন্ধান মোড, RETURN_FAST এর সমতুল্য। |
RETURN_FAST | প্রথম ভাল সমাধান খুঁজে পাওয়ার পরে অনুসন্ধান বন্ধ করুন। |
CONSUME_ALL_AVAILABLE_TIME | আরও ভাল সমাধান অনুসন্ধান করার জন্য সমস্ত উপলব্ধ সময় ব্যয় করুন। |
সমাধান মোড
সমাধানকারীর অনুরোধটি কীভাবে পরিচালনা করা উচিত তা সংজ্ঞায়িত করে। সমস্ত মোডে VALIDATE_ONLY , যদি অনুরোধটি অবৈধ হয়, আপনি একটি INVALID_REQUEST ত্রুটি পাবেন৷ ফিরে আসা ত্রুটির সংখ্যা ক্যাপ করতে max_validation_errors দেখুন।
| Enums | |
|---|---|
DEFAULT_SOLVE | মডেলটি সমাধান করুন। [OptimizeToursResponse.validation_errors][google.cloud.optimization.v1.OptimizeToursResponse.validation_errors]-এ সতর্কতা জারি করা হতে পারে। |
VALIDATE_ONLY | শুধুমাত্র মডেলটিকে সমাধান না করেই যাচাই করে: যতটা সম্ভব OptimizeToursResponse.validation_errors পূরণ করে। |
DETECT_SOME_INFEASIBLE_SHIPMENTS | শুধুমাত্র গুরুত্বপূর্ণ : সমস্ত অসম্ভাব্য চালান এখানে ফেরত দেওয়া হয় না, তবে শুধুমাত্র যেগুলি প্রিপ্রসেসিংয়ের সময় অসম্ভাব্য হিসাবে সনাক্ত করা হয়। |
OptimizeToursResponse
একটি ট্যুর অপ্টিমাইজেশান সমস্যার সমাধান করার পরে প্রতিক্রিয়া যা প্রতিটি গাড়ির দ্বারা অনুসরণ করা রুটগুলি, শিপমেন্টগুলি যা এড়িয়ে গেছে এবং সমাধানের সামগ্রিক খরচ।
| ক্ষেত্র | |
|---|---|
routes[] | প্রতিটি গাড়ির জন্য গণনা করা রুট; i-th রুট মডেলের i-th যানের সাথে মিলে যায়। |
request_label | |
skipped_shipments[] | সমস্ত চালানের তালিকা এড়িয়ে গেছে। |
validation_errors[] | সমস্ত বৈধতা ত্রুটির তালিকা যা আমরা স্বাধীনভাবে সনাক্ত করতে সক্ষম হয়েছি। |
metrics | এই সমাধানের জন্য সময়কাল, দূরত্ব এবং ব্যবহারের মেট্রিক্স। |
মেট্রিক্স
সামগ্রিক মেট্রিক্স, সমস্ত রুটে একত্রিত।
| ক্ষেত্র | |
|---|---|
aggregated_route_metrics | রুট উপর একত্রিত. প্রতিটি মেট্রিক হল একই নামের সমস্ত |
skipped_mandatory_shipment_count | এড়িয়ে যাওয়া বাধ্যতামূলক চালানের সংখ্যা। |
used_vehicle_count | ব্যবহৃত যানবাহনের সংখ্যা। দ্রষ্টব্য: যদি একটি যানবাহনের রুট খালি থাকে এবং |
earliest_vehicle_start_time | একটি ব্যবহৃত গাড়ির জন্য প্রথম দিকের শুরুর সময়, |
latest_vehicle_end_time | একটি ব্যবহৃত গাড়ির সর্বশেষ শেষ সময়, |
costs | সমাধানের খরচ, খরচ-সম্পর্কিত অনুরোধ ক্ষেত্র দ্বারা বিভক্ত। কীগুলি হল প্রোটো পাথ, ইনপুট OptimizeToursRequest-এর সাপেক্ষে, যেমন "model.shipments.pickups.cost", এবং মানগুলি হল সংশ্লিষ্ট খরচ ক্ষেত্রের দ্বারা উত্পন্ন মোট খরচ, সমগ্র সমাধানের উপর একত্রিত৷ অন্য কথায়, খরচ ["model.shipments.pickups.cost"] হল সমাধানের সমস্ত পিকআপ খরচের সমষ্টি। মডেলে সংজ্ঞায়িত সমস্ত খরচ এখানে বিস্তারিতভাবে রিপোর্ট করা হয়েছে ট্রানজিশন অ্যাট্রিবিউটের সাথে সম্পর্কিত খরচগুলি বাদ দিয়ে যেগুলি শুধুমাত্র 2022/01 হিসাবে সমষ্টিগতভাবে রিপোর্ট করা হয়েছে। |
total_cost | সমাধানের মোট খরচ। খরচ ম্যাপে সমস্ত মানের সমষ্টি। |
OptimizeToursValidationError
একটি OptimizeToursRequest যাচাই করার সময় একটি ত্রুটি বা সতর্কতা দেখা দেয়।
| ক্ষেত্র | |
|---|---|
code | একটি বৈধতা ত্রুটি জোড়া ( অন্যান্য ক্ষেত্র (নীচে) ত্রুটি সম্পর্কে আরও প্রসঙ্গ প্রদান করে। একাধিক ত্রুটি : যখন একাধিক ত্রুটি থাকে, তখন যাচাইকরণ প্রক্রিয়া তাদের মধ্যে কয়েকটি আউটপুট করার চেষ্টা করে। অনেকটা কম্পাইলারের মতো, এটি একটি অপূর্ণ প্রক্রিয়া। কিছু বৈধতা ত্রুটি "মারাত্মক" হবে, যার অর্থ তারা পুরো বৈধতা প্রক্রিয়া বন্ধ করে দেয়। অন্যদের মধ্যে স্থিতিশীলতা : রেফারেন্স : সমস্ত (কোড, নাম) জোড়ার একটি তালিকা:
|
display_name | ত্রুটি প্রদর্শনের নাম। |
fields[] | একটি ত্রুটি প্রসঙ্গে 0, 1 (বেশিরভাগ সময়) বা আরও বেশি ক্ষেত্র জড়িত থাকতে পারে। উদাহরণস্বরূপ, যানবাহন #4 এবং চালান #2 এর প্রথম পিকআপ উল্লেখ করে নিম্নরূপ করা যেতে পারে: তবে দ্রষ্টব্য, |
error_message | ত্রুটি বর্ণনা করে মানব-পঠনযোগ্য স্ট্রিং। স্থিতিশীলতা : স্থিতিশীল নয়: প্রদত্ত |
offending_values | ক্ষেত্রের মান (গুলি) থাকতে পারে। এটি সর্বদা পাওয়া যায় না। আপনার একেবারে নির্ভর করা উচিত নয় এবং এটি কেবল ম্যানুয়াল মডেল ডিবাগিংয়ের জন্য ব্যবহার করা উচিত। |
ফিল্ডরেফারেন্স
বৈধতা ত্রুটির জন্য একটি প্রসঙ্গ নির্দিষ্ট করে। একটি FieldReference সর্বদা এই ফাইলের একটি প্রদত্ত ক্ষেত্রকে বোঝায় এবং একই শ্রেণিবদ্ধ কাঠামো অনুসরণ করে। উদাহরণস্বরূপ, আমরা #5 এর start_time_windows #5 এর উপাদান #2 নির্দিষ্ট করতে পারি:
name: "vehicles" index: 5 sub_field { name: "end_time_windows" index: 2 }
তবে আমরা বার্তাটি ভিড় এড়াতে শীর্ষ-স্তরের সত্তা যেমন OptimizeToursRequest বা ShipmentModel মতো বাদ দিই।
| ক্ষেত্র | |
|---|---|
name | ক্ষেত্রের নাম, যেমন, "যানবাহন"। |
sub_field | প্রয়োজনে পুনরাবৃত্তভাবে সাব-ফিল্ড নেস্টেড। |
ইউনিয়ন ক্ষেত্র | |
index | পুনরাবৃত্তি হলে ক্ষেত্রের সূচক। |
key | ক্ষেত্রটি যদি মানচিত্র হয় তবে কী। |
আউটপুট কনফিগারেশন
[ব্যাচঅপটাইমাইজেটস] [গুগল.ম্যাপস.আরউটিওপটিমাইজেশন.ভি .1.routeoptimizationservice.batchoptimizetours] ফলাফলের জন্য একটি গন্তব্য উল্লেখ করুন।
| ক্ষেত্র | |
|---|---|
data_format | প্রয়োজন। আউটপুট ডেটা ফর্ম্যাট। |
ইউনিয়ন ক্ষেত্রের destination । প্রয়োজন। destination নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: | |
gcs_destination | আউটপুট লিখতে গুগল ক্লাউড স্টোরেজ অবস্থান। |
রুটমোডাইফায়ার
গাড়ির রুটগুলি গণনা করার সময় সন্তুষ্ট করতে al চ্ছিক শর্তগুলির একটি সেটকে এনক্যাপসুলেট করে। এটি গুগল ম্যাপস প্ল্যাটফর্মের রুটগুলির পছন্দসই এপিআইয়ের RouteModifiers মতো; দেখুন: https://developers.google.com/maps/docamentation/routes/reference/rest/v2/routemodifiers ।
| ক্ষেত্র | |
|---|---|
avoid_tolls | যুক্তিসঙ্গত যেখানে টোল রাস্তাগুলি এড়াতে হবে কিনা তা নির্দিষ্ট করে। টোল রাস্তা না থাকা রুটগুলিতে অগ্রাধিকার দেওয়া হবে। কেবল মোটরযুক্ত ভ্রমণ মোডে প্রযোজ্য। |
avoid_highways | যুক্তিসঙ্গত যেখানে হাইওয়েগুলি এড়াতে হবে কিনা তা নির্দিষ্ট করে। মহাসড়কযুক্ত নয় এমন রুটগুলিতে অগ্রাধিকার দেওয়া হবে। কেবল মোটরযুক্ত ভ্রমণ মোডে প্রযোজ্য। |
avoid_ferries | যুক্তিসঙ্গত যেখানে ফেরিগুলি এড়ানো উচিত কিনা তা নির্দিষ্ট করে। ফেরি দ্বারা ভ্রমণ না থাকা রুটগুলিতে অগ্রাধিকার দেওয়া হবে। কেবল মোটরযুক্ত ভ্রমণ মোডে প্রযোজ্য। |
avoid_indoor | ঐচ্ছিক। যুক্তিসঙ্গত যেখানে বাড়ির ভিতরে নেভিগেট করা এড়ানো উচিত কিনা তা নির্দিষ্ট করে। ইনডোর নেভিগেশন না থাকা রুটগুলিতে অগ্রাধিকার দেওয়া হবে। কেবল |
চালান
একটি একক আইটেমের চালান, এর একটি পিকআপ থেকে শুরু করে এর একটি বিতরণ। চালানটি সম্পাদিত হিসাবে বিবেচনা করার জন্য, একটি অনন্য যানবাহন অবশ্যই তার পিকআপের একটি অবস্থানগুলিতে যেতে হবে (এবং সেই অনুযায়ী তার অতিরিক্ত ক্ষমতা হ্রাস করতে হবে), তারপরে পরে তার বিতরণ অবস্থানগুলির একটিতে যান (এবং তাই সেই অনুযায়ী তার অতিরিক্ত ক্ষমতাগুলি পুনরায় ইন-ক্রেজ করুন)।
| ক্ষেত্র | |
|---|---|
display_name | চালানের ব্যবহারকারী-সংজ্ঞায়িত ডিসপ্লে নাম। এটি 63 টি অক্ষর দীর্ঘ হতে পারে এবং ইউটিএফ -8 অক্ষর ব্যবহার করতে পারে। |
pickups[] | চালানের সাথে সম্পর্কিত পিকআপ বিকল্পগুলির সেট। যদি নির্দিষ্ট না করা হয় তবে যানবাহনটি কেবলমাত্র সরবরাহের সাথে সম্পর্কিত কোনও অবস্থান ঘুরে দেখতে হবে। |
deliveries[] | চালানের সাথে সম্পর্কিত বিতরণ বিকল্পগুলির সেট। যদি নির্দিষ্ট না করা হয় তবে যানবাহনটি কেবল পিকআপগুলির সাথে সম্পর্কিত কোনও অবস্থান ঘুরে দেখতে হবে। |
load_demands | চালানের চাহিদা লোড (উদাহরণস্বরূপ ওজন, ভলিউম, প্যালেটগুলির সংখ্যা ইত্যাদি)। মানচিত্রের কীগুলি সংশ্লিষ্ট লোডের ধরণটি বর্ণনা করে সনাক্তকারী হওয়া উচিত, আদর্শভাবে ইউনিটগুলিও অন্তর্ভুক্ত করে। উদাহরণস্বরূপ: "ওজন_কেজি", "ভলিউম_গ্যালনস", "প্যালেট_কাউন্ট" ইত্যাদি। যদি কোনও প্রদত্ত কী মানচিত্রে উপস্থিত না হয় তবে সংশ্লিষ্ট লোডটিকে নাল হিসাবে বিবেচনা করা হয়। |
allowed_vehicle_indices[] | এই চালানটি সম্পাদন করতে পারে এমন যানবাহনের সেট। খালি থাকলে, সমস্ত যানবাহন এটি সম্পাদন করতে পারে। যানবাহন তাদের সূচক দ্বারা |
costs_per_vehicle[] | এই চালানটি প্রতিটি যানবাহন সরবরাহ করে যখন ব্যয় হয় তা নির্দিষ্ট করে। যদি নির্দিষ্ট করা হয় তবে এটি অবশ্যই থাকতে হবে:
এই ব্যয়গুলি অবশ্যই |
costs_per_vehicle_indices[] | যে যানবাহনগুলির সূচকগুলি |
pickup_to_delivery_absolute_detour_limit | পিকআপ থেকে ডেলিভারি পর্যন্ত স্বল্পতম পথের তুলনায় সর্বাধিক পরম ডিটার সময় নির্দিষ্ট করে। যদি নির্দিষ্ট করা হয় তবে এটি অবশ্যই অবিচ্ছিন্ন হতে হবে এবং চালানের অবশ্যই কমপক্ষে একটি পিকআপ এবং একটি বিতরণ থাকতে হবে। উদাহরণস্বরূপ, নির্বাচিত পিকআপ বিকল্প থেকে সরাসরি নির্বাচিত বিতরণ বিকল্পের দিকে যাওয়ার জন্য সবচেয়ে কম সময় নেওয়া উচিত। তারপরে যদি উভয়ই আপেক্ষিক এবং পরম সীমা একই চালানিতে নির্দিষ্ট করা হয় তবে প্রতিটি সম্ভাব্য পিকআপ/বিতরণ জুটির জন্য আরও সীমাবদ্ধ সীমা ব্যবহার করা হয়। 2017/10 হিসাবে, যখন ভ্রমণের সময়সীমা যানবাহনের উপর নির্ভর করে না তখন ডিটারগুলি কেবল তখনই সমর্থিত হয়। |
pickup_to_delivery_time_limit | চালানের সরবরাহ শুরু করার জন্য পিকআপ শুরু থেকে সর্বাধিক সময়কাল নির্দিষ্ট করে। যদি নির্দিষ্ট করা হয় তবে এটি অবশ্যই অবিচ্ছিন্ন হতে হবে এবং চালানের অবশ্যই কমপক্ষে একটি পিকআপ এবং একটি বিতরণ থাকতে হবে। এটি নির্ভর করে না যে কোন বিকল্পগুলি পিকআপ এবং বিতরণের জন্য বা যানবাহনের গতির উপর নির্বাচন করা হয় তার উপর নির্ভর করে না। এটি সর্বাধিক প্রদত্ত সীমাবদ্ধতার পাশাপাশি নির্দিষ্ট করা যেতে পারে: সমাধানটি উভয় স্পেসিফিকেশনকে সম্মান করবে। |
shipment_type | এই চালানের জন্য একটি "টাইপ" নির্দিষ্ট করে অ-খালি স্ট্রিং। এই বৈশিষ্ট্যটি |
label | এই চালানের জন্য একটি লেবেল নির্দিষ্ট করে। এই লেবেলটি সংশ্লিষ্ট |
ignore | যদি সত্য হয় তবে এই চালানটি এড়িয়ে যান, তবে মডেলটিতে কোনও |
penalty_cost | যদি চালানটি সম্পূর্ণ না করা হয় তবে এই জরিমানাটি রুটের সামগ্রিক ব্যয়ে যুক্ত করা হয়। যদি এর কোনও পিকআপ এবং বিতরণ বিকল্প পরিদর্শন করা হয় তবে একটি চালান সম্পূর্ণ হিসাবে বিবেচিত হয়। মডেলটিতে অন্যান্য সমস্ত ব্যয় সম্পর্কিত ক্ষেত্রগুলির জন্য ব্যবহৃত একই ইউনিটে ব্যয়টি প্রকাশ করা যেতে পারে এবং অবশ্যই ইতিবাচক হতে হবে। গুরুত্বপূর্ণ : যদি এই জরিমানা নির্দিষ্ট না করা হয় তবে এটি অসীম হিসাবে বিবেচিত হয়, অর্থাত্ চালানটি অবশ্যই সম্পন্ন করতে হবে। |
pickup_to_delivery_relative_detour_limit | পিকআপ থেকে ডেলিভারি পর্যন্ত স্বল্পতম পথের তুলনায় সর্বাধিক আপেক্ষিক ডিটার সময় নির্দিষ্ট করে। যদি নির্দিষ্ট করা হয় তবে এটি অবশ্যই অবিচ্ছিন্ন হতে হবে এবং চালানের অবশ্যই কমপক্ষে একটি পিকআপ এবং একটি বিতরণ থাকতে হবে। উদাহরণস্বরূপ, নির্বাচিত পিকআপ বিকল্প থেকে সরাসরি নির্বাচিত বিতরণ বিকল্পের দিকে যাওয়ার জন্য সবচেয়ে কম সময় নেওয়া উচিত। তারপরে যদি উভয়ই আপেক্ষিক এবং পরম সীমা একই চালানিতে নির্দিষ্ট করা হয় তবে প্রতিটি সম্ভাব্য পিকআপ/বিতরণ জুটির জন্য আরও সীমাবদ্ধ সীমা ব্যবহার করা হয়। 2017/10 হিসাবে, যখন ভ্রমণের সময়সীমা যানবাহনের উপর নির্ভর করে না তখন ডিটারগুলি কেবল তখনই সমর্থিত হয়। |
লোড
ভিজিট করার সময়, একটি পিকআপ হলে গাড়ির লোডে একটি পূর্বনির্ধারিত পরিমাণ যুক্ত করা যেতে পারে, বা এটি সরবরাহ করা হলে বিয়োগ করা যেতে পারে। এই বার্তাটি এ জাতীয় পরিমাণ সংজ্ঞায়িত করে। load_demands দেখুন।
| ক্ষেত্র | |
|---|---|
amount | সংশ্লিষ্ট ভিজিট সম্পাদনকারী যানবাহনের লোড যার দ্বারা পৃথক হবে। যেহেতু এটি একটি পূর্ণসংখ্যা, তাই ব্যবহারকারীদের নির্ভুলতা হ্রাস এড়াতে উপযুক্ত ইউনিট বেছে নেওয়ার পরামর্শ দেওয়া হয়। অবশ্যই ≥ 0 হতে হবে। |
ভিজিটরেকুয়েস্ট দেখুন
কোনও যানবাহন দ্বারা করা যেতে পারে এমন একটি দেখার জন্য অনুরোধ করুন: এটিতে একটি ভূ-অবস্থান রয়েছে (বা দুটি, নীচে দেখুন), সময় উইন্ডোজ দ্বারা প্রতিনিধিত্ব করা এবং বন্ধ করার সময়গুলি এবং একটি পরিষেবা সময়কাল সময় (যানবাহনটি আসার পরে এটি একবারে ব্যয় করা হয় পণ্য পিকআপ বা ড্রপ বন্ধ করতে)।
| ক্ষেত্র | |
|---|---|
arrival_location | এই |
arrival_waypoint | এই |
departure_location | ভূ-অবস্থান যেখানে এই |
departure_waypoint | এই |
tags[] | ভিজিট অনুরোধের সাথে সংযুক্ত ট্যাগগুলি নির্দিষ্ট করে। খালি বা সদৃশ স্ট্রিং অনুমোদিত নয়। |
time_windows[] | টাইম উইন্ডোজ যা একটি দর্শন সময় আগমনের সময়কে সীমাবদ্ধ করে। নোট করুন যে কোনও যানবাহন আগমনের সময় উইন্ডোর বাইরে চলে যেতে পারে, অর্থাত্ আগমনের সময় + সময়কাল কোনও সময় উইন্ডোর ভিতরে থাকার দরকার নেই। টাইম উইন্ডোজ অবশ্যই বিরক্ত হতে হবে, অর্থাত্ কোনও সময় উইন্ডো অবশ্যই অন্যের সাথে ওভারল্যাপ করতে হবে বা অন্য সংলগ্ন হতে হবে এবং সেগুলি অবশ্যই ক্রমবর্ধমান ক্রমে থাকতে হবে। |
duration | ভিজিটের সময়কাল, অর্থাত্ আগমন এবং প্রস্থানের মধ্যে যানবাহন দ্বারা ব্যয় করা সময় (সম্ভাব্য অপেক্ষার সময়টিতে যুক্ত হতে হবে; |
cost | কোনও যানবাহনের রুটে এই ভিজিট অনুরোধটি পরিষেবা দিতে ব্যয়। এটি প্রতিটি বিকল্প পিকআপ বা চালানের সরবরাহের জন্য বিভিন্ন ব্যয় দিতে ব্যবহার করা যেতে পারে। এই ব্যয়টি অবশ্যই |
load_demands | এই ভিজিট অনুরোধের দাবি লোড। এটি ঠিক |
visit_types[] | ভিজিটের ধরণগুলি নির্দিষ্ট করে। এটি কোনও যানবাহন এই দর্শনটি সম্পূর্ণ করার জন্য প্রয়োজনীয় অতিরিক্ত সময় বরাদ্দ করতে ব্যবহৃত হতে পারে (দেখুন একটি প্রকার কেবল একবার উপস্থিত হতে পারে। |
label | এই |
শিপমেন্টমোডেল
একটি চালানের মডেলটিতে শিপমেন্টের একটি সেট রয়েছে যা সামগ্রিক ব্যয়কে হ্রাস করার সময় যানবাহনের একটি সেট দ্বারা সম্পাদন করতে হবে, যা এর যোগফল:
- যানবাহনগুলি রাউটিংয়ের ব্যয় (মোট সময় প্রতি ব্যয়ের যোগফল, ভ্রমণের সময় প্রতি ব্যয় এবং সমস্ত যানবাহনের উপর নির্ধারিত ব্যয়)।
- অপ্রয়োজনীয় চালানের জরিমানা।
- চালানের বৈশ্বিক সময়কালের ব্যয়
| ক্ষেত্র | |
|---|---|
shipments[] | শিপমেন্টের সেট যা অবশ্যই মডেলটিতে সম্পাদন করা উচিত। |
vehicles[] | যানবাহনের সেট যা ভিজিট সম্পাদন করতে ব্যবহার করা যেতে পারে। |
global_start_time | মডেলটির গ্লোবাল স্টার্ট এবং শেষ সময়: এই পরিসরের বাইরে কোনও সময় বৈধ হিসাবে বিবেচিত হতে পারে না। মডেলের সময়কাল অবশ্যই এক বছরেরও কম হতে হবে, অর্থাত্ |
global_end_time | যদি আনসেট হয়, 00:00:00 ইউটিসি, 1 জানুয়ারী, 1971 (অর্থাত্ সেকেন্ডস: 31536000, ন্যানোস: 0) ডিফল্ট হিসাবে ব্যবহৃত হয়। |
global_duration_cost_per_hour | সামগ্রিক পরিকল্পনার "বৈশ্বিক সময়কাল" হ'ল প্রাথমিকতম কার্যকর শুরুর সময় এবং সমস্ত যানবাহনের সর্বশেষ কার্যকর শেষ সময়ের মধ্যে পার্থক্য। উদাহরণস্বরূপ, প্রথম দিকের কাজ সমাপ্তির জন্য চেষ্টা এবং অনুকূল করার জন্য ব্যবহারকারীরা সেই পরিমাণকে প্রতি ঘন্টা ব্যয় নির্ধারণ করতে পারেন। এই ব্যয়টি অবশ্যই |
duration_distance_matrices[] | মডেলটিতে ব্যবহৃত সময়কাল এবং দূরত্ব ম্যাট্রিকগুলি নির্দিষ্ট করে। যদি এই ক্ষেত্রটি খালি থাকে তবে গুগল ম্যাপস বা জিওডেসিক দূরত্বগুলি পরিবর্তে ব্যবহার করা হবে, ব্যবহারের উদাহরণ:
|
duration_distance_matrix_src_tags[] | সময়কাল এবং দূরত্বের ম্যাট্রিকগুলির উত্সগুলি সংজ্ঞায়িত ট্যাগগুলি; ট্যাগগুলি |
duration_distance_matrix_dst_tags[] | সময়কাল এবং দূরত্বের ম্যাট্রিকগুলির গন্তব্যগুলি সংজ্ঞায়িত ট্যাগগুলি; ট্যাগগুলি |
transition_attributes[] | মডেলটিতে রূপান্তর বৈশিষ্ট্য যুক্ত করা হয়েছে। |
shipment_type_incompatibilities[] | বেমানান শিপমেন্ট_ টাইপগুলির সেটগুলি ( |
shipment_type_requirements[] | |
precedence_rules[] | অগ্রাধিকার বিধিগুলির সেট যা অবশ্যই মডেলটিতে প্রয়োগ করা উচিত। |
max_active_vehicles | সক্রিয় যানবাহনের সর্বাধিক সংখ্যাকে সীমাবদ্ধ করে। কোনও যানবাহন সক্রিয় থাকে যদি এর রুটটি কমপক্ষে একটি চালান সম্পাদন করে। এটি যানবাহনের চেয়ে কম ড্রাইভার রয়েছে এবং যানবাহনের বহরটি ভিন্নধর্মী এমন ক্ষেত্রে রুটের সংখ্যা সীমাবদ্ধ করতে ব্যবহার করা যেতে পারে। অপ্টিমাইজেশন তারপরে ব্যবহারের জন্য যানবাহনের সেরা উপসেটটি নির্বাচন করবে। কঠোরভাবে ইতিবাচক হতে হবে। |
সময়কাল ডিস্ট্যান্টসেম্যাট্রিক্স
ভিজিট এবং যানবাহন শুরু করার অবস্থানগুলি এবং যানবাহন শেষের অবস্থানগুলি থেকে একটি সময়কাল এবং দূরত্বের ম্যাট্রিক্স নির্দিষ্ট করে।
| ক্ষেত্র | |
|---|---|
rows[] | সময়কাল এবং দূরত্বের ম্যাট্রিক্সের সারিগুলি নির্দিষ্ট করে। এটি অবশ্যই |
vehicle_start_tag | এই সময়কাল এবং দূরত্বের ম্যাট্রিক্স প্রয়োগ করে কোন যানবাহনগুলি সংজ্ঞায়িত করে ট্যাগ। যদি খালি হয় তবে এটি সমস্ত যানবাহনের ক্ষেত্রে প্রযোজ্য এবং কেবল একটি একক ম্যাট্রিক্স থাকতে পারে। প্রতিটি যানবাহন শুরু করতে হবে ঠিক একটি ম্যাট্রিক্সের সাথে মেলে, অর্থাত্ তাদের সমস্ত ম্যাট্রিক্সের অবশ্যই একটি আলাদা |
সারি
সময়কাল এবং দূরত্বের ম্যাট্রিক্সের একটি সারি নির্দিষ্ট করে।
| ক্ষেত্র | |
|---|---|
durations[] | একটি প্রদত্ত সারির জন্য সময়কাল মান। এটি অবশ্যই |
meters[] | একটি প্রদত্ত সারির জন্য দূরত্বের মান। যদি কোনও ব্যয় বা সীমাবদ্ধতা মডেলটির দূরত্বগুলি উল্লেখ করে তবে এটি খালি রেখে দেওয়া যেতে পারে; অন্যথায় এটির |
পূর্ববর্তী
দুটি ইভেন্টের মধ্যে একটি অগ্রাধিকার নিয়ম (প্রতিটি ইভেন্ট হ'ল পিকআপ বা একটি চালানের বিতরণ): "দ্বিতীয়" ইভেন্টটি "প্রথম" শুরু হওয়ার পরে কমপক্ষে offset_duration শুরু করতে হবে।
বেশ কয়েকটি অগ্রাধিকার একই (বা সম্পর্কিত) ইভেন্টগুলিকে উল্লেখ করতে পারে, যেমন, "বি এর পিকআপ একটি সরবরাহের পরে ঘটে" এবং "সি এর পিকআপ বি পিকআপের পরে ঘটে"।
তদ্ব্যতীত, উভয় চালান সম্পাদন করা হয় এবং অন্যথায় উপেক্ষা করা হয় কেবল তখনই প্রযোজ্য প্রযোজ্য।
| ক্ষেত্র | |
|---|---|
first_is_delivery | "প্রথম" ইভেন্টটি যদি বিতরণ হয় তা নির্দেশ করে। |
second_is_delivery | "দ্বিতীয়" ইভেন্টটি যদি ডেলিভারি হয় তা নির্দেশ করে। |
offset_duration | "প্রথম" এবং "দ্বিতীয়" ইভেন্টের মধ্যে অফসেট। এটা নেতিবাচক হতে পারে. |
first_index | "প্রথম" ইভেন্টের চালান সূচক। এই ক্ষেত্রটি অবশ্যই নির্দিষ্ট করা উচিত। |
second_index | "দ্বিতীয়" ইভেন্টের চালান সূচক। এই ক্ষেত্রটি অবশ্যই নির্দিষ্ট করা উচিত। |
শিপমেন্ট রুট
একটি গাড়ির রুটটি সময়ের অক্ষের সাথে পচে যেতে পারে, এর মতো (আমরা ধরে নিই যে এন ভিজিট রয়েছে):
| | | | | T[2], | | |
| Transition | Visit #0 | | | V[2], | | |
| #0 | aka | T[1] | V[1] | ... | V[n-1] | T[n] |
| aka T[0] | V[0] | | | V[n-2],| | |
| | | | | T[n-1] | | |
^ ^ ^ ^ ^ ^ ^ ^
vehicle V[0].start V[0].end V[1]. V[1]. V[n]. V[n]. vehicle
start (arrival) (departure) start end start end end
নোট করুন যে আমরা এর মধ্যে একটি পার্থক্য তৈরি করি:
- "সময়োপযোগী ইভেন্টগুলি", যেমন যানবাহন শুরু এবং শেষ এবং প্রতিটি ভিজিটের শুরু এবং শেষ (ওরফে আগমন এবং প্রস্থান)। তারা একটি নির্দিষ্ট দ্বিতীয় সময়ে ঘটে।
- "সময় অন্তর", যেমন ভিজিট নিজেরাই এবং দর্শনগুলির মধ্যে রূপান্তর। যদিও সময়ের ব্যবধানগুলি কখনও কখনও শূন্য সময়কাল থাকতে পারে, অর্থাত্ একই সেকেন্ডে শুরু এবং শেষ হয়, তাদের প্রায়শই ইতিবাচক সময়কাল থাকে।
আক্রমণকারী:
- যদি এন ভিজিট থাকে তবে এন+1 ট্রানজিশন রয়েছে।
- একটি দর্শন সর্বদা এটির (একই সূচক) এবং এর পরে একটি ট্রানজিশন (সূচক + 1) এর আগে একটি রূপান্তর দ্বারা বেষ্টিত থাকে।
- যানবাহন শুরু সর্বদা স্থানান্তর #0 দ্বারা অনুসরণ করা হয়।
- গাড়ির শেষটি সর্বদা #এন ট্রানজিশনের আগে থাকে।
জুম ইন, এখানে একটি Transition এবং Visit চলাকালীন যা ঘটে তা এখানে:
---+-------------------------------------+-----------------------------+-->
| TRANSITION[i] | VISIT[i] |
| | |
| * TRAVEL: the vehicle moves from | PERFORM the visit: |
| VISIT[i-1].departure_location to | |
| VISIT[i].arrival_location, which | * Spend some time: |
| takes a given travel duration | the "visit duration". |
| and distance | |
| | * Load or unload |
| * BREAKS: the driver may have | some quantities from the |
| breaks (e.g. lunch break). | vehicle: the "demand". |
| | |
| * WAIT: the driver/vehicle does | |
| nothing. This can happen for | |
| many reasons, for example when | |
| the vehicle reaches the next | |
| event's destination before the | |
| start of its time window | |
| | |
| * DELAY: *right before* the next | |
| arrival. E.g. the vehicle and/or | |
| driver spends time unloading. | |
| | |
---+-------------------------------------+-----------------------------+-->
^ ^ ^
V[i-1].end V[i].start V[i].end
শেষ অবধি, এখানে কীভাবে ভ্রমণ, বিরতি, বিলম্ব এবং অপেক্ষা করার সময়টি কোনও পরিবর্তনের সময় সাজানো যেতে পারে।
- তারা ওভারল্যাপ না.
- বিলম্বটি অনন্য এবং পরবর্তী দর্শন (বা যানবাহনের শেষ) এর ঠিক আগে অবশ্যই একটি স্বচ্ছ সময় হতে হবে। সুতরাং, এর শুরু এবং শেষ সময়টি জানতে বিলম্বের সময়কালটি জানতে যথেষ্ট।
- বিরতিগুলি স্বচ্ছ, অ-ওভারল্যাপিং সময়কাল। প্রতিক্রিয়া প্রতিটি বিরতির শুরু সময় এবং সময়কাল নির্দিষ্ট করে।
- ভ্রমণ এবং অপেক্ষা "প্রিম্পেমেবল": এই সংক্রমণের সময় এগুলি বেশ কয়েকবার বাধা দেওয়া যেতে পারে। ক্লায়েন্টরা ধরে নিতে পারেন যে ভ্রমণ "যত তাড়াতাড়ি সম্ভব" ঘটে এবং "অপেক্ষা করুন" বাকি সময়টি পূরণ করে।
একটি (জটিল) উদাহরণ:
TRANSITION[i]
--++-----+-----------------------------------------------------------++-->
|| | | | | | | ||
|| T | B | T | | B | | D ||
|| r | r | r | W | r | W | e ||
|| a | e | a | a | e | a | l ||
|| v | a | v | i | a | i | a ||
|| e | k | e | t | k | t | y ||
|| l | | l | | | | ||
|| | | | | | | ||
--++-----------------------------------------------------------------++-->
| ক্ষেত্র | |
|---|---|
vehicle_index | সোর্স |
vehicle_label | এই রুটটি সম্পাদনকারী গাড়ির লেবেল, |
vehicle_start_time | যে সময় যানটি তার রুট শুরু করে। |
vehicle_end_time | যানবাহনটি তার রুটটি শেষ করে। |
visits[] | কোনও রুটের প্রতিনিধিত্বকারী ভিজিটের ক্রম ক্রম। ভিজিট [i] রুটে আই-থে ভিজিট। যদি এই ক্ষেত্রটি খালি থাকে তবে যানটিকে অব্যবহৃত হিসাবে বিবেচনা করা হয়। |
transitions[] | রুটের জন্য ট্রানজিশনের তালিকা অর্ডার করা। |
has_traffic_infeasibilities | যখন ট্র্যাফিকের কারণে ট্র্যাভেল টাইম |
route_polyline | রুটের এনকোডেড পললাইন উপস্থাপনা। এই ক্ষেত্রটি কেবল তখনই পপুলেশন করা হয় যদি |
breaks[] | এই রুটটি সম্পাদনকারী যানবাহনের জন্য নির্ধারিত বিরতি। |
metrics | এই রুটের জন্য সময়কাল, দূরত্ব এবং লোড মেট্রিকগুলি। প্রসঙ্গের উপর নির্ভর করে সমস্ত |
route_costs | রুটের ব্যয়, ব্যয় সম্পর্কিত অনুরোধ ক্ষেত্রগুলি দ্বারা ভেঙে। কীগুলি হ'ল প্রোটো পাথ, ইনপুট অপ্টিমাইজটোর্স রিকোয়েস্টের সাথে সম্পর্কিত, যেমন "মডেল.শিপমেন্টস.পিকআপস.কোস্ট", এবং মানগুলি পুরো রুটের সাথে একত্রিত করা ব্যয় ক্ষেত্রের দ্বারা উত্পাদিত মোট ব্যয়। অন্য কথায়, ব্যয়গুলি ["মডেল.শিপমেন্টস.পিকআপস.কস্ট"] রুটে সমস্ত পিকআপ ব্যয়ের যোগফল। মডেলটিতে সংজ্ঞায়িত সমস্ত ব্যয়গুলি এখানে ট্রানজিশনঅ্যাট্রিবিউটগুলির সাথে সম্পর্কিত ব্যয় ব্যতীত বিশদভাবে প্রতিবেদন করা হয়েছে যা কেবলমাত্র 2022/01 হিসাবে সমষ্টিগত উপায়ে রিপোর্ট করা হয়েছে। |
route_total_cost | রুটের মোট ব্যয়। ব্যয় মানচিত্রে সমস্ত ব্যয়ের যোগফল। |
বিরতি
বিরতি কার্যকর করার প্রতিনিধিত্বকারী ডেটা।
| ক্ষেত্র | |
|---|---|
start_time | বিরতির শুরু সময়। |
duration | বিরতির সময়কাল। |
এনকোডেডপোলাইন
একটি পললাইনের এনকোডেড উপস্থাপনা। পললাইন এনকোডিং সম্পর্কিত আরও তথ্য এখানে পাওয়া যাবে: https://developers.google.com/maps/docamentation/utiviles/polylinealgorithm https://dewoogle.com/maps/docarctiction/javasprict/reference/geometry#encoding ।
| ক্ষেত্র | |
|---|---|
points | পললাইনের এনকোডেড পয়েন্টগুলি উপস্থাপন করে স্ট্রিং। |
উত্তরণ
রুটে দুটি ইভেন্টের মধ্যে রূপান্তর। ShipmentRoute বিবরণ দেখুন।
যদি গাড়ির কোনও start_location এবং/অথবা end_location না থাকে তবে সংশ্লিষ্ট ট্র্যাভেল মেট্রিকগুলি 0 হয়।
| ক্ষেত্র | |
|---|---|
travel_duration | এই রূপান্তরকালে ভ্রমণের সময়কাল। |
travel_distance_meters | রূপান্তর চলাকালীন দূরত্ব ভ্রমণ। |
traffic_info_unavailable | যখন ট্র্যাফিকের জন্য |
delay_duration | এই রূপান্তরটিতে প্রয়োগ করা বিলম্বের সময়কালের যোগফল। যদি কোনও হয় তবে বিলম্বটি পরবর্তী ইভেন্টের (ভিজিট বা যানবাহন শেষ) ঠিক আগে |
break_duration | এই রূপান্তরকালে বিরতিগুলির সময়কালের যোগফল, যদি থাকে। প্রতিটি বিরতির শুরুর সময় এবং সময়কাল সম্পর্কে বিশদগুলি |
wait_duration | এই রূপান্তরকালে অপেক্ষা করতে সময় ব্যয়। অপেক্ষা করার সময়কাল নিষ্ক্রিয় সময়ের সাথে মিলে যায় এবং বিরতির সময় অন্তর্ভুক্ত করে না। এছাড়াও নোট করুন যে এই অপেক্ষার সময়টি বেশ কয়েকটি অ-স্বচ্ছল ব্যবধানে বিভক্ত হতে পারে। |
total_duration | সুবিধার জন্য সরবরাহ করা রূপান্তরটির মোট সময়কাল। এটি সমান:
|
start_time | এই রূপান্তর শুরু সময়। |
route_polyline | ট্রানজিশনের সময় অনুসরণ করা রুটের এনকোডেড পললাইন উপস্থাপনা। এই ক্ষেত্রটি কেবল তখনই পপুলেটেড হয় যদি |
vehicle_loads | এই ট্রানজিশনের সময় যানবাহন লোড হয়, প্রতিটি ধরণের জন্য যা এই গাড়ির প্রথম স্থানান্তরের সময় লোডগুলি হ'ল যানবাহনের রুটের প্রারম্ভিক লোড। তারপরে, প্রতিটি দেখার পরে, ভিজিটটি পিকআপ বা ডেলিভারি ছিল কিনা তার উপর নির্ভর করে ভিজিটের |
যানবাহন লোড
প্রদত্ত ধরণের জন্য রুট বরাবর কোনও পর্যায়ে গাড়ির আসল লোডের প্রতিবেদন করে (দেখুন Transition.vehicle_loads )।
| ক্ষেত্র | |
|---|---|
amount | প্রদত্ত ধরণের জন্য গাড়িতে লোডের পরিমাণ। লোডের এককটি সাধারণত প্রকারের দ্বারা নির্দেশিত হয়। |
ভিজিট করুন
একটি রুট চলাকালীন একটি দর্শন করা হয়েছিল। এই ভিজিট একটি পিকআপ বা Shipment সরবরাহের সাথে মিলে যায়।
| ক্ষেত্র | |
|---|---|
shipment_index | উত্স |
is_pickup | যদি সত্য হয় তবে দর্শনটি |
visit_request_index | |
start_time | সময় যেখানে দর্শন শুরু হয়। নোট করুন যে যানটি ভিজিটের স্থানে এর চেয়ে আগে আসতে পারে। সময়গুলি |
load_demands | চালানের যোগফল এবং ভিজিট অনুরোধ |
detour | ভিজিটের আগে রুটে শিপমেন্টগুলি পরিদর্শন করার কারণে এবং সময় উইন্ডোজ দ্বারা প্ররোচিত সম্ভাব্য অপেক্ষার সময়টিতে অতিরিক্ত ডিটোর সময়। যদি ভিজিটটি ডেলিভারি হয় তবে ডিটোরটি সংশ্লিষ্ট পিকআপ ভিজিট থেকে গণনা করা হয় এবং এর সমান: অন্যথায়, এটি যানবাহন |
shipment_label | সংশ্লিষ্ট |
visit_label | সংশ্লিষ্ট |
শিপমেন্ট টাইপিংকম্প্যাটিবিলিটি
তাদের চালান_ টাইপের উপর নির্ভর করে চালানের মধ্যে অসঙ্গতিগুলি নির্দিষ্ট করে। The appearance of incompatible shipments on the same route is restricted based on the incompatibility mode.
| ক্ষেত্র | |
|---|---|
types[] | List of incompatible types. Two shipments having different |
incompatibility_mode | Mode applied to the incompatibility. |
IncompatibilityMode
Modes defining how the appearance of incompatible shipments are restricted on the same route.
| Enums | |
|---|---|
INCOMPATIBILITY_MODE_UNSPECIFIED | Unspecified incompatibility mode. This value should never be used. |
NOT_PERFORMED_BY_SAME_VEHICLE | In this mode, two shipments with incompatible types can never share the same vehicle. |
NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY | For two shipments with incompatible types with the
|
ShipmentTypeRequirement
Specifies requirements between shipments based on their shipment_type. The specifics of the requirement are defined by the requirement mode.
| ক্ষেত্র | |
|---|---|
required_shipment_type_alternatives[] | List of alternative shipment types required by the |
dependent_shipment_types[] | All shipments with a type in the NOTE: Chains of requirements such that a |
requirement_mode | Mode applied to the requirement. |
RequirementMode
Modes defining the appearance of dependent shipments on a route.
| Enums | |
|---|---|
REQUIREMENT_MODE_UNSPECIFIED | Unspecified requirement mode. This value should never be used. |
PERFORMED_BY_SAME_VEHICLE | In this mode, all "dependent" shipments must share the same vehicle as at least one of their "required" shipments. |
IN_SAME_VEHICLE_AT_PICKUP_TIME | With the A "dependent" shipment pickup must therefore have either:
|
IN_SAME_VEHICLE_AT_DELIVERY_TIME | Same as before, except the "dependent" shipments need to have a "required" shipment on their vehicle at the time of their delivery . |
SkippedShipment
Specifies details of unperformed shipments in a solution. For trivial cases and/or if we are able to identify the cause for skipping, we report the reason here.
| ক্ষেত্র | |
|---|---|
index | The index corresponds to the index of the shipment in the source |
label | Copy of the corresponding |
reasons[] | A list of reasons that explain why the shipment was skipped. See comment above |
কারণ
If we can explain why the shipment was skipped, reasons will be listed here. If the reason is not the same for all vehicles, reason will have more than 1 element. A skipped shipment cannot have duplicate reasons, ie where all fields are the same except for example_vehicle_index . উদাহরণ:
reasons {
code: DEMAND_EXCEEDS_VEHICLE_CAPACITY
example_vehicle_index: 1
example_exceeded_capacity_type: "Apples"
}
reasons {
code: DEMAND_EXCEEDS_VEHICLE_CAPACITY
example_vehicle_index: 3
example_exceeded_capacity_type: "Pears"
}
reasons {
code: CANNOT_BE_PERFORMED_WITHIN_VEHICLE_DISTANCE_LIMIT
example_vehicle_index: 1
}
The skipped shipment is incompatible with all vehicles. The reasons may be different for all vehicles but at least one vehicle's "Apples" capacity would be exceeded (including vehicle 1), at least one vehicle's "Pears" capacity would be exceeded (including vehicle 3) and at least one vehicle's distance limit would be exceeded (including vehicle 1).
| ক্ষেত্র | |
|---|---|
code | Refer to the comments of Code. |
example_exceeded_capacity_type | If the reason code is |
example_vehicle_index | If the reason is related to a shipment-vehicle incompatibility, this field provides the index of one relevant vehicle. |
কোড
Code identifying the reason type. The order here is meaningless. In particular, it gives no indication of whether a given reason will appear before another in the solution, if both apply.
| Enums | |
|---|---|
CODE_UNSPECIFIED | This should never be used. |
NO_VEHICLE | There is no vehicle in the model making all shipments infeasible. |
DEMAND_EXCEEDS_VEHICLE_CAPACITY | The demand of the shipment exceeds a vehicle's capacity for some capacity types, one of which is example_exceeded_capacity_type . |
CANNOT_BE_PERFORMED_WITHIN_VEHICLE_DISTANCE_LIMIT | The minimum distance necessary to perform this shipment, ie from the vehicle's Note that for this computation we use the geodesic distances. |
CANNOT_BE_PERFORMED_WITHIN_VEHICLE_DURATION_LIMIT | The minimum time necessary to perform this shipment, including travel time, wait time and service time exceeds the vehicle's Note: travel time is computed in the best-case scenario, namely as geodesic distance x 36 m/s (roughly 130 km/hour). |
CANNOT_BE_PERFORMED_WITHIN_VEHICLE_TRAVEL_DURATION_LIMIT | Same as above but we only compare minimum travel time and the vehicle's travel_duration_limit . |
CANNOT_BE_PERFORMED_WITHIN_VEHICLE_TIME_WINDOWS | The vehicle cannot perform this shipment in the best-case scenario (see CANNOT_BE_PERFORMED_WITHIN_VEHICLE_DURATION_LIMIT for time computation) if it starts at its earliest start time: the total time would make the vehicle end after its latest end time. |
VEHICLE_NOT_ALLOWED | The allowed_vehicle_indices field of the shipment is not empty and this vehicle does not belong to it. |
টাইম উইন্ডো
Time windows constrain the time of an event, such as the arrival time at a visit, or the start and end time of a vehicle.
Hard time window bounds, start_time and end_time , enforce the earliest and latest time of the event, such that start_time <= event_time <= end_time . The soft time window lower bound, soft_start_time , expresses a preference for the event to happen at or after soft_start_time by incurring a cost proportional to how long before soft_start_time the event occurs. The soft time window upper bound, soft_end_time , expresses a preference for the event to happen at or before soft_end_time by incurring a cost proportional to how long after soft_end_time the event occurs. start_time , end_time , soft_start_time and soft_end_time should be within the global time limits (see ShipmentModel.global_start_time and ShipmentModel.global_end_time ) and should respect:
0 <= `start_time` <= `end_time` and
0 <= `start_time` <= `soft_start_time` and
0 <= `soft_end_time` <= `end_time`.
| ক্ষেত্র | |
|---|---|
start_time | The hard time window start time. If unspecified it will be set to |
end_time | The hard time window end time. If unspecified it will be set to |
soft_start_time | The soft start time of the time window. |
soft_end_time | The soft end time of the time window. |
cost_per_hour_before_soft_start_time | A cost per hour added to other costs in the model if the event occurs before soft_start_time, computed as: This cost must be positive, and the field can only be set if soft_start_time has been set. |
cost_per_hour_after_soft_end_time | A cost per hour added to other costs in the model if the event occurs after This cost must be positive, and the field can only be set if |
TransitionAttributes
Specifies attributes of transitions between two consecutive visits on a route. Several TransitionAttributes may apply to the same transition: in that case, all extra costs add up and the strictest constraint or limit applies (following natural "AND" semantics).
| ক্ষেত্র | |
|---|---|
src_tag | Tags defining the set of (src->dst) transitions these attributes apply to. A source visit or vehicle start matches iff its |
excluded_src_tag | See |
dst_tag | A destination visit or vehicle end matches iff its |
excluded_dst_tag | See |
cost | 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. |
cost_per_kilometer | Specifies a cost per kilometer applied to the distance traveled while performing this transition. It adds up to any |
distance_limit | Specifies a limit on the distance traveled while performing this transition. As of 2021/06, only soft limits are supported. |
delay | Specifies a delay incurred when performing this transition. This delay always occurs after finishing the source visit and before starting the destination visit. |
যানবাহন
Models a vehicle in a shipment problem. Solving a shipment problem will build a route starting from start_location and ending at end_location for this vehicle. A route is a sequence of visits (see ShipmentRoute ).
| ক্ষেত্র | |
|---|---|
display_name | The user-defined display name of the vehicle. It can be up to 63 characters long and may use UTF-8 characters. |
travel_mode | The travel mode which affects the roads usable by the vehicle and its speed. See also |
route_modifiers | A set of conditions to satisfy that affect the way routes are calculated for the given vehicle. |
start_location | Geographic location where the vehicle starts before picking up any shipments. If not specified, the vehicle starts at its first pickup. If the shipment model has duration and distance matrices, |
start_waypoint | Waypoint representing a geographic location where the vehicle starts before picking up any shipments. If neither |
end_location | Geographic location where the vehicle ends after it has completed its last |
end_waypoint | Waypoint representing a geographic location where the vehicle ends after it has completed its last |
start_tags[] | Specifies tags attached to the start of the vehicle's route. Empty or duplicate strings are not allowed. |
end_tags[] | Specifies tags attached to the end of the vehicle's route. Empty or duplicate strings are not allowed. |
start_time_windows[] | Time windows during which the vehicle may depart its start location. They must be within the global time limits (see Time windows belonging to the same repeated field must be disjoint, ie no time window can overlap with or be adjacent to another, and they must be in chronological order. |
end_time_windows[] | Time windows during which the vehicle may arrive at its end location. They must be within the global time limits (see Time windows belonging to the same repeated field must be disjoint, ie no time window can overlap with or be adjacent to another, and they must be in chronological order. |
unloading_policy | Unloading policy enforced on the vehicle. |
load_limits | Capacities of the vehicle (weight, volume, # of pallets for example). The keys in the map are the identifiers of the type of load, consistent with the keys of the |
cost_per_hour | Vehicle costs: all costs add up and must be in the same unit as Cost per hour of the vehicle route. This cost is applied to the total time taken by the route, and includes travel time, waiting time, and visit time. Using |
cost_per_traveled_hour | Cost per traveled hour of the vehicle route. This cost is applied only to travel time taken by the route (ie, that reported in |
cost_per_kilometer | Cost per kilometer of the vehicle route. This cost is applied to the distance reported in the |
fixed_cost | Fixed cost applied if this vehicle is used to handle a shipment. |
used_if_route_is_empty | This field only applies to vehicles when their route does not serve any shipments. It indicates if the vehicle should be considered as used or not in this case. If true, the vehicle goes from its start to its end location even if it doesn't serve any shipments, and time and distance costs resulting from its start --> end travel are taken into account. Otherwise, it doesn't travel from its start to its end location, and no |
route_duration_limit | Limit applied to the total duration of the vehicle's route. In a given |
travel_duration_limit | Limit applied to the travel duration of the vehicle's route. In a given |
route_distance_limit | Limit applied to the total distance of the vehicle's route. In a given |
extra_visit_duration_for_visit_type | Specifies a map from visit_types strings to durations. The duration is time in addition to If a visit request has multiple types, a duration will be added for each type in the map. |
break_rule | Describes the break schedule to be enforced on this vehicle. If empty, no breaks will be scheduled for this vehicle. |
label | Specifies a label for this vehicle. This label is reported in the response as the |
ignore | If true, If a shipment is performed by an ignored vehicle in If a shipment is performed by an ignored vehicle in |
travel_duration_multiple | 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 WARNING: Travel times will be rounded to the nearest second after this multiple is applied but before performing any numerical operations, thus, a small multiple may result in a loss of precision. See also |
DurationLimit
A limit defining a maximum duration of the route of a vehicle. It can be either hard or soft.
When a soft limit field is defined, both the soft max threshold and its associated cost must be defined together.
| ক্ষেত্র | |
|---|---|
max_duration | A hard limit constraining the duration to be at most max_duration. |
soft_max_duration | 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, |
quadratic_soft_max_duration | 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 defined, |
cost_per_hour_after_soft_max | Cost per hour incurred if the The cost must be nonnegative. |
cost_per_square_hour_after_quadratic_soft_max | Cost per square hour incurred if the The additional cost is 0 if the duration is under the threshold, otherwise the cost depends on the duration as follows: The cost must be nonnegative. |
LoadLimit
Defines a load limit applying to a vehicle, eg "this truck may only carry up to 3500 kg". See load_limits .
| ক্ষেত্র | |
|---|---|
soft_max_load | A soft limit of the load. See |
cost_per_unit_above_soft_max | If the load ever exceeds |
start_load_interval | The acceptable load interval of the vehicle at the start of the route. |
end_load_interval | The acceptable load interval of the vehicle at the end of the route. |
max_load | The maximum acceptable amount of load. |
ব্যবধান
Interval of acceptable load amounts.
| ক্ষেত্র | |
|---|---|
min | A minimum acceptable load. Must be ≥ 0. If they're both specified, |
max | A maximum acceptable load. Must be ≥ 0. If unspecified, the maximum load is unrestricted by this message. If they're both specified, |
TravelMode
Travel modes which can be used by vehicles.
These should be a subset of the Google Maps Platform Routes Preferred API travel modes, see: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/Shared.Types/RouteTravelMode .
| Enums | |
|---|---|
TRAVEL_MODE_UNSPECIFIED | Unspecified travel mode, equivalent to DRIVING . |
DRIVING | Travel mode corresponding to driving directions (car, ...). |
WALKING | Travel mode corresponding to walking directions. |
UnloadingPolicy
Policy on how a vehicle can be unloaded. Applies only to shipments having both a pickup and a delivery.
Other shipments are free to occur anywhere on the route independent of unloading_policy .
| Enums | |
|---|---|
UNLOADING_POLICY_UNSPECIFIED | Unspecified unloading policy; deliveries must just occur after their corresponding pickups. |
LAST_IN_FIRST_OUT | Deliveries must occur in reverse order of pickups |
FIRST_IN_FIRST_OUT | Deliveries must occur in the same order as pickups |
ওয়েপয়েন্ট
Encapsulates a waypoint. Waypoints mark arrival and departure locations of VisitRequests, and start and end locations of Vehicles.
| ক্ষেত্র | |
|---|---|
side_of_road | ঐচ্ছিক। Indicates that the location of this waypoint is meant to have a preference for the vehicle to stop at a particular side of road. When you set this value, the route will pass through the location so that the vehicle can stop at the side of road that the location is biased towards from the center of the road. This option doesn't work for the 'WALKING' travel mode. |
Union field location_type . Different ways to represent a location. location_type can be only one of the following: | |
location | A point specified using geographic coordinates, including an optional heading. |
place_id | The POI Place ID associated with the waypoint. |