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 של 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 הוא true (ראו הערה 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/11, המדיניות הזו מאכלסת רק את הקווים המקוטעים של מסלולים לא ריקים, ונדרש שהמדיניות populate_polylines תוגדר ל-True.

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

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

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

bool

אם התנאי מתקיים:

• משתמש ב-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/01.

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) כי השגיאה החדשה הסתירה את השגיאה הישנה. לדוגמה, ראו את הקטע 'שגיאות מרובות'.

string

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

FieldReference

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

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

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

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/10, יש תמיכה בנתיבי מעקף רק אם משך הנסיעה לא תלוי ברכב.

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/10, יש תמיכה בנתיבי מעקף רק אם משך הנסיעה לא תלוי ברכב.

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 ו-locB.
• רכב אחד שמתחיל את המסלול שלו במיקום א' ומסיים אותו במיקום א'.
• בקשת ביקור אחת לאיסוף במיקום ב'.

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.
• רכב אחד מתחיל את המסלול במיקום א' ומסיים אותו במיקום ב', באמצעות מטריצה 'מהירה'.
• רכב אחד מתחיל את המסלול במיקום locB ומסיים אותו במיקום locB, באמצעות מטריצה 'slow'.
• רכב אחד שמתחיל את המסלול שלו במיקום locB ומסיים אותו במיקום locB, באמצעות מטריצה 'מהירה'.
• בקשת ביקור אחת לאיסוף במיקום locC.

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_type לא תואמים (ראו 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

מציין אם האירוע 'first' הוא מסירה.

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/01.

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

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

ביקור במקור או התנעה של כלי רכב נחשבים להתאמה אם השדה 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 של 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, הרכב הזה איטי יותר וזמני הנסיעה שלו כפולים מאלה של רכבים רגילים. המכפיל הזה לא משפיע על משך הביקור, אבל הוא משפיע על העלות אם מציינים את 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.soft_max_load כל העלויות מצטברות וצריכות להיות באותה יחידה כמו 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

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

bool

השדה מציין שנקודת הציון מיועדת לעצירת רכבים, במטרה לאסוף או להוריד. אפשרות זו פועלת רק במצב הנסיעה 'DRIVING' (נהיגה), וכשהערך של location_type הוא 'location' (מיקום).

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

Location

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

string

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

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