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 יחולו על כל הרכבים שלא צוינו ב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

אם הערך הוא 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, כשמגדירים את השדה ShipmentRoute.has_traffic_infeasibilities וכשמחשבים את השדה OptimizeToursResponse.total_cost.vehicle_end_time

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

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

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

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