Package google.maps.routeoptimization.v1

int32

מספר המשלוחים שבוצעו. חשוב לזכור שצמד של איסוף ומסירה נספר רק פעם אחת.

Duration

משך הנסיעה הכולל במסלול או בפתרון.

Duration

משך ההמתנה הכולל במסלול או בפתרון.

Duration

משך העיכוב הכולל במסלול או בפתרון.

Duration

משך ההפסקה הכולל במסלול או בפתרון.

Duration

משך הביקור הכולל במסלול או בפתרון.

Duration

משך הזמן הכולל צריך להיות שווה לסכום של כל משכי הזמן שלמעלה. במסלולים, הוא תואם גם ל:

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

מרחק הנסיעה הכולל של מסלול או פתרון.

map<string, VehicleLoad>

העומס המקסימלי שהושג לאורך כל המסלול (או הפתרון), לכל אחת מהכמויות במסלול הזה (או הפתרון), מחושב כערך המקסימלי בכל Transition.vehicle_loads (או ShipmentRoute.metrics.max_loads.

int32

מספר המשלוחים שבוצעו בפועל.

ניסיוני: ההתנהגות או הקיום של השדה הזה עשויים להשתנות בעתיד.

double

סכום ה-Shipment.penalty_cost של המשלוחים שבוצעו.

ניסיוני: ההתנהגות או הקיום של השדה הזה עשויים להשתנות בעתיד.

string

חובה. פרויקט היעד והמיקום שבו מתבצעת הקריאה.

פורמט:

• projects/{project-id}
• projects/{project-id}/locations/-

ערכי {location-id} אזוריים לא נתמכים.

AsyncModelConfig

חובה. מידע על קלט/פלט של כל מודל רכישה, כמו נתיבי קבצים ופורמטי נתונים.

string

אופציונלי. שם המודל שהוגדר על ידי המשתמש, יכול לשמש ככינוי על ידי המשתמשים כדי לעקוב אחר המודלים.

InputConfig

חובה. מידע על מודל הקלט.

OutputConfig

חובה. פרטי מיקום הפלט הרצוי.

BreakRequest

רצף של הפסקות. ההודעה BreakRequest.

FrequencyConstraint

יכול להיות שיחולו כמה FrequencyConstraint. כל התנאים צריכים להתקיים ב-BreakRequest של ה-BreakRule הזה. FrequencyConstraint.

Timestamp

חובה. הגבול התחתון (כולל) של תחילת ההפסקה.

Timestamp

חובה. הגבול העליון (כולל) של תחילת ההפסקה.

Duration

חובה. משך הזמן המינימלי של ההפסקה. הערך חייב להיות חיובי.

Duration

חובה. משך ההפסקה המינימלי לאילוץ הזה. לא שלילי. לתיאור של FrequencyConstraint.

Duration

חובה. משך הזמן המקסימלי המותר לכל מרווח זמן במסלול שלא כולל הפסקה של duration >= min_break_duration, לפחות באופן חלקי. הערך חייב להיות חיובי.

int64

מגבלה קשיחה שמגבילה את המרחק ל-max_meters לכל היותר. הסף חייב להיות מספר חיובי.

int64

מגבלה גמישה שלא אוכפת מגבלת מרחק מקסימלי, אבל אם חורגים ממנה, היא מוסיפה עלות לעלויות אחרות שמוגדרות במודל, באותה יחידה.

אם מגדירים את soft_max_meters, הערך צריך להיות קטן מ-max_meters ולא שלילי.

double

העלות לקילומטר שנצברה, עד soft_max_meters, לפי הנוסחה:

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

העלות הזו לא נתמכת ב-route_distance_limit.

double

העלות לקילומטר אם המרחק חורג מהמגבלה של soft_max_meters. העלות הנוספת היא 0 אם המרחק קטן מהמגבלה, אחרת הנוסחה שמשמשת לחישוב העלות היא:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

העלות לא יכולה להיות שלילית.

string

חובה. URI של Google Cloud Storage.

string

חובה. ‫URI של אובייקט ב-Google Cloud Storage בפורמט gs://bucket/path/to/object.

ShipmentRoute

המסלולים של הפתרון שצריך להוסיף. יכול להיות שחלק מהמסלולים יושמטו מהפתרון המקורי. המסלולים והמשלוחים שדילגתם עליהם צריכים לעמוד בהנחות הבסיסיות לגבי תקינות שמופיעות ב-injected_first_solution_routes.

SkippedShipment

משלוחים שדילגו עליהם בפתרון שרוצים להוסיף. יכול להיות שחלק מהם יושמטו מהפתרון המקורי. מעיינים בשדה routes.

ConstraintRelaxation

לאפס קבוצות של כלי רכב או יותר, מציין מתי ובאיזו מידה להקל על האילוצים. אם השדה הזה ריק, כל המסלולים הלא ריקים של כלי הרכב מוגבלים באופן מלא.

Relaxation

כל ההקלות באילוצי הביקורים שיחולו על ביקורים במסלולים עם כלי רכב ב-vehicle_indices.

int32

מציין את האינדקסים של כלי הרכב שעליהם חל אילוץ הביקור relaxations. אם לא תציינו ערך בשדה הזה, הוא ייחשב כברירת המחדל והערכים של relaxations יחולו על כל הרכבים שלא צוינו בערכים אחרים של constraint_relaxations. יכולה להיות רק ברירת מחדל אחת, כלומר מותר להשאיר ריק רק שדה אחד של הקלה באילוצים vehicle_indices. אפשר לציין אינדקס רכב רק פעם אחת, גם אם יש כמה רכיבי constraint_relaxations.

אינדקס הרכב ממופה כמו ShipmentRoute.vehicle_index, אם interpret_injected_solutions_using_labels נכון (ראו הערה fields).

Level

רמת ההקלה באילוצים שחלה כשהתנאים ב-threshold_time או אחריו וגם לפחות threshold_visit_count מתקיימים.

Timestamp

השעה שבה או שאחריה אפשר להחיל את ההקלה level.

int32

מספר הביקורים שבהם או שאחריהם אפשר להחיל את ההקלה level. אם הערך של threshold_visit_count הוא 0 (או לא מוגדר), יכול להיות שהערך של level יחול ישירות בתחילת הרכב.

אם הערך הוא route.visits_size() + 1, יכול להיות שהערך של level יחול רק על החלק האחורי של הרכב. אם הוא גדול מ-route.visits_size() + 1, המדיניות level לא חלה בכלל על המסלול הזה.

DataFormat

חובה. פורמט נתוני הקלט.

GcsSource

מיקום ב-Google Cloud Storage. האובייקט חייב להיות אובייקט יחיד (קובץ).

LatLng

הקואורדינטות הגיאוגרפיות של נקודת הדרך.

int32

כיוון המצפן שמשויך לכיוון זרימת התנועה. הערך הזה משמש כדי לציין את צד הכביש שבו צריך להשתמש לאיסוף ולהורדה. ערכי הכיוון יכולים להיות בין 0 ל-360, כאשר 0 מציין כיוון צפונה, 90 מציין כיוון מזרחה וכו'.

string

חובה. פרויקט או מיקום יעד לביצוע שיחה.

פורמט:

• projects/{project-id}
• projects/{project-id}/locations/-

ערכי {location-id} אזוריים לא נתמכים.

Duration

אם מגדירים את הזמן הקצוב לתפוגה, השרת מחזיר תשובה לפני שפרק הזמן הקצוב לתפוגה חולף או לפני שמגיע המועד האחרון של השרת לבקשות סנכרוניות, המוקדם מביניהם.

בבקשות לא סנכרוניות, השרת ייצור פתרון (אם אפשר) לפני שזמן הקצוב לתפוגה יחלוף.

ShipmentModel

מודל המשלוח שצריך לפתור.

SolvingMode

כברירת מחדל, מצב הפתרון הוא DEFAULT_SOLVE (0).

SearchMode

מצב החיפוש ששימש לפתרון הבקשה.

ShipmentRoute

הנחיית אלגוריתם האופטימיזציה למציאת פתרון ראשון שדומה לפתרון קודם.

המודל מוגבל כשהפתרון הראשון נוצר. כל המשלוחים שלא בוצעו במסלול מסוים נדלגים באופן משתמע בפתרון הראשון, אבל יכול להיות שהם יבוצעו בפתרונות הבאים.

הפתרון צריך לעמוד בכמה הנחות בסיסיות לגבי תוקף:

• בכל המסלולים, הערך של vehicle_index חייב להיות בטווח ולא להיות כפול.
• בכל הביקורים, הערכים של shipment_index ו-visit_request_index חייבים להיות בטווח.
• אפשר להפנות למשלוח רק במסלול אחד.
• האיסוף של משלוח מסוג איסוף-מסירה חייב להתבצע לפני המסירה.
• מותר לבצע רק חלופה אחת של איסוף או חלופה אחת של מסירה של משלוח.
• בכל המסלולים, הזמנים עולים (כלומר, vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• אפשר לבצע משלוח רק ברכב שמותר להשתמש בו. כלי רכב מותר אם Shipment.allowed_vehicle_indices ריק או אם vehicle_index שלו כלול ב-Shipment.allowed_vehicle_indices.

אם הפתרון שהוזרק לא אפשרי, לא בהכרח תוחזר שגיאת אימות, ויכול להיות שתוחזר שגיאה שמציינת שהפתרון לא אפשרי.

InjectedSolutionConstraint

להגביל את אלגוריתם האופטימיזציה כדי למצוא פתרון סופי שדומה לפתרון קודם. לדוגמה, אפשר להשתמש בזה כדי להקפיא חלקים ממסלולים שכבר הושלמו או שצריך להשלים אבל אסור לשנות.

אם הפתרון שהוזרק לא אפשרי, לא בהכרח תוחזר שגיאת אימות, ויכול להיות שתוחזר שגיאה שמציינת שהפתרון לא אפשרי.

ShipmentRoute

אם השדה לא ריק, המסלולים שצוינו ירועננו בלי לשנות את רצף הביקורים או זמני הנסיעה שלהם: רק פרטים אחרים יעודכנו. הפעולה הזו לא פותרת את המודל.

החל מנובמבר 2020, השדה הזה מאכלס רק את הקווים הפוליגוניים של מסלולים לא ריקים, ודורש שהערך של populate_polylines יהיה True.

יכול להיות שהשדות route_polyline של המסלולים שהועברו לא תואמים למסלול transitions.

אסור להשתמש בשדה הזה יחד עם injected_first_solution_routes או injected_solution_constraint.

ל-Shipment.ignore ול-Vehicle.ignore אין השפעה על ההתנהגות. הקווים הפוליגוניים עדיין מאוכלסים בין כל הביקורים בכל המסלולים הלא ריקים, גם אם המערכת מתעלמת מהמשלוחים או מכלי הרכב הקשורים.

bool

אם הערך הוא True:

• משתמש ב-ShipmentRoute.vehicle_label במקום ב-vehicle_index כדי להתאים מסלולים בפתרון שהוזרק לכלי רכב בבקשה. עושה שימוש חוזר במיפוי של ShipmentRoute.vehicle_index המקורי ל-ShipmentRoute.vehicle_index החדש כדי לעדכן את ConstraintRelaxation.vehicle_indices אם הוא לא ריק, אבל המיפוי חייב להיות חד-משמעי (כלומר, כמה ShipmentRoute לא יכולים לחלוק את אותו vehicle_index מקורי).
• משתמש ב-ShipmentRoute.Visit.shipment_label במקום ב-shipment_index כדי להתאים בין הביקורים בפתרון שהוזרק לבין המשלוחים בבקשה.
• משתמש ב-SkippedShipment.label במקום ב-SkippedShipment.index כדי להתאים בין משלוחים שדילגו עליהם בפתרון שהוזרק לבין משלוחים בבקשה.

הפרשנות הזו חלה על השדות injected_first_solution_routes,‏ injected_solution_constraint ו-refresh_details_routes. אפשר להשתמש בו כשאינדקסים של משלוחים או כלי רכב בבקשה השתנו מאז שהפתרון נוצר, אולי כי משלוחים או כלי רכב הוסרו מהבקשה או נוספו אליה.

אם הערך הוא True, תוויות בקטגוריות הבאות יכולות להופיע לכל היותר פעם אחת בקטגוריה שלהן:

• Vehicle.label בבקשה,
• Shipment.label בבקשה,
• ShipmentRoute.vehicle_label בתמיסה המוזרקת;
• ‫SkippedShipment.label ו-ShipmentRoute.Visit.shipment_label בפתרון שהוזרק (חוץ מזוגות של ביקורי איסוף/מסירה, שבהם shipment_label צריך להופיע פעמיים).

אם vehicle_label בפתרון שהוזרק לא תואם לרכב בבקשה, המסלול התואם יוסר מהפתרון יחד עם הביקורים שלו. אם shipment_label בפתרון שהוזרק לא תואם למשלוח של בקשה, הביקור התואם יוסר מהפתרון. אם SkippedShipment.label בפתרון שהוזרק לא תואם למשלוח בבקשה, ה-SkippedShipment יוסר מהפתרון.

הסרה של ביקורים במסלול או של מסלולים שלמים מפתרון מוזרק עשויה להשפיע על האילוצים המשתמעים, מה שעלול להוביל לשינוי בפתרון, לשגיאות אימות או לחוסר היתכנות.

הערה: מי שמבצע את הקריאה צריך לוודא שכל Vehicle.label (או Shipment.label) מזהה באופן ייחודי ישות של רכב (או משלוח) שנעשה בה שימוש בשתי הבקשות הרלוונטיות: הבקשה הקודמת שהפיקה את ה-OptimizeToursResponse שנעשה בו שימוש בפתרון שהוזרק, והבקשה הנוכחית שכוללת את הפתרון שהוזרק. בדיקות הייחודיות שמתוארות למעלה לא מספיקות כדי להבטיח שהדרישה הזו תתקיים.

bool

כדאי להביא בחשבון את אומדן התנועה כשמחשבים את השדות ShipmentRoute, ‏ Transition.travel_duration, ‏ Visit.start_time ו-vehicle_end_time, כשמגדירים את השדה ShipmentRoute.has_traffic_infeasibilities וכשמחשבים את השדה OptimizeToursResponse.total_cost.

bool

אם הערך הוא True, קווים פוליגוניים יאוכלסו בתגובות מסוג ShipmentRoute.

bool

אם הערך הוא True, קווים פוליגוניים וטוקנים של מסלולים יאוכלסו בתגובה ShipmentRoute.transitions.

bool

אם המדיניות מוגדרת, לבקשה יכול להיות מועד אחרון (ראו https://grpc.io/blog/deadlines) של עד 60 דקות. אחרת, המועד האחרון המקסימלי הוא 30 דקות בלבד. חשוב לזכור שבבקשות לטווח ארוך יש סיכון גדול יותר (אבל עדיין קטן) להפרעה.

bool

אם הערך הוא true, מרחקי הנסיעה יחושבו באמצעות מרחקים גיאודזיים במקום מרחקים במפות Google, וזמני הנסיעה יחושבו באמצעות מרחקים גיאודזיים עם מהירות שמוגדרת על ידי geodesic_meters_per_second.

string

תווית שאפשר להשתמש בה כדי לזהות את הבקשה הזו, שדווחה ב-OptimizeToursResponse.request_label.

double

כשהערך של use_geodesic_distances הוא True, צריך להגדיר את השדה הזה, והוא מגדיר את המהירות שמשמשת לחישוב זמני ההגעה. הערך חייב להיות לפחות 1.0 מטרים לשנייה.

int32

מגבילה את מספר שגיאות האימות שמוחזרות. השגיאות האלה בדרך כלל מצורפות למטען ייעודי (payload) של שגיאת INVALID_ARGUMENT בתור פרטי שגיאת BadRequest‏ (https://cloud.google.com/apis/design/errors#error_details)), אלא אם solving_mode=VALIDATE_ONLY: ראו את השדה OptimizeToursResponse.validation_errors. ברירת המחדל היא 100 והמקסימום הוא 10,000.

ShipmentRoute

מסלולים שמחושבים לכל רכב. המסלול ה-i תואם לרכב ה-i במודל.

string

עותק של OptimizeToursRequest.label, אם צוינה תווית בבקשה.

SkippedShipment

רשימת כל המשלוחים שדילגו עליהם.

OptimizeToursValidationError

רשימה של כל שגיאות האימות שהצלחנו לזהות באופן עצמאי. אפשר לעיין בהסבר על "שגיאות מרובות" לגבי ההודעה OptimizeToursValidationError. במקום שגיאות, יוצגו אזהרות אם הערך של solving_mode הוא DEFAULT_SOLVE.

OptimizeToursRequest

במקרים מסוימים אנחנו משנים את הבקשה לפני שאנחנו פותרים אותה, למשל מוסיפים עלויות. אם solving_mode == TRANSFORM_AND_RETURN_REQUEST, הבקשה ששונתה מוחזרת כאן.

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request.

Metrics

מדדי משך זמן, מרחק ושימוש בפתרון הזה.

AggregatedMetrics

זהו נתון נצבר מהמסלולים. כל מדד הוא הסכום (או הערך המקסימלי, במקרה של עומסים) של כל השדות של ShipmentRoute.metrics עם אותו שם.

int32

מספר המשלוחים שדילגו עליהם.

int32

מספר כלי הרכב שנעשה בהם שימוש. הערך: אם מסלול הרכב ריק והערך של Vehicle.used_if_route_is_empty הוא True, הרכב נחשב כרכב בשימוש.

Timestamp

שעת ההתחלה המוקדמת ביותר של רכב בשימוש, שמחושבת כערך המינימלי של ShipmentRoute.vehicle_start_time בכל הרכבים בשימוש.

Timestamp

שעת הסיום המאוחרת ביותר של רכב משומש, שמחושבת כערך המקסימלי של ShipmentRoute.vehicle_end_time בכל הרכבים המשומשים.

map<string, double>

עלות הפתרון, בחלוקה לפי שדות הבקשה שקשורים לעלות. המפתחות הם נתיבי פרוטו, ביחס ל-OptimizeToursRequest של הקלט, למשל "model.shipments.pickups.cost", והערכים הם העלות הכוללת שנוצרה על ידי שדה העלות המתאים, שנצבר על פני כל הפתרון. במילים אחרות, costs["model.shipments.pickups.cost"] הוא הסכום של כל המחירים לאיסוף בפתרון. כל העלויות שמוגדרות במודל מדווחות כאן בפירוט, חוץ מעלויות שקשורות ל-TransitionAttributes, שמדווחות רק באופן מצטבר החל מינואר 2022.

double

העלות הכוללת של הפתרון. הסכום של כל הערכים במפת העלויות.

string

חובה. פרויקט או מיקום יעד לביצוע שיחה.

פורמט:

• projects/{project-id}
• projects/{project-id}/locations/-

ערכי {location-id} אזוריים לא נתמכים.

Uri

חובה. ה-URI של האובייקט ב-Cloud Storage שמכיל את ה-OptimizeToursRequest.

Uri

חובה. ה-URI של האובייקט ב-Cloud Storage שיכיל את ה-OptimizeToursResponse.

Uri

אופציונלי. ה-URI של האובייקט ב-Cloud Storage שמכיל את ה-OptimizeToursResponse, מקודד כ-JSON או כ-textproto. אם האובייקט קודד כ-JSON, הסיומת של שם האובייקט תהיה .json. אם האובייקט קודד כ-textproto, הסיומת של שם האובייקט תהיה .txtpb.

אפשר להשתמש ב-crc32_checksum של המשאב כדי לוודא שהתוכן של המשאב לא השתנה.

int32

שגיאת אימות מוגדרת על ידי הצמד (code, display_name) שתמיד מופיע.

השדות שאחרי הקטע הזה מספקים הקשר נוסף לגבי השגיאה.

שגיאות מרובות: כשיש כמה שגיאות, תהליך האימות מנסה להציג כמה מהן. בדומה לקומפיילר, זהו תהליך לא מושלם. חלק משגיאות האימות יהיו "חמורות", כלומר הן יעצרו את כל תהליך האימות. זה נכון לגבי שגיאות display_name="UNSPECIFIED", בין היתר. שגיאות מסוימות עלולות לגרום לתהליך האימות לדלג על שגיאות אחרות.

יציבות: code ו-display_name צריכים להיות יציבים מאוד. עם זאת, יכול להיות שעם הזמן יופיעו קודים ושמות חדשים לתצוגה, ובעקבות זאת בקשה (לא חוקית) מסוימת תניב צמד (code, display_name) שונה, כי השגיאה החדשה הסתירה את השגיאה הישנה. לדוגמה, ראו "MULTIPLE ERRORS".

string

השם המוצג של השגיאה.

FieldReference

הקשר של שגיאה יכול לכלול 0, 1 (ברוב המקרים) או יותר שדות. לדוגמה, כדי להתייחס לרכב מספר 4 ולאיסוף הראשון של משלוח מספר 2, אפשר להשתמש בקוד הבא:

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 sub_field {name: "pickups" index: 0} }

עם זאת, שימו לב שהעוצמה של fields לא אמורה להשתנות עבור קוד שגיאה נתון.

string

מחרוזת קריאה לאנשים שמתארת את השגיאה. יש מיפוי של 1:1 בין code לבין error_message (כשהקוד הוא לא UNSPECIFIED).

יציבות: לא יציב: הודעת השגיאה שמשויכת ל-code מסוים עשויה להשתנות עם הזמן (בתקווה שהיא תהיה ברורה יותר). במקום זאת, צריך להסתמך על display_name ועל code.

string

יכול להכיל את הערכים של השדות. האפשרות הזו לא תמיד זמינה. אסור להסתמך עליו, וצריך להשתמש בו רק לניפוי באגים ידני במודל.

string

שם השדה, למשל "vehicles".

FieldReference

שדה משנה בתצורה של רקורסיה, אם צריך.

int32

האינדקס של השדה אם הוא חוזר.

string

מפתח אם השדה הוא מפה.

DataFormat

חובה. פורמט הנתונים של הפלט.

GcsDestination

המיקום ב-Google Cloud Storage שבו ייכתב הפלט.

bool

ההגדרה קובעת אם להימנע מכבישי אגרה כשאפשר. תינתן עדיפות למסלולים שלא כוללים כבישי אגרה. רלוונטי רק לאמצעי תחבורה ממונעים.

bool

ההגדרה קובעת אם להימנע מכבישים מהירים כשאפשר. תינתן עדיפות למסלולים שלא כוללים כבישים מהירים. רלוונטי רק לאמצעי תחבורה ממונעים.

bool

ההגדרה קובעת אם להימנע ממעבורות כשאפשר. תינתן עדיפות למסלולים שלא כוללים נסיעה במעבורות. רלוונטי רק לאמצעי תחבורה ממונעים.

bool

אופציונלי. ההגדרה קובעת אם להימנע מניווט בתוך מבנים כשאפשר. תינתן עדיפות למסלולים שלא כוללים ניווט בתוך מבנים. ההגדרה חלה רק על אופן ההתניידות WALKING.

string

השם המוצג של המשלוח, שמוגדר על ידי המשתמש. הוא יכול להכיל עד 63 תווים, כולל תווים בפורמט UTF-8.

VisitRequest

קבוצה של חלופות לאיסוף שמשויכות למשלוח. אם לא מציינים את המיקום, הרכב צריך להגיע רק למיקום שתואם למשלוחים.

VisitRequest

קבוצה של חלופות משלוח שמשויכות למשלוח. אם לא מציינים את המיקום, הרכב צריך להגיע רק למיקום שתואם לאיסופים.

map<string, Load>

דרישות העומס של המשלוח (לדוגמה: משקל, נפח, מספר משטחים וכו'). המפתחות במפה צריכים להיות מזהים שמתארים את סוג העומס המתאים, ורצוי לכלול גם את היחידות. לדוגמה: "weight_kg",‏ "volume_gallons",‏ "pallet_count" וכו'. אם מפתח מסוים לא מופיע במפה, העומס התואם נחשב כ-null.

int32

קבוצת כלי הרכב שיכולים לבצע את המשלוח הזה. אם השדה ריק, כל כלי הרכב יכולים לבצע את המשימה. הרכבים מיוצגים על ידי האינדקס שלהם ברשימת vehicles של ShipmentModel.

double

מציין את העלות שנגרמת כשהמשלוח הזה נמסר על ידי כל רכב. אם מציינים את המאפיין, הוא חייב לכלול אחד מהשניים:

• אותו מספר של רכיבים כמו ב-costs_per_vehicle_indices. ‫costs_per_vehicle[i] תואם לרכב costs_per_vehicle_indices[i] של המודל.
• מספר הרכיבים צריך להיות זהה למספר כלי הרכב במודל. הרכיב ה-i תואם לרכב מספר i של המודל.

העלויות האלה צריכות להיות באותה יחידה כמו penalty_cost, והן לא יכולות להיות שליליות. אם אין עלויות כאלה, משאירים את השדה הזה ריק.

int32

אינדקסים של כלי הרכב ש-costs_per_vehicle חל עליהם. אם השדה לא ריק, הוא חייב להכיל את אותו מספר רכיבים כמו costs_per_vehicle. אי אפשר לציין אינדקס רכב יותר מפעם אחת. אם רכב מסוים מוחרג מ-costs_per_vehicle_indices, העלות שלו היא אפס.

Duration

מציינת את משך הזמן המקסימלי של עיקוף מוחלט בהשוואה למסלול הקצר ביותר מנקודת האיסוף לנקודת המסירה. אם מציינים את המאפיין, הוא חייב להיות לא שלילי, והמשלוח חייב לכלול לפחות איסוף אחד ומסירה אחת.

לדוגמה, נניח ש-t הוא הזמן הקצר ביותר שלוקח להגיע מהאפשרות שנבחרה לאיסוף ישירות לאפשרות שנבחרה למשלוח. ואז ההגדרה pickup_to_delivery_absolute_detour_limit אוכפת:

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

אם מגדירים גם מגבלות יחסיות וגם מגבלות מוחלטות לאותו משלוח, המגבלה המחמירה יותר משמשת לכל זוג אפשרי של איסוף/מסירה. החל מאוקטובר 2017, יש תמיכה בנסיעות עקיפות רק כשמשך הנסיעה לא תלוי בכלי הרכב.

Duration

מציין את משך הזמן המקסימלי מתחילת האיסוף ועד לתחילת המסירה של משלוח. אם מציינים את המאפיין, הוא חייב להיות לא שלילי, והמשלוח חייב לכלול לפחות איסוף אחד ומסירה אחת. הזמן הזה לא תלוי באפשרויות שנבחרו לאיסוף ולמסירה, וגם לא במהירות הרכב. אפשר לציין את זה לצד אילוצי סטייה מקסימלית: הפתרון יתחשב בשני המפרטים.

string

מחרוזת לא ריקה שמציינת את סוג המשלוח. אפשר להשתמש בתכונה הזו כדי להגדיר חוסר תאימות או דרישות בין shipment_types (ראו shipment_type_incompatibilities ו-shipment_type_requirements ב-ShipmentModel).

השדה הזה שונה מהשדה visit_types, שמצוין לביקור בודד: כל האיסופים/המסירות ששייכים לאותו משלוח חולקים את אותו shipment_type.

string

מציין תווית למשלוח הזה. התווית הזו מדווחת בתגובה ב-shipment_label של ה-ShipmentRoute.Visit המתאים.

bool

אם הערך הוא True, המערכת מדלגת על המשלוח הזה, אבל לא מחילה penalty_cost.

התעלמות ממשלוח גורמת לשגיאת אימות כשיש shipment_type_requirements במודל.

מותר להתעלם ממשלוח שמבוצע ב-injected_first_solution_routes או ב-injected_solution_constraint. פותר הבעיות מסיר את הביקורים הקשורים לאיסוף או למסירה מהמסלול שמבוצע. precedence_rules שמתייחסים למשלוחים שהמערכת מתעלמת מהם.

double

אם המשלוח לא הושלם, הקנס הזה מתווסף לעלות הכוללת של המסלולים. משלוח נחשב כהושלם אם מבקרים באחת מהחלופות לאיסוף ולמסירה שלו. העלות יכולה להיות מבוטאת באותה יחידה שבה משתמשים בכל שאר השדות שקשורים לעלות במודל, והיא חייבת להיות חיובית.

חשוב: אם לא מציינים את הקנס הזה, הוא נחשב לאינסופי, כלומר חובה להשלים את המשלוח.

double

מציין את זמן העיקוף היחסי המקסימלי בהשוואה למסלול הקצר ביותר מנקודת האיסוף לנקודת המסירה. אם מציינים את המאפיין, הוא חייב להיות לא שלילי, והמשלוח חייב לכלול לפחות איסוף אחד ומסירה אחת.

לדוגמה, נניח ש-t הוא הזמן הקצר ביותר שלוקח להגיע מהאפשרות שנבחרה לאיסוף ישירות לאפשרות שנבחרה למשלוח. ואז ההגדרה pickup_to_delivery_relative_detour_limit אוכפת:

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

אם מגדירים גם מגבלות יחסיות וגם מגבלות מוחלטות לאותו משלוח, המגבלה המחמירה יותר משמשת לכל זוג אפשרי של איסוף/מסירה. החל מאוקטובר 2017, יש תמיכה בנסיעות עקיפות רק כשמשך הנסיעה לא תלוי בכלי הרכב.

int64

המידה שבה העומס של הרכב שמבצע את הביקור המתאים ישתנה. מכיוון שמדובר במספר שלם, מומלץ למשתמשים לבחור יחידה מתאימה כדי למנוע אובדן של דיוק. הערך חייב להיות גדול מ-0 או שווה לו.

LatLng

המיקום הגיאוגרפי שאליו הרכב מגיע כשמבצעים את הVisitRequest הזה. אם למודל המשלוח יש מטריצות של משך זמן ומרחק, אסור לציין את arrival_location.

Waypoint

נקודת הדרך שאליה הרכב מגיע כשמבצעים את הVisitRequest הזה. אם למודל המשלוח יש מטריצות של משך זמן ומרחק, אסור לציין את arrival_waypoint.

LatLng

המיקום הגיאוגרפי שממנו הרכב יוצא אחרי השלמת VisitRequest. אפשר להשמיט את השדה הזה אם הוא זהה לשדה arrival_location. אם למודל המשלוח יש מטריצות של משך זמן ומרחק, אסור לציין את departure_location.

Waypoint

נקודת הציון שבה הרכב יוצא אחרי השלמת VisitRequest. אפשר להשמיט את השדה הזה אם הוא זהה לשדה arrival_waypoint. אם למודל המשלוח יש מטריצות של משך זמן ומרחק, אסור לציין את departure_waypoint.

string

מציין תגים שמצורפים לבקשת הביקור. אסור להשתמש במחרוזות ריקות או כפולות.

TimeWindow

חלונות זמן שמגבילים את זמן ההגעה לביקור. שימו לב שכלי רכב יכול לצאת מחוץ לחלון זמן ההגעה, כלומר זמן ההגעה + משך הזמן לא צריכים להיות בתוך חלון זמן. אם הרכב יגיע לפני TimeWindow.start_time, יכול להיות שתצטרכו להמתין.

אם לא מצוין TimeWindow, הרכב יכול לבצע את הביקור בכל שלב.

חלונות הזמן חייבים להיות נפרדים, כלומר אסור שחלון זמן אחד יחפוף לחלון זמן אחר או יהיה סמוך אליו, והם חייבים להיות בסדר עולה.

אפשר להגדיר את cost_per_hour_after_soft_end_time ו-soft_end_time רק אם יש חלון זמן אחד.

Duration

משך הביקור, כלומר הזמן שהרכב נמצא במקום בין ההגעה לעזיבה (צריך להוסיף אותו לזמן ההמתנה האפשרי, ראו time_windows).

double

עלות הטיפול בבקשת הביקור הזו במסלול של כלי רכב. אפשר להשתמש במאפיין הזה כדי לשלם עלויות שונות על כל אפשרות חלופית לאיסוף או למסירה של משלוח. העלות הזו צריכה להיות באותה יחידה כמו Shipment.penalty_cost, והיא לא יכולה להיות שלילית.

map<string, Load>

העומס שנוצר בעקבות בקשת הביקור הזו. השדה הזה זהה לשדה Shipment.load_demands, אבל הוא חל רק על VisitRequest במקום על כל Shipment. הדרישות שמפורטות כאן מתווספות לדרישות שמפורטות ב-Shipment.load_demands.

string

מציין את סוגי הביקורים. אפשר להשתמש במאפיין הזה כדי להקצות זמן נוסף שנדרש לרכב כדי להשלים את הביקור (ראו Vehicle.extra_visit_duration_for_visit_type).

כל סוג יכול להופיע רק פעם אחת.

string

מציינת תווית ל-VisitRequest הזה. התווית הזו מדווחת בתגובה בתור visit_label ב-ShipmentRoute.Visit המתאים.

bool

מציינת אם צריך להימנע מפניות פרסה במסלולי נסיעה במיקום הזה. אנחנו עושים כמיטב יכולתנו כדי להימנע מפניות פרסה, אבל לא יכולים להבטיח הימנעות מוחלטת. זו תכונה ניסיונית וההתנהגות שלה עשויה להשתנות.

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request.

Shipment

קבוצת משלוחים שצריך לבצע במודל.

Vehicle

קבוצת כלי רכב שאפשר להשתמש בהם כדי לבצע ביקורים.

Objective

קבוצת היעדים של המודל הזה, שאותם נהפוך לעלויות. אם הוא לא ריק, מודל הקלט צריך להיות ללא עלות. כדי לקבל את הבקשה ששונתה, צריך להשתמש ב-solving_mode = TRANSFORM_AND_RETURN_REQUEST. חשוב לדעת שהבקשה לא תיפתר במקרה כזה. לעיון במסמכים הרלוונטיים.

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request.

Timestamp

שעת ההתחלה ושעת הסיום הגלובליות של המודל: שעות מחוץ לטווח הזה לא ייחשבו כתקפות.

טווח הזמן של המודל חייב להיות פחות משנה, כלומר ההפרש בין global_end_time ל-global_start_time חייב להיות פחות מ-31,536,000 שניות.

כשמשתמשים בשדות cost_per_*hour, כדאי להגדיר חלון זמן קצר יותר כדי לשפר את הביצועים (למשל, אם יוצרים מודל ליום אחד, צריך להגדיר את מגבלות הזמן הגלובליות לאותו יום). אם לא מגדירים את המדיניות, המערכת משתמשת בערך ברירת המחדל 00:00:00 UTC, ‏ 1 בינואר 1970 (כלומר, שניות: 0, ננו-שניות: 0).

Timestamp

אם לא מגדירים את השדה, ערך ברירת המחדל הוא 00:00:00 UTC, ‏ 1 בינואר 1971 (כלומר, שניות: 31536000, ננו-שניות: 0).

double

"משך הזמן הגלובלי" של התוכנית הכוללת הוא ההפרש בין שעת ההתחלה האפקטיבית המוקדמת ביותר לבין שעת הסיום האפקטיבית המאוחרת ביותר של כל הרכבים. המשתמשים יכולים להקצות עלות לשעה לכמות הזו כדי לנסות לבצע אופטימיזציה להשלמת המשימה המוקדמת ביותר, למשל. העלות הזו צריכה להיות באותה יחידה כמו Shipment.penalty_cost.

DurationDistanceMatrix

מציין את מטריצות משך הזמן ומטריצת המרחקים שבהן נעשה שימוש במודל. אם השדה הזה ריק, המערכת תשתמש במפות Google או במרחקים גיאודזיים, בהתאם לערך בשדה use_geodesic_distances. אם הוא לא ריק, הערך של use_geodesic_distances לא יכול להיות True, והערכים של duration_distance_matrix_src_tags ו-duration_distance_matrix_dst_tags לא יכולים להיות ריקים.

דוגמאות לשימוש:

• יש שני מיקומים: מיקום א' ומיקום ב'.
• רכב אחד שמתחיל את המסלול ב-locA ומסיים אותו ב-locA.
• בקשה אחת לאיסוף במיקום ב'.

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• יש שלושה מיקומים: locA, ‏ locB ו-locC.
• רכב אחד שמתחיל את המסלול ב-locA ומסיים אותו ב-locB, באמצעות המטריצה "fast".
• רכב אחד שמתחיל את המסלול ב-locB ומסיים אותו ב-locB, באמצעות המטריצה "slow".
• רכב אחד שמתחיל את המסלול ב-locB ומסיים אותו ב-locB, באמצעות המטריצה "fast".
• בקשה אחת לאיסוף במיקום C.

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

תגים שמגדירים את המקורות של מטריצות משך הזמן והמרחק. duration_distance_matrices(i).rows(j) מגדיר את משכי הזמן והמרחקים מביקורים עם התג duration_distance_matrix_src_tags(j) לביקורים אחרים במטריצה i.

התגים תואמים ל-VisitRequest.tags או ל-Vehicle.start_tags. VisitRequest או Vehicle נתונים חייבים להתאים בדיוק לתג אחד בשדה הזה. שימו לב שתגי המקור, היעד והמטריצה של Vehicle יכולים להיות זהים. באופן דומה, תגי המקור והיעד של VisitRequest יכולים להיות זהים. כל התגים צריכים להיות שונים ולא יכולים להיות מחרוזות ריקות. אם השדה הזה לא ריק, גם השדה duration_distance_matrices לא יכול להיות ריק.

string

תגים שמגדירים את היעדים של מטריצות משך הזמן ומטריצות המרחקים; duration_distance_matrices(i).rows(j).durations(k) (בהתאמה, duration_distance_matrices(i).rows(j).meters(k)) מגדיר את משך הנסיעה (או המרחק) מביקורים עם התג duration_distance_matrix_src_tags(j) לביקורים עם התג duration_distance_matrix_dst_tags(k) במטריצה i.

התגים תואמים ל-VisitRequest.tags או ל-Vehicle.start_tags. VisitRequest או Vehicle נתונים חייבים להתאים בדיוק לתג אחד בשדה הזה. שימו לב שתגי המקור, היעד והמטריצה של Vehicle יכולים להיות זהים. באופן דומה, תגי המקור והיעד של VisitRequest יכולים להיות זהים. כל התגים צריכים להיות שונים ולא יכולים להיות מחרוזות ריקות. אם השדה הזה לא ריק, גם השדה duration_distance_matrices לא יכול להיות ריק.

TransitionAttributes

מאפייני מעבר נוספו למודל.

ShipmentTypeIncompatibility

קבוצות של shipment_types לא תואמים (ראו ShipmentTypeIncompatibility).

ShipmentTypeRequirement

קבוצות של דרישות shipment_type (ראו ShipmentTypeRequirement).

PrecedenceRule

קבוצה של כללי קדימות שצריך לאכוף במודל.

חשוב: השימוש בכללי קדימויות מגביל את גודל הבעיה שאפשר לבצע לה אופטימיזציה. יכול להיות שנדחה בקשות שכוללות כללי קדימות עם הרבה משלוחים.

int32

מגבילה את המספר המקסימלי של כלי רכב פעילים. רכב נחשב פעיל אם המסלול שלו כולל לפחות משלוח אחד. אפשר להשתמש בזה כדי להגביל את מספר המסלולים במקרים שבהם יש פחות נהגים מכלי רכב, וצי הרכב הוא הטרוגני. לאחר מכן, האופטימיזציה תבחר את קבוצת המשנה הטובה ביותר של כלי הרכב לשימוש. הערך חייב להיות חיובי.

Row

מציין את השורות של מטריצת משך הזמן ומטריצת המרחקים. הוא חייב להכיל את אותו מספר רכיבים כמו ShipmentModel.duration_distance_matrix_src_tags.

string

תג שמגדיר לאילו כלי רכב חלה מטריצת המרחקים ומשך הזמן הזו. אם לא מציינים ערך, המטריצה חלה על כל הרכבים, ויכולה להיות רק מטריצה אחת.

כל התחלה של רכב חייבת להתאים בדיוק למטריצה אחת, כלומר בדיוק אחד מהשדות start_tags שלהם חייב להתאים ל-vehicle_start_tag של מטריצה (ורק של המטריצה הזו).

לכל המטריצות צריך להיות vehicle_start_tag שונה.

Duration

ערכי משך זמן בשורה נתונה. הוא חייב להכיל את אותו מספר רכיבים כמו ShipmentModel.duration_distance_matrix_dst_tags.

double

ערכי המרחק בשורה נתונה. אם אין עלויות או אילוצים שמתייחסים למרחקים במודל, אפשר להשאיר את השדה הזה ריק. אחרת, הוא צריך להכיל מספר רכיבים זהה ל-durations.

Type

סוג היעד.

double

כמה היעד הזה צריך להיחשב ביחס ליעדים האחרים. אפשר להזין כל מספר לא שלילי, וסכום המשקלים לא חייב להיות 1. ברירת המחדל של המשקלים היא 1.0.

bool

מציין אם האירוע "הראשון" הוא מסירה.

bool

מציין אם האירוע "השני" הוא מסירה.

Duration

ההיסט בין האירוע "הראשון" לאירוע "השני". הוא יכול להיות שלילי.

int32

אינדקס המשלוח של האירוע "הראשון". חובה למלא את השדה הזה.

int32

אינדקס המשלוח של האירוע "השני". חובה למלא את השדה הזה.

int32

הרכב שמבצע את המסלול, מזוהה לפי האינדקס שלו במקור ShipmentModel.

string

התווית של הרכב שמבצע את המסלול הזה, שווה ל-ShipmentModel.vehicles(vehicle_index).label, אם צוינה.

Timestamp

השעה שבה הרכב מתחיל את המסלול שלו.

Timestamp

השעה שבה הרכב מסיים את המסלול שלו.

Visit

רצף מסודר של ביקורים שמייצג מסלול. visits[i] ‎ הוא הביקור ה-i במסלול. אם השדה הזה ריק, הרכב נחשב כלא משומש.

Transition

רשימה מסודרת של מעברים במסלול.

bool

כשהערך של OptimizeToursRequest.consider_road_traffic הוא true, השדה הזה מציין שחוסר העקביות בתזמוני המסלולים נחזה באמצעות הערכות של משך הנסיעה על סמך התנועה. יכול להיות שלא יהיה מספיק זמן להשלים את הנסיעה, העיכובים וההפסקות בין הביקורים, לפני הביקור הראשון או אחרי הביקור האחרון, תוך עמידה בחלונות הזמן של הביקור ושל הרכב. לדוגמה,

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

סביר להניח שההגעה אל next_visit תתרחש אחרי חלון הזמן הנוכחי שלה, בגלל הערכה מוגברת של זמן הנסיעה travel_duration(previous_visit, next_visit) עקב עומס תנועה. בנוסף, יכול להיות שהמערכת תאלץ חפיפה בין הפסקה לביקור בגלל עלייה בהערכות של זמן ההגעה והגבלות על חלונות הזמן של הביקור או ההפסקה.

EncodedPolyline

ייצוג הקו הפוליגוני המקודד של המסלול. השדה הזה מאוכלס רק אם הערך של OptimizeToursRequest.populate_polylines מוגדר כ-true.

Break

הפסקות מתוכננות לרכב שנוסע במסלול הזה. הרצף breaks מייצג מרווחי זמן, שכל אחד מהם מתחיל ב-start_time המתאים ונמשך duration שניות.

AggregatedMetrics

מדדי משך הזמן, המרחק והעומס במסלול הזה. השדות של AggregatedMetrics מסוכמים בכל ShipmentRoute.transitions או ShipmentRoute.visits, בהתאם להקשר.

VehicleFullness

שדה VehicleFullness לחישוב מידת הקרבה של המדדים המוגבלים למגבלות הרכב המתאימות. השדות שלו הם יחסים בין שדה מדד מוגבל (למשל AggregatedMetrics.travel_distance_meters) לבין מגבלת הרכב הקשורה (למשל Vehicle.route_distance_limit).

ניסיוני: ההתנהגות או הקיום של השדה הזה עשויים להשתנות בעתיד.

map<string, double>

עלות המסלול, בחלוקה לפי שדות בקשה שקשורים לעלות. המפתחות הם נתיבי פרוטו, ביחס ל-OptimizeToursRequest של הקלט, למשל "model.shipments.pickups.cost", והערכים הם העלות הכוללת שנוצרה על ידי שדה העלות המתאים, שנצבר לאורך כל המסלול. במילים אחרות, costs["model.shipments.pickups.cost"] הוא הסכום של כל עלויות האיסוף לאורך המסלול. כל העלויות שמוגדרות במודל מדווחות כאן בפירוט, חוץ מעלויות שקשורות ל-TransitionAttributes, שמדווחות רק באופן מצטבר החל מינואר 2022.

double

העלות הכוללת של המסלול. סכום כל העלויות במפת העלויות.

Timestamp

שעת ההתחלה של ההפסקה.

Duration

משך ההפסקה.

string

מחרוזת שמייצגת נקודות מקודדות של הקו הפוליגוני.

Duration

משך הנסיעה במהלך המעבר הזה.

double

המרחק שעברתם במהלך המעבר.

bool

כשמבקשים נתוני תנועה דרך OptimizeToursRequest.consider_road_traffic, ואי אפשר לאחזר את נתוני התנועה של Transition, הערך הבוליאני הזה מוגדר כ-true. יכול להיות שזה מצב זמני (תקלה נדירה בשרתים של התנועה בזמן אמת) או קבוע (אין נתונים לגבי המיקום הזה).

Duration

סכום משכי הזמן של העיכובים שהוחלו על המעבר הזה. אם יש עיכוב, הוא מתחיל בדיוק delay_duration שניות לפני האירוע הבא (ביקור או סיום נסיעה). TransitionAttributes.delay.

Duration

משך הזמן הכולל של ההפסקות שהתרחשו במהלך המעבר הזה, אם היו כאלה. פרטים על שעת ההתחלה ומשך הזמן של כל הפסקה מאוחסנים ב-ShipmentRoute.breaks.

Duration

משך ההמתנה במהלך המעבר הזה. משך ההמתנה תואם לזמן חוסר הפעילות ולא כולל את זמן ההפסקה. חשוב גם לדעת שזמן ההמתנה הזה יכול להיות מחולק לכמה מרווחים לא רציפים.

Duration

משך הזמן הכולל של המעבר, לנוחיותכם. הוא שווה ל:

• הביקור הבא start_time (או vehicle_end_time אם זה המעבר האחרון) – start_time של המעבר הזה;
• אם הערך של ShipmentRoute.has_traffic_infeasibilities הוא False, מתקיים גם התנאי הבא: total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

שעת ההתחלה של המעבר הזה.

EncodedPolyline

הייצוג של הקו הפוליגוני המקודד של המסלול שבו הרכב נסע במהלך המעבר. השדה הזה מאוכלס רק אם הערך של populate_transition_polylines מוגדר כ-true.

string

פלט בלבד. אסימון אטום שאפשר להעביר ל-Navigation SDK כדי לשחזר את המסלול במהלך הניווט, ובמקרה של שינוי מסלול, לשמור על הכוונה המקורית של המסלול שנוצר. התייחסו לטוקן הזה כאל אובייקט BLOB אטום. אל תשוו את הערך שלו בין בקשות, כי הערך עשוי להשתנות גם אם השירות מחזיר בדיוק את אותו מסלול. השדה הזה מאוכלס רק אם השדה populate_transition_polylines מוגדר כ-True.

map<string, VehicleLoad>

עומסי הרכב במהלך המעבר הזה, לכל סוג שמופיע ב-Vehicle.load_limits של הרכב הזה, או שיש לו Shipment.load_demands שאינו אפס במשלוח כלשהו שבוצע במסלול הזה.

העומסים במהלך המעבר הראשון הם עומסי ההתחלה של מסלול הרכב. אחרי כל ביקור, הערך של load_demands מתווסף או מופחת כדי לקבל את העומסים של המעבר הבא, בהתאם לסוג הביקור – איסוף או מסירה.

int64

כמות המטען ברכב, לפי הסוג הנתון. יחידת העומס מצוינת בדרך כלל לפי הסוג. Transition.vehicle_loads.

int32

אינדקס של השדה shipments במקור ShipmentModel.

bool

אם הערך הוא True, הביקור תואם לאיסוף של Shipment. אחרת, הוא תואם למשלוח.

int32

האינדקס של VisitRequest בשדה האיסוף או המסירה של Shipment (ראו is_pickup).

Timestamp

השעה שבה הביקור מתחיל. חשוב לזכור שהרכב עשוי להגיע למיקום הביקור לפני השעה הזו. השעות תואמות לShipmentModel.

map<string, Load>

העומס הכולל של הביקור הוא הסכום של המשלוח ובקשת הביקור load_demands. הערכים שליליים אם הביקור הוא מסירה. הדרישות מדווחות לאותם סוגים כמו Transition.loads (ראו את השדה הזה).

Duration

זמן הנסיעה הנוסף שנובע מהמשלוחים שבוצעו במסלול לפני הביקור, ומזמן ההמתנה הפוטנציאלי שנובע מחלונות הזמן. אם הביקור הוא מסירה, הנסיעה הלוך ושוב מחושבת מהביקור המתאים של האיסוף, והיא שווה ל:

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

אחרת, הוא מחושב לפי start_location של הרכב ושווה ל:

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

עותק של Shipment.label המתאים, אם צוין ב-Shipment.

string

עותק של VisitRequest.label המתאים, אם צוין ב-VisitRequest.

VisitType

אופציונלי. מציין את סוג הביקור. ההגדרה הזו מחליפה את השדה Visit.is_pickup.

int32

אסימון אטום שמייצג מידע על מיקום הביקור.

יכול להיות שהשדה הזה יאוכלס בביקורים של מסלולי התוצאות אם VisitRequest.avoid_u_turns הוגדר כ-true לביקור הזה, או אם ShipmentModel.avoid_u_turns הוגדר כ-true בבקשה OptimizeToursRequest.

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request.

string

רשימה של סוגים לא תואמים. שני משלוחים עם ערכים שונים של shipment_types מבין אלה שרשומים הם "לא תואמים".

IncompatibilityMode

המצב שמופעל על חוסר התאימות.

string

רשימה של סוגי משלוחים חלופיים שנדרשים על ידי dependent_shipment_types.

string

בכל המשלוחים עם סוג בשדה dependent_shipment_types, צריך לבקר לפחות במשלוח אחד מסוג required_shipment_type_alternatives באותו מסלול.

הערה: אסור ליצור שרשראות של דרישות שבהן shipment_type תלוי בעצמו.

RequirementMode

המצב שמוגדר לדרישה.

int32

האינדקס תואם לאינדקס של המשלוח במקור ShipmentModel.

string

עותק של Shipment.label המתאים, אם צוין ב-Shipment.

Reason

רשימת סיבות שמסבירות למה המערכת דילגה על המשלוח. אפשר לעיין בהערה שלמעלה Reason. אם לא נצליח להבין למה המשלוח לא נכלל, לא יוגדרו סיבות.

double

זהו עותק של Shipment.penalty_cost, שנכלל כאן כדי שיהיה קל יותר לראות את חומרת הדילוג על משלוח.

ניסיוני: ההתנהגות או הקיום של השדה הזה עשויים להשתנות בעתיד.

double

היחס המשוער של כלי רכב שלא יכולים לבצע את המשלוח הזה בגלל אחת מהסיבות הבאות לפחות. הערה: השדה הזה מתמלא רק כשהסיבות קשורות לרכב.

ניסיוני: ההתנהגות או הקיום של השדה הזה עשויים להשתנות בעתיד.

Code

עיינו בהערות של הקוד.

int32

כמו example_vehicle_index, אבל אנחנו מספקים את רשימת כלי הרכב שזוהו. זו רשימה חלקית בלבד. השדה הזה מתמלא רק אם הערך של [fill_example_vehicle_indices_in_skipped_reasons][] הוא True.

ניסיוני: ההתנהגות או הקיום של השדה הזה עשויים להשתנות בעתיד.

string

אם קוד הסיבה הוא DEMAND_EXCEEDS_VEHICLE_CAPACITY, המסמכים חורגים מסוג קיבולת אחד.

int32

אם הסיבה קשורה לאי-תאימות בין המשלוח לרכב, השדה הזה מספק את האינדקס של רכב רלוונטי אחד.

Timestamp

שעת ההתחלה של חלון הזמן הקשיח. אם לא מציינים ערך, הוא מוגדר כ-ShipmentModel.global_start_time.

Timestamp

שעת הסיום של חלון הזמן הקשיח. אם לא מציינים ערך, הוא מוגדר כ-ShipmentModel.global_end_time.

Timestamp

שעת ההתחלה הרכה של חלון הזמן.

Timestamp

שעת הסיום הגמישה של חלון הזמן.

double

עלות לשעה שמתווספת לעלויות אחרות במודל אם האירוע מתרחש לפני soft_start_time, ומחושבת כך:

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

העלות הזו חייבת להיות חיובית, ואפשר להגדיר את השדה רק אם הוגדר soft_start_time.

double

עלות לשעה שמתווספת לעלויות אחרות במודל אם האירוע מתרחש אחרי soft_end_time, ומחושבת כך:

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

העלות הזו חייבת להיות חיובית, ואפשר להגדיר את השדה רק אם הוגדר soft_end_time.

string

תגים שמגדירים את קבוצת המעברים (src->dst) שהמאפיינים האלה חלים עליהם.

ביקור במקור או התחלת נסיעה של רכב תואמים אם VisitRequest.tags או Vehicle.start_tags מכילים את src_tag או לא מכילים את excluded_src_tag (בהתאם לשדה מבין השניים שלא ריק).

string

src_tag. אחד מהשדות src_tag ו-excluded_src_tag חייב להיות לא ריק.

string

ביקור ביעד או סיום מסלול של רכב תואמים אם ורק אם VisitRequest.tags או Vehicle.end_tags מכילים את dst_tag או לא מכילים את excluded_dst_tag (בהתאם לשאלה איזה משני השדות האלה לא ריק).

string

dst_tag. אחד מהשדות dst_tag ו-excluded_dst_tag חייב להיות לא ריק.

double

מציין את העלות של ביצוע המעבר הזה. הערך הזה צריך להיות באותה יחידה כמו כל העלויות האחרות במודל, והוא לא יכול להיות שלילי. הוא מתווסף לכל העלויות הקיימות האחרות.

double

מציין עלות לקילומטר שחלה על המרחק שנעשה במהלך המעבר הזה. הוא מצטבר לכל Vehicle.cost_per_kilometer שצוין ברכבים.

DistanceLimit

מציינת מגבלה על המרחק שעוברים במהלך המעבר הזה.

נכון ליוני 2021, יש תמיכה רק במגבלות גמישות.

Duration

מציין את העיכוב שנגרם כשמבצעים את המעבר הזה.

העיכוב הזה תמיד מתרחש אחרי סיום הביקור בנקודת המוצא ולפני תחילת הביקור בנקודת היעד.

string

ה-URI של המשאב. יכול להיות שהמשאב עדיין לא קיים.

התוכן של המשאב מקודד כ-JSON או כ-textproto. יש תמיכה רק במשאבים של Google Cloud Storage. אם המשאב מקודד כ-JSON, שם המשאב חייב להסתיים ב-.json. אם המשאב מקודד כ-textproto, שם המשאב חייב להסתיים בסיומת .txtpb. לדוגמה, URI של Google Cloud Storage לקובץ בקידוד JSON יכול להיראות כך: gs://bucket/path/input/object.json.

string

השם שהמשתמש הגדיר לתצוגה של הרכב. הוא יכול להכיל עד 63 תווים, כולל תווים בפורמט UTF-8.

TravelMode

אופן הנסיעה שמשפיע על הכבישים שבהם הרכב יכול להשתמש ועל המהירות שלו. מידע נוסף מופיע ב-travel_duration_multiple.

RouteModifiers

קבוצת תנאים שמשפיעים על אופן חישוב המסלולים של הרכב הנתון.

LatLng

המיקום הגיאוגרפי שבו הרכב מתחיל את הנסיעה לפני שהוא אוסף משלוחים. אם לא מציינים את המיקום, הרכב מתחיל באיסוף הראשון שלו. אם למודל המשלוח יש מטריצות של משך זמן ומטריצת מרחקים, אסור לציין את start_location.

Waypoint

נקודת ציון שמייצגת מיקום גיאוגרפי שבו הרכב מתחיל לפני איסוף המשלוחים. אם לא מציינים את start_waypoint או את start_location, הרכב מתחיל באיסוף הראשון שלו. אם למודל המשלוח יש מטריצות של משך זמן ומטריצת מרחקים, אסור לציין את start_waypoint.

LatLng

המיקום הגיאוגרפי שבו הרכב מסיים את הנסיעה אחרי שהשלים את ה-VisitRequest האחרון. אם לא מציינים את הערך, ה-ShipmentRoute של הרכב מסתיים מיד אחרי השלמת ה-VisitRequest האחרון. אם למודל המשלוח יש מטריצות של משך זמן ומטריצת מרחקים, אסור לציין את end_location.

Waypoint

נקודת עצירה שמייצגת מיקום גיאוגרפי שבו הרכב מסיים את הנסיעה אחרי שהשלים את ה-VisitRequest האחרון. אם לא צוין end_waypoint או end_location, ה-ShipmentRoute של הרכב מסתיים מיד כשהוא משלים את ה-VisitRequest האחרון שלו. אם למודל המשלוח יש מטריצות של משך זמן ומטריצת מרחקים, אסור לציין את end_waypoint.

string

מציין תגים שמצורפים לתחילת המסלול של הרכב.

אסור להשתמש במחרוזות ריקות או כפולות.

string

מציין תגים שמצורפים לסוף המסלול של הרכב.

אסור להשתמש במחרוזות ריקות או כפולות.

TimeWindow

חלונות זמן שבהם הרכב יכול לצאת ממיקום ההתחלה שלו. הם חייבים להיות בטווח הזמן הגלובלי (ראו שדות ShipmentModel.global_*). אם לא צוין אחרת, אין מגבלה מלבד מגבלות הזמן הגלובליות האלה.

חלונות זמן ששייכים לאותו שדה חוזר חייבים להיות נפרדים, כלומר אסור שחלון זמן כלשהו יחפוף לחלון זמן אחר או יהיה סמוך אליו, והם חייבים להיות בסדר כרונולוגי.

אפשר להגדיר את cost_per_hour_after_soft_end_time ו-soft_end_time רק אם יש חלון זמן אחד.

TimeWindow

חלונות זמן שבהם הרכב יכול להגיע למיקום הסופי שלו. הם חייבים להיות בטווח הזמן הגלובלי (ראו שדות ShipmentModel.global_*). אם לא צוין אחרת, אין מגבלה מלבד מגבלות הזמן הגלובליות האלה.

חלונות זמן ששייכים לאותו שדה חוזר חייבים להיות נפרדים, כלומר אסור שחלון זמן כלשהו יחפוף לחלון זמן אחר או יהיה סמוך אליו, והם חייבים להיות בסדר כרונולוגי.

אפשר להגדיר את cost_per_hour_after_soft_end_time ו-soft_end_time רק אם יש חלון זמן אחד.

UnloadingPolicy

מדיניות הפריקה שנאכפת ברכב.

map<string, LoadLimit>

קיבולת הרכב (למשל: משקל, נפח, מספר משטחים). המפתחות במפה הם המזהים של סוג העומס, בהתאם למפתחות של השדה Shipment.load_demands. אם מפתח מסוים לא מופיע במפה הזו, הקיבולת המתאימה נחשבת לבלתי מוגבלת.

double

עלויות הרכב: כל העלויות מצטברות וצריכות להיות באותה יחידה כמו Shipment.penalty_cost.

העלות לשעה של מסלול הרכב. העלות הזו חלה על משך הזמן הכולל של המסלול, וכוללת את זמן הנסיעה, זמן ההמתנה וזמן הביקור. שימוש ב-cost_per_hour במקום ב-cost_per_traveled_hour בלבד עלול לגרום לזמן אחזור נוסף.

double

עלות לכל שעת נסיעה במסלול של הרכב. העלות הזו חלה רק על זמן ההגעה במסלול (כלומר, הזמן שדווח בשדה ShipmentRoute.transitions), ולא כוללת את זמן ההמתנה וזמן הביקור.

double

עלות לקילומטר של מסלול הרכב. העלות הזו חלה על המרחק שמדווח ב-ShipmentRoute.transitions, ולא על מרחק כלשהו שנעשה בו שימוש באופן משתמע מה-arrival_location אל ה-departure_location של VisitRequest יחיד.

double

עלות קבועה שחלה אם משתמשים ברכב הזה לטיפול במשלוח.

bool

השדה הזה רלוונטי רק לכלי רכב שהמסלול שלהם לא כולל משלוחים. הוא מציין אם הרכב נחשב כמשומש או לא במקרה הזה.

אם הערך הוא true, הרכב עובר ממיקום ההתחלה למיקום הסיום גם אם הוא לא מבצע משלוחים, ועלויות הזמן והמרחק שנובעות מהנסיעה ממיקום ההתחלה למיקום הסיום נלקחות בחשבון.

אחרת, הוא לא נוסע ממיקום ההתחלה למיקום הסיום, ולא מתוזמנים לרכב הזה break_rule או עיכוב (מ-TransitionAttributes). במקרה כזה, ה-ShipmentRoute של הרכב לא מכיל מידע מלבד האינדקס והתווית של הרכב.

DurationLimit

מגבלה שחלה על משך הזמן הכולל של מסלול הרכב. בOptimizeToursResponse נתון, משך המסלול של רכב הוא ההפרש בין vehicle_end_time ל-vehicle_start_time.

DurationLimit

מגבלה שחלה על משך הנסיעה במסלול של הרכב. בOptimizeToursResponse נתון, משך הנסיעה במסלול הוא הסכום של כל הtransitions.travel_duration שלו.

DistanceLimit

מגבלה שחלה על המרחק הכולל של מסלול הרכב. ב-OptimizeToursResponse נתון, מרחק המסלול הוא הסכום של כל ה-transitions.travel_distance_meters שלו.

map<string, Duration>

מציין מיפוי של מחרוזות visit_types למשכי זמן. משך הזמן הוא הזמן שצריך להוסיף ל-VisitRequest.duration בביקורים עם ה-visit_types שצוין. משך הביקור הנוסף הזה מוסיף עלות אם צוין cost_per_hour. מפתחות (למשל visit_types) לא יכולים להיות מחרוזות ריקות.

אם לבקשת ביקור יש כמה סוגים, משך זמן יתווסף לכל סוג במפה.

BreakRule

מתאר את לוח הזמנים של ההפסקות שצריך לאכוף ברכב הזה. אם השדה ריק, לא יתוזמנו הפסקות לרכב הזה.

string

מציין תווית לרכב הזה. התווית הזו מדווחת בתגובה בתור vehicle_label של ShipmentRoute התואם.

bool

אם הערך הוא True, הערך של used_if_route_is_empty חייב להיות False, ולא ייעשה שימוש בכלי הרכב הזה.

אם משלוח מתבצע על ידי רכב שמתעלמים ממנו ב-injected_first_solution_routes, המערכת מדלגת עליו בפתרון הראשון אבל אפשר לבצע אותו בתשובה.

אם משלוח מתבצע על ידי רכב שמתעלמים ממנו ב-injected_solution_constraint וכל איסוף/מסירה קשורים מוגבלים להישאר ברכב (כלומר, לא הוקלו לרמה RELAX_ALL_AFTER_THRESHOLD), המערכת מדלגת עליהם בתגובה. אם למשלוח יש שדה allowed_vehicle_indices לא ריק וכל כלי הרכב המותרים נמחקים, המערכת מדלגת עליו בתגובה.

double

מציין גורם כפל שאפשר להשתמש בו כדי להגדיל או להקטין את זמני הנסיעה של הרכב הזה. לדוגמה, אם מגדירים את הערך 2.0, הרכב איטי יותר וזמני ההגעה שלו ארוכים פי 2 מאלה של רכבים רגילים. הכפולה הזו לא משפיעה על משך הביקור. היא משפיעה על העלות אם מציינים את cost_per_hour או את cost_per_traveled_hour. הערך צריך להיות בטווח [0.001, 1000.0]. אם לא מגדירים את המכפיל, הרכב נחשב כרכב רגיל והמכפיל הוא 1.0.

אזהרה: זמני ההגעה יעוגלו לשנייה הקרובה ביותר אחרי החלת המכפיל הזה, אבל לפני ביצוע פעולות מספריות כלשהן. לכן, מכפיל קטן עלול לגרום לאובדן הדיוק.

מידע נוסף מופיע בקטע extra_visit_duration_for_visit_type בהמשך.

Duration

מגבלה קשיחה שמגבילה את משך הזמן ל-max_duration לכל היותר.

Duration

מגבלה גמישה שלא אוכפת מגבלה על משך הזמן המקסימלי, אבל אם חורגים ממנה, המסלול כרוך בעלות. העלות הזו מתווספת לעלויות אחרות שמוגדרות במודל, באותה יחידה.

אם מגדירים את soft_max_duration, הערך שלו לא יכול להיות שלילי. אם גם max_duration מוגדר, הערך של soft_max_duration חייב להיות קטן מ-max_duration.

Duration

מגבלה גמישה שלא אוכפת מגבלת משך מקסימלי, אבל אם חורגים ממנה, המסלול כרוך בעלות ריבועית ביחס למשך. העלות הזו מתווספת לעלויות אחרות שמוגדרות במודל, באותה יחידה.

אם השדה quadratic_soft_max_duration מוגדר, התנאים הבאים צריכים להתקיים:

• הערך לא יכול להיות שלילי.
• חובה להגדיר את max_duration.
• הערך של quadratic_soft_max_duration חייב להיות קטן מהערך של max_duration.
• ההפרש לא יכול להיות יותר מיום אחד: max_duration - quadratic_soft_max_duration <= 86400 seconds

double

העלות לשעה שנגבית אם חורגים מהסף של soft_max_duration. העלות הנוספת היא 0 אם משך הזמן קצר מהסף, אחרת העלות תלויה במשך הזמן באופן הבא:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

העלות לא יכולה להיות שלילית.

double

העלות לשעה בריבוע שנגבית אם חורגים מהסף של quadratic_soft_max_duration.

העלות הנוספת היא 0 אם משך הזמן קצר מהסף, אחרת העלות תלויה במשך הזמן באופן הבא:

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

העלות לא יכולה להיות שלילית.

int64

מגבלה רכה של העומס. cost_per_unit_above_soft_max.

double

אם העומס חורג מ-soft_max_load לאורך המסלול של הרכב הזה, חל הקנס הבא (רק פעם אחת לכל רכב): (עומס - soft_max_load) * cost_per_unit_above_soft_max. כל העלויות מצטברות וצריכות להיות באותה יחידה כמו Shipment.penalty_cost. אפשר להגדיר מגבלות גמישות רק בסוגים שחלים רק על איסופים או רק על משלוחים בכל המודל.

Interval

מרווח העומס הקביל של הרכב בתחילת המסלול.

Interval

מרווח העומס הקביל של הרכב בסוף המסלול.

int64

העומס המקסימלי המותר.

LoadCost

עלות ההעברה של יחידת מטען אחת לאורך קילומטר אחד ברכב הזה. אפשר להשתמש בזה כערך חלופי לצריכת דלק: אם העומס הוא משקל (בניוטונים), אז עומס*קילומטר הוא המימד של האנרגיה.

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request.

LoadCost

עלות הנסיעה עם יחידת עומס במשך שעה אחת ברכב הזה.

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request.

int64

עומס מינימלי קביל. הערך חייב להיות גדול מ-0 או שווה לו. אם שניהם צוינו, הערך של min חייב להיות קטן או שווה לערך של max.

int64

עומס מקסימלי מקובל. הערך חייב להיות גדול מ-0 או שווה לו. אם לא מציינים ערך, העומס המקסימלי לא מוגבל על ידי ההודעה הזו. אם שניהם צוינו, הערך של min חייב להיות קטן או שווה לערך של max.

int64

כמות העומס שמעליה העלות של העברת יחידת עומס משתנה מ-cost_per_unit_below_threshold ל-cost_per_unit_above_threshold. הערך חייב להיות גדול מ-0 או שווה לו.

double

העלות של העברת יחידת עומס, לכל יחידה בין 0 לערך הסף. הערך חייב להיות סופי וגדול מ-0 או שווה לו.

double

עלות ההעברה של יחידת עומס, לכל יחידה מעל הסף. במקרה המיוחד שבו הסף = 0, זו עלות קבועה ליחידה. הערך חייב להיות סופי וגדול מ-0 או שווה לו.

double

הערך המקסימלי של כל שאר השדות בהודעה הזו.

double

היחס בין AggregatedMetrics.travel_distance_meters ל-Vehicle.route_distance_limit. אם המדיניות Vehicle.route_distance_limit לא מוגדרת, השדה הזה לא יוגדר.

double

היחס בין [AggregatedMetrics.travel_duration_seconds][] לבין Vehicle.travel_duration_limit. אם Vehicle.travel_duration_limit לא מוגדר, השדה הזה לא יוגדר.

double

היחס בין [AggregatedMetrics.total_duration_seconds][] לבין Vehicle.route_duration_limit. אם המדיניות Vehicle.route_duration_limit לא מוגדרת, השדה הזה לא יוגדר.

double

היחס המקסימלי בין כל הסוגים של [AggregatedMetrics.max_load][] לבין Vehicle.load_limits המתאים. אם כל השדות של Vehicle.load_limits לא מוגדרים, השדה הזה לא יוגדר.

double

היחס (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time) של רכב נתון. אם המכנה לא קיים, הפונקציה משתמשת במקום זאת ב-(ShipmentModel.global_end_time - ShipmentModel.global_start_time).

bool

אופציונלי. מציין שהמיקום של נקודת הדרך הזו נועד להעדפה שהרכב יעצור בצד מסוים של הכביש. כשמגדירים את הערך הזה, המסלול יעבור דרך המיקום כך שהרכב יוכל לעצור בצד הכביש שהמיקום נוטה אליו ממרכז הכביש. האפשרות הזו לא פועלת במצב הנסיעה WALKING.

bool

מציין שהרכב אמור לעצור בציון הדרך כדי לאסוף או להוריד נוסעים. האפשרות הזו פועלת רק במצב הנסיעה "נהיגה" וכשהערך של location_type הוא location.

ניסיוני: ההתנהגות או הקיום של השדה הזה עשויים להשתנות בעתיד.

Location

נקודה שצוינה באמצעות קואורדינטות גיאוגרפיות, כולל כיוון אופציונלי.

string

מזהה המקום של נקודת העניין שמשויך לציון הדרך.

כשמשתמשים במזהה מקום כדי לציין את מיקום ההגעה או היציאה של VisitRequest, צריך להשתמש במזהה מקום ספציפי מספיק כדי לקבוע מיקום LatLng לניווט למקום. לדוגמה, מזהה מקום שמייצג בניין מתאים, אבל לא מומלץ להשתמש במזהה מקום שמייצג כביש.