במדריך הזה מוצגים שימושים אפשריים במאפייני מעבר. הוא יסביר איך ליצור מודלים של תרחישים מהעולם האמיתי באמצעות שני תרחישים לדוגמה: שילוב של זמן החנייה במסלולים שעברו אופטימיזציה, והבטחה שכל מסלול יסתיים בביקור במיקום ספציפי.
לפני שמתחילים
משתמשים במאפייני מעבר כדי להוסיף עלויות ועיכובים ספציפיים למודל למעברים מסוימים במסלולים שעברו אופטימיזציה. העלויות והעיכובים האלה מתווספים למשך המעבר ולעלויות שמחושבות מנתוני המפה על סמך הפרמטרים של הרכב שבו נעשה שימוש.
מעבר הוא קטע המסלול שמקשר בין מיקום אחד למיקום הבא.
מיקום מתייחס לאחת מהנקודות הבאות במסלול של רכב:
- נקודת ההתחלה של המסלול.
- עצירה שבה מתבצע איסוף או משלוח.
- נקודת הסיום של המסלול.
כדי להגדיר את כל מאפייני המעבר של המודל, מוסיפים אותם לרשימה ShipmentModel.transition_attributes
.
כל רכיב ברשימה מגדיר קבוצה אחת של מאפייני מעבר, והוא מותאם למעברים במסלולים באמצעות תגים במיקום ההתחלה ובמיקום הסיום של המעבר. מידע נוסף על מאפייני מעבר זמין במאמר בנושא TransitionAttributes
.
הדגמה של תרחישים מהעולם האמיתי
בקטע הזה מוצגות שתי דוגמאות קצרות להטמעה של מגבלות עסקיות מהעולם האמיתי באמצעות מאפייני מעבר.
שיריון זמן לחנייה
בתרחיש הזה, הנהג צריך להחנות את הרכב לפני שהוא יכול להגיע למיקום א'. מיקום ב' נמצא בקרבת מקום, והנהג יכול להשתמש באותו מקום חנייה בשני הביקורים. אם הנהג מגיע לנקודה ב' מיד אחרי נקודה א', הוא חוסך זמן כי הוא לא צריך לצאת ממקום החנייה ולהחנות את הרכב שוב. ב-Route Optimization API, אפשר להשתמש במאפייני מעבר כדי להוסיף זמן חנייה רק כשהנהג עובר ממקום חנייה אחד למקום חנייה אחר.
כשמבצעים מודלינג של זמן החנייה בנפרד ממשך הביקור, המסלולים שבהם הביקורים משתמשים באותו מקום חנייה נמשכים פחות זמן. כך המודל יהיה מדויק יותר, והאופטימיזציה תעדיף מסלולים שבהם הביקורים מקובצים.
כדי לעשות את זה בבקשה ל-Route Optimization API:
משתמשים ב-
VisitRequest.duration
רק למשך הזמן שנדרש לביצוע הביקור. לדוגמה, כדי למסור את החבילה ולאסוף חתימה מהלקוח.לכל מקום חנייה שונה שמשמש במודל, צריך להשתמש בתג חדש שלא משמש לשום דבר אחר במודל, לדוגמה
PARKING_123
.מוסיפים את התג הזה לרכיבים הבאים:
VisitRequest.tags
בכל בקשות הביקור שמשתמשות במקום החניה הזה.
Vehicle.start_tags
אם הרכב מתחיל את המסלול שלו במקום החניה הזה.Vehicle.end_tags
אם הרכב מתחיל את המסלול ומסיים אותו במקום החנייה הזה.
לכל תג חנייה חדש, מוסיפים רשומה ל-
ShipmentModel.transition_attributes
כדי להוסיף עיכוב לחנייה כשמגיעים ממקום חנייה אחר, באופן הבא:מגדירים את
TransitionAttributes.excluded_src_tag
ואתTransitionAttributes.dst_tag
לערךPARKING_123
.מגדירים את
TransitionAttributes.delay
לזמן שנדרש לחניית הרכב.
לדוגמה, אם התג של מיקום הוא
PARKING_123
ועוברות 150 שניות עד שהרכב חונה, מוסיפים את הרשומה הבאה אלShipmentModel.transition_attributes
:{ "excluded_src_tag": "PARKING_123", "dst_tag": "PARKING_123", "delay": "150s" }
ניקוי חובה בסוף המסלול
בתרחיש הזה, צריך לנקות את הרכב בסוף המסלול, עם האילוצים הנוספים הבאים:
- הניקוי מתבצע במתקן ניקוי ייעודי לפני שהרכב מוחזר למחסן. המסלול שעבר אופטימיזציה משתמש במתקן הניקוי הטוב ביותר על סמך המיקום שלו והמיקומים של האיסופים והמשלוחים שהרכב מבצע.
- לאחר הניקוי, הרכב לא יכול לבצע איסופים או משלוחים נוספים.
- הזמן שנדרש לנהיגה לשם ולניקוי הרכב נספר במסגרת שעות העבודה של הנהג, והוא צריך להיכלל במשך הזמן המקסימלי של המסלול.
כדי לעמוד בדרישה הזו, צריך לאפשר רק מסלולים ריקים או מסלולים שהביקור האחרון בהם הוא במתקן ניקוי. ב-Route Optimization API, עושים זאת על ידי איסור מעברים לנקודת הדרך הסופית של המסלול מכל מיקום, למעט ממתק הניקוי או מנקודת ההתחלה של המסלול:
- בוחרים שני תגים חדשים שלא נמצאים בשימוש בשום מקום במודל, לדוגמה
CLEANED
ו-ROUTE_END
. האפשרות הראשונה היא למיקומים שבהם הרכב נקי או הופך לנקי, והאפשרות השנייה היא לסיום המסלול. - לכל רכב, מוסיפים משלוח חדש מסוג 'משלוח בלבד' שמייצג את הביקור במתקן ניקוי, עם המאפיינים הבאים:
- כל מיקום של מתקן ניקוי צריך להיות מיוצג כבקשה לביקור לצורך משלוח.
- מוסיפים
CLEANED
אלVisitRequest.tags
של כל בקשת ביקור במשלוח של מתקן הניקוי. הוא מציין שכלי רכב שיוצא מהמיקום הזה הוא נקי. בקשות אחרות לביקור במודל לא צריכות להשתמש בתג הזה, כדי שהרכב ייחשב כ'לא נקי' כשהוא עוזב אותן. - כדי לאפשר לאופטימיזציה לדלג על המשלוח הזה אם הרכב לא נמצא בשימוש, צריך להגדיר את הערך של
penalty_cost
למספר קטן.
לכל רכב, מוסיפים
CLEANED
ל-Vehicle.start_tags
. המאפיין הזה משמש לסימון הרכב כנקי לפני שהוא מבצע איסופים או משלוחים, בהנחה שהוא נוקה בסוף יום העבודה הקודם, ומאפשר לו לעבור מנקודת הציון הראשונה ישירות לנקודת הציון האחרונה. גם אם מסלולים כאלה לא קורים בפועל, התרחיש הזה עוזר לאופטימיזציה לחפש מסלולים אופטימליים בצורה יעילה יותר.לכל רכב, מוסיפים
ROUTE_END
ל-Vehicle.end_tags
.מוסיפים רשומה חדשה ל-
ShipmentModel.transition_attributes
שבה נאסר על כלי רכב להגיע לציון הדרך האחרון של כלי הרכב אם הם לא נקיים, עם המאפיינים הבאים:מגדירים את
TransitionAttributes.excluded_src_tag
לערךCLEANED
.מגדירים את
TransitionAttributes.dst_tag
לערךROUTE_END
.מגדירים את
TransitionAttributes.delay
לערך גבוה. אם משך העיכוב ארוך יותר ממשך המסלול המקסימלי, האופטימיזציה לא תוכל להשתמש במעבר הזה במסלול.
לדוגמה, אם קנה המידה של הזמן במודל הוא יום עבודה אחד, אפשר להשתמש בעיכוב של 24 שעות (86,400 שניות) כדי למנוע את המעבר לסוף המסלול מכל מקום, למעט מתקן ניקוי ותחילת המסלול:
{ "excluded_src_tag": "CLEANED", "dst_tag": "ROUTE_END", "delay": "86400s" }
איך בוחרים בין עיכובים ועלויות
הבחירה בין עיכובים לעלויות תלויה באופי של הלוגיקה העסקית והמגבלות שהוטמעו. ההגדרה
TransitionAttributes.delay
מתאימה במיוחד להטמעה של הגבלות מחמירות או לביטוי של פשרה מבחינת
הזמן שמוקדש.
TransitionAttributes.cost
מתאים יותר כשמיישמים העדפות גמישות או פשרות שמוצגות כעלות נוספת. אתם יכולים לשלב בין עיכובים ועלויות באופן שרירותי כשמדובר בזמן שהושקע ובעלות.
בדוגמה של ניקוי הרכב נעשה שימוש בהשהיה ארוכה מאוד, כי ניקוי הרכב בסוף המסלול הוא דרישה מחייבת, וההשהיה הארוכה מונעת מהכלי לאופטימיזציה להתעלם מהדרישה. אם מגדירים רק עלות, יכול להיות שהכלי לא יבצע את הניקוי אם הוא ימצא דרך לפצות על העלות במקום אחר, למשל על ידי ביצוע יותר משלוחים בזמן ש"נחסך" מאי-ניקוי הרכב.
בדוגמה של החנייה נעשה שימוש בעיכוב קצר שמתאים לזמן הנוסף שנדרש לחניית הרכב. אפשר גם להשתמש במאפיין עלויות בשילוב עם מאפיין העיכובים, אם הנהג עוצר בחניון בתשלום.
איך מוסיפים מאפיין מעבר שתואם לכל בקשות הביקור
בדוגמאות שלמעלה נעשה שימוש במאפייני מעבר שתואמים למיקומים עם תג מסוים, או למיקומים בלי התג. אבל מה קורה אם צריך להוסיף מאפייני מעבר שרלוונטיים לכל המעברים?
אי אפשר פשוט להשמיט את התגים, כי כל הודעת TransitionAttributes
חייבת לכלול אחד מהתגים TransitionAttributes.src_tag
ו-TransitionAttributes.excluded_src_tag
, ואחד מהתגים TransitionAttributes.dst_tag
ו-TransitionAttributes.excluded_dst_tag
.
עם זאת, אפשר להתאים את כל התגים על ידי הגדרת TransitionAttributes.excluded_src_tag
או TransitionAttributes.excluded_dst_tag
לתג שלא נמצא בשימוש בשום מקום במודל. התנאי הזה יתאים לכל המיקומים שלא הוגדר להם התג הזה, אבל מכיוון שבחרתם בכוונה תג שלא נמצא בשימוש באף מיקום, מאפייני המעבר האלה יתאימו לכל המיקומים.