Package google.research.middlemileoptimization.v1

אינדקס

MiddleMileOptimization

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

CommitPath

rpc CommitPath(CommitPathRequest) returns (Path)

שומר את הנתיב של משלוח, שמציין שלא ניתן לשנות אותו בעתיד, גם על ידי המשתמש, שמירה לכוח עליון/מעשה אלים שצוין על ידי השיטות MakeVehicleUnavailable, MakeHubUnavailable ו-MakeLineUnavailable. שיטה זו לא משמשת לתיוג גרסה מסוימת של נתיב.
CreateHub

rpc CreateHub(CreateHubRequest) returns (Hub)

יצירת Hub
CreateLine

rpc CreateLine(CreateLineRequest) returns (Line)

יצירת קו.
CreateLineRotation

rpc CreateLineRotation(CreateLineRotationRequest) returns (LineRotation)

יצירת LineRotation.
CreateNetwork

rpc CreateNetwork(CreateNetworkRequest) returns (Network)

יצירת רשת
CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

יוצרים כלי רכב.
DeleteHub

rpc DeleteHub(DeleteHubRequest) returns (Empty)

מחיקת Hub.
DeleteLine

rpc DeleteLine(DeleteLineRequest) returns (Empty)

מוחק שורה.
DeleteLineRotation

rpc DeleteLineRotation(DeleteLineRotationRequest) returns (Empty)

מוחקת LineRotation.
DeleteNetwork

rpc DeleteNetwork(DeleteNetworkRequest) returns (Empty)

מוחקת רשת.
DeleteShipment

rpc DeleteShipment(DeleteShipmentRequest) returns (Empty)

מחיקת משלוח.
DeleteVehicle

rpc DeleteVehicle(DeleteVehicleRequest) returns (Empty)

מוחק רכב.
GetHub

rpc GetHub(GetHubRequest) returns (Hub)

קבלת הפרטים של Hub.
GetLine

rpc GetLine(GetLineRequest) returns (Line)

מקבל את הפרטים של קו.
GetLineRotation

rpc GetLineRotation(GetLineRotationRequest) returns (LineRotation)

מקבלת את הפרטים של LineRotation.
GetNetwork

rpc GetNetwork(GetNetworkRequest) returns (Network)

מקבל את הפרטים של רשת.
GetShipment

rpc GetShipment(GetShipmentRequest) returns (Shipment)

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

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

מקבל את הפרטים של הרכב.
ListHubs

rpc ListHubs(ListHubsRequest) returns (ListHubsResponse)

להצגת רשימה של מרכזים.
ListLineRotations

rpc ListLineRotations(ListLineRotationsRequest) returns (ListLineRotationsResponse)

מציגה את רשימת ה-LineRotations.
ListLines

rpc ListLines(ListLinesRequest) returns (ListLinesResponse)

ליצירת רשימה של השורות.
ListNetworks

rpc ListNetworks(ListNetworksRequest) returns (ListNetworksResponse)

מציגה את הרשת.
ListPaths

rpc ListPaths(ListPathsRequest) returns (ListPathsResponse)

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

rpc ListShipments(ListShipmentsRequest) returns (ListShipmentsResponse)

בתיבת הדו-שיח הזו מפורטים המשלוחים.
ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

בתיבת הדו-שיח הזו מפורטים כלי הרכב.
MakeHubAvailable

rpc MakeHubAvailable(MakeHubAvailableRequest) returns (MakeHubAvailableResponse)

הופך רכזת זמינה.
MakeHubUnavailable

rpc MakeHubUnavailable(MakeHubUnavailableRequest) returns (MakeHubUnavailableResponse)

הופך רכזת ללא זמינה.
MakeLineAvailable

rpc MakeLineAvailable(MakeLineAvailableRequest) returns (MakeLineAvailableResponse)

הופך קו לזמין.
MakeLineUnavailable

rpc MakeLineUnavailable(MakeLineUnavailableRequest) returns (MakeLineUnavailableResponse)

מבטל את הזמינות של קו.
MakeVehicleAvailable

rpc MakeVehicleAvailable(MakeVehicleAvailableRequest) returns (MakeVehicleAvailableResponse)

הופך רכב לזמין.
MakeVehicleUnavailable

rpc MakeVehicleUnavailable(MakeVehicleUnavailableRequest) returns (MakeVehicleUnavailableResponse)

מציין שהרכב לא זמין.
RouteShipment

rpc RouteShipment(RouteShipmentRequest) returns (RouteShipmentResponse)

לנתב משלוח חדש. פעולה זו מרמזת על שינוי מצב.
UpdateHub

rpc UpdateHub(UpdateHubRequest) returns (Hub)

מעדכנים מרכז מידע.
UpdateLine

rpc UpdateLine(UpdateLineRequest) returns (Line)

מעדכן שורה.
UpdateLineRotation

rpc UpdateLineRotation(UpdateLineRotationRequest) returns (LineRotation)

מעדכן LineRotation.
UpdateNetwork

rpc UpdateNetwork(UpdateNetworkRequest) returns (Network)

עדכון רשת.
UpdatePath

rpc UpdatePath(UpdatePathRequest) returns (Path)

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

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

מעדכנות רכב.

AnnotatedPathSegment

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

שדות
segment

PathSegment

חובה. נוספו הערות לקטע.
arrival_time

DateTime

פלט בלבד. מועד ההגעה של הקטע הזה.
departure_time

DateTime

פלט בלבד. שעת היציאה של הפלח הזה.
is_committed

bool

פלט בלבד. האם לקוח ה-API החליט לשמור את החלק הזה בנתיב.
segment_cost_constant

double

פלט בלבד. עלות קבועה לפלח הזה.
segment_cost_due_to_vehicle

map<string, double>

פלט בלבד. רשומה אחת לכל מאפיין.
segment_cost_due_to_departure

double

פלט בלבד. עלות עקב סיבוב הקו: יציאה.
segment_cost_due_to_arrival

double

פלט בלבד. עלות עקב סיבוב הקו: הגעה.

CommitPathRequest

הודעת הבקשה ל-method CommitPath.

שדות
name

string

חובה. שם המשלוח שאת הנתיב שלו צריך להעביר. פורמט: "networks/{network}/shipments/{shipment}"
שדה איחוד path_to_commit. הנתיב או חלקים מהנתיב שצריך להקצות. path_to_commit יכול להיות רק אחת מהאפשרויות הבאות:
complete_shipment_path

PathToCommit

הפלחים של נתיב ממקור ליעד.
segments

IncompletePathToCommit

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

IncompletePathToCommit

חלק מהנתיב בהתחייבות, כלומר קטעים בין המקור ליעד.

שדות
segments[]

PathSegment

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

PathToCommit

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

שדות
segments[]

PathSegment

חובה. הפלחים חייבים להיות בסדר, ממקור ליעד.

CreateHubRequest

הודעת הבקשה ל-method CreateHub.

שדות
parent

string

חובה. משאב ההורה שבו ייווצר המרכז הזה. פורמט: "networks/{network}"
hub_id

string

חובה. המזהה של ה-Hub ליצירה.
hub

Hub

חובה. המרכז ליצירה.

CreateLineRequest

הודעת הבקשה ל-method CreateLine.

שדות
parent

string

חובה. משאב ההורה שבו תיווצר השורה. פורמט: "networks/{network}"
line_id

string

חובה. מזהה השורה שיש ליצור.
line

Line

חובה. השורה שיש ליצור.

CreateLineRotationRequest

הודעת הבקשה ל-method CreateLineRotation.

שדות
parent

string

חובה. משאב ההורה שבו ייווצר סבב הקו הזה. פורמט: "networks/{network}/lines/{line}"
line_rotation_id

string

חובה. המזהה של סבב השורות שיש ליצור.
line_rotation

LineRotation

חובה. סיבוב הקו שיש ליצור.

CreateNetworkRequest

הודעת הבקשה ל-method CreateNetwork.

שדות
network_id

string

חובה. מזהה הרשת שברצונך ליצור.
network

Network

חובה. הרשת שיש ליצור.

CreateVehicleRequest

הודעת הבקשה ל-method CreateVehicle.

שדות
parent

string

חובה. משאב ההורה שבו ייווצר הרכב הזה. פורמט: "networks/{network}"
vehicle_id

string

חובה. המזהה של הרכב שצריך ליצור.
vehicle

Vehicle

חובה. כלי הרכב ליצירה.

CrossDockingCapacity

קיבולת כוללת של העברה בין מסמכים ב-Docker של רכזת.

שדות
capacity_per_hour[]

ValueDimension

זה שינוי אופציונלי. קיבולת של עגינה מוצלבת לכל מימד.

CrossDockingTime

משך זמן כולל של העברה בין פרוטוקולים של Hub.

שדות
time_constant

Duration

זה שינוי אופציונלי. זמן קבוע לפעולת חוצה-קישור.
time

SeparableNDFunction

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

DateTimeRange

טווח הזמנים בין שני תאריכים ב-DateTime. לציון תאריך ספציפי, השתמשו בערך start == end.

google/type/interval.proto משרת מטרה דומה, אבל עם הזמן הפיזי (אכפת לנו רק מהזמן האזרחי).

שדות
first_date

DateTime

תחילת הטווח.
last_date

DateTime

סוף הטווח

DeleteHubRequest

הודעת הבקשה ל-method DeleteHub.

שדות
name

string

חובה. שם ה-Hub שרוצים למחוק. פורמט: "networks/{network}/hubs/{hub}"

DeleteLineRequest

הודעת הבקשה ל-method DeleteLine.

שדות
name

string

חובה. שם השורה למחיקה. פורמט: "networks/{network}/lines/{line}"
force

bool

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

DeleteLineRotationRequest

הודעת הבקשה ל-method DeleteLineRotation.

שדות
name

string

חובה. השם של סיבוב הקו שרוצים למחוק. פורמט: "networks/{network}/lines/{line}/rotations/{rotation}"

DeleteNetworkRequest

הודעת הבקשה ל-method DeleteNetwork.

שדות
name

string

חובה. שם הרשת למחיקה. פורמט: "networks/{network}"
force

bool

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

DeleteShipmentRequest

הודעת הבקשה ל-method DeleteShipment.

שדות
name

string

חובה. שם המשלוח שרוצים למחוק. פורמט: "networks/{network}/shipments/{shipment}"

DeleteVehicleRequest

הודעת הבקשה ל-method DeleteVehicle.

שדות
name

string

חובה. שם הרכב שרוצים למחוק. פורמט: "networks/{network}/vehicles/{vehicle}"

DistanceMatrixEntry

המרחק בין מרכז מקור למרכז יעד.

שדות
source_hub

string

חובה. מרכז המקור.
destination_hub

string

חובה. מרכז היעד.
weights[]

ValueDimension

חובה. המרחק בין המרכזים, הנמדד במספר מימדים.

EarlinessTardiness

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

שדות
maximum_earliness

Duration

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

Duration

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

Function1D

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

Function1D

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

פונקציה1D

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

שדות
שדה איחוד function. אחדות הארגומנט של הפונקציה אמורה להיות: - אם משקל: kg - אם זמן: min - אם מספר משטחים: function 1 יכול להיות רק אחת מהאפשרויות הבאות:
constant

double

הפונקציה היא קבוע.
pwl

PieceWiseAffineFunction

הפונקציה היא ליניארית חלקית.

GeneratedLineAndRotation

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

שדות
arrival_times

map<string, DateTime>

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

map<string, DateTime>

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

GetHubRequest

הודעת הבקשה ל-method GetHub.

שדות
name

string

חובה. שם ה-Hub שיש לאחזר. פורמט: "networks/{network}/hubs/{hub}"

GetLineRequest

הודעת הבקשה ל-method GetLine.

שדות
name

string

חובה. שם הרשת לאחזור. פורמט: "networks/{network}/lines/{line}"

GetLineRotationRequest

הודעת הבקשה ל-method GetLineRotation.

שדות
name

string

חובה. שם סיבוב הקו לאחזור. פורמט: "networks/{network}/lines/{line}/rotations/{rotation}"

GetNetworkRequest

הודעת הבקשה ל-method GetNetwork.

שדות
name

string

חובה. שם הרשת לאחזור. פורמט: "networks/{network}"

GetShipmentRequest

הודעת הבקשה ל-method GetShipment.

שדות
name

string

חובה. שם המשלוח שצריך לאחזר. פורמט: "networks/{network}/shipments/{shipment}"

GetVehicleRequest

הודעת הבקשה ל-method GetVehicle.

שדות
name

string

חובה. שם הרכב שצריך לאחזר. פורמט: "networks/{network}/vehicles/{vehicle}"

קהילה

צריך להביא משלוחים ממרכז אחד למרכז אחר.

שדות
name

string

חובה. מזהה. לא ניתן לעדכן.
position

LatLng

זה שינוי אופציונלי. מיקום לחישוב נתיבים בעולם האמיתי.
opening_times[]

DateTimeRange

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

CrossDockingCapacity

זה שינוי אופציונלי. הקיבולת של כל המרכז.
cross_docking_time

CrossDockingTime

זה שינוי אופציונלי. זמן לביצוע פעולה אחת בהצפנה מוצלבת (לכל רכב).

IntegerRange

טווח של מספרים שלמים.

שדות
start_value

int32

ההפוגה פתוחה אם היא לא מוגדרת.
end_value

int32

ההפוגה פתוחה אם היא לא מוגדרת.

קו

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

שדות
name

string

חובה. מזהה. לא ניתן לעדכן.
hub_ids[]

string

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

LineRotation

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

שדות
name

string

חובה. מזהה. לא ניתן לעדכן.
arrival_times

map<string, DateTimeRange>

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

map<string, DateTimeRange>

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

map<string, EarlinessTardiness>

זה שינוי אופציונלי. עלויות של שעת ההכנה/האיחור ועלויות הנסיעה. המפה הזו אמורה לכלול את אותם המפתחות (להוציא את מרכז היעד, ללא זמן יציאה).
arrival_earliness_tardiness_costs

map<string, EarlinessTardiness>

זה שינוי אופציונלי. עלויות שעת ההגעה/איחור ועלויות ההגעה. המפה הזו אמורה לכלול את אותם המפתחות (להוציא את מרכז המקור, ללא זמן הגעה).
vehicles[]

string

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

PricingStrategy

זה שינוי אופציונלי. העלות של רכב כלשהו בקו הזה, ללא קשר לרכב (נהג, תחזוקה וכו').
maximum_number_vehicles

IntegerRange

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

ListHubsRequest

הודעת הבקשה ל-method ListHubs.

שדות
parent

string

חובה. ההורה שהוא הבעלים של אוסף המרכזים האלה. פורמט: "networks/{network}"
page_size

int32

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

string

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

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

ListHubsResponse

הודעת התשובה ל-method ListHubs.

שדות
hubs[]

Hub

המרכזים מהרשת שצוינה.
next_page_token

string

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

ListLineRotationsRequest

הודעת הבקשה ל-method ListLineRotations.

שדות
parent

string

חובה. ההורה, שהוא הבעלים של אוסף סבבי הקווים הזה. פורמט: "networks/{network}/lines/{line}"
page_size

int32

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

string

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

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

ListLineRotationsResponse

הודעת התשובה ל-method ListLineRotations.

שדות
line_rotations[]

LineRotation

הקו מסתובב מהרשת והקו שצוינו.
next_page_token

string

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

ListLinesRequest

הודעת הבקשה ל-method ListLines.

שדות
parent

string

חובה. ההורה שהוא הבעלים של אוסף השורות הזה. פורמט: "networks/{network}"
page_size

int32

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

string

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

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

ListLinesResponse

הודעת התשובה ל-method ListLines.

שדות
lines[]

Line

השורות מהרשת שצוינה.
next_page_token

string

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

ListNetworksRequest

הודעת הבקשה ל-method ListNetworks.

שדות
page_size

int32

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

string

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

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

ListNetworksResponse

הודעת התשובה ל-method ListNetworks.

שדות
networks[]

Network

רשימת הרשתות.
next_page_token

string

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

ListPathsRequest

הודעת הבקשה ל-method ListPaths.

שדות
parent

string

חובה. שם הרשת שאליה צריך לשלוח את הנתיבים. פורמט: "networks/{network}"
page_size

int32

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

string

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

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

ListPathsResponse

הודעת התשובה ל-method ListPaths.

שדות
paths[]

Path

רשימת הנתיבים.
next_page_token

string

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

ListShipmentsRequest

הודעת הבקשה ל-method ListShipments.

שדות
parent

string

חובה. ההורה שהוא הבעלים של אוסף המשלוחים הזה. פורמט: "networks/{network}"
page_size

int32

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

string

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

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

ListShipmentsResponse

הודעת התשובה ל-method ListShipments.

שדות
shipments[]

Shipment

המשלוחים מהרשת שצוינה.
next_page_token

string

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

ListVehiclesRequest

הודעת הבקשה ל-method ListVehicles.

שדות
parent

string

חובה. ההורה שהוא הבעלים של אוסף כלי הרכב הזה. פורמט: "networks/{network}"
page_size

int32

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

string

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

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

ListVehiclesResponse

הודעת התשובה ל-method ListVehicles.

שדות
vehicles[]

Vehicle

כלי הרכב מהרשת שצוינה.
next_page_token

string

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

MakeHubAvailableRequest

הודעת הבקשה ל-method MakeHubAvailable.

שדות
name

string

חובה. שם ה-Hub שיהיה זמין. פורמט: "networks/{network}/hubs/{hub}"
availability_starts[]

DateTime

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

MakeHubAvailableResponse

הודעת התשובה ל-method MakeHubAvailable.

שדות
name

string

שם ה-Hub שסטטוס הזמינות שלו לא עודכן. פורמט: "networks/{network}/hubs/{hub}"
path[]

Path

הנתיבים שעודכנו.

MakeHubUnavailableRequest

הודעת הבקשה ל-method MakeHubUnavailable.

שדות
name

string

חובה. שם ה-Hub שלא זמין. פורמט: "networks/{network}/hubs/{hub}"
unavailability_starts[]

DateTime

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

MakeHubUnavailableResponse

הודעת התשובה ל-method MakeHubUnavailable.

שדות
name

string

שם ה-Hub שסטטוס הזמינות שלו לא עודכן. פורמט: "networks/{network}/hubs/{hub}"
path[]

Path

הנתיבים שעודכנו.

MakeLineAvailableRequest

הודעת הבקשה ל-method MakeHubAvailable.

שדות
name

string

חובה. שם הקו כדי להפוך לזמין. פורמט: "networks/{network}/lines/{line}"
availability_starts[]

DateTime

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

MakeLineAvailableResponse

הודעת התשובה ל-method MakeLineAvailable.

שדות
name

string

שם השורה שסטטוס הזמינות שלה עודכן. פורמט: "networks/{network}/lines/{line}"
path[]

Path

הנתיבים שעודכנו.

MakeLineUnavailableRequest

הודעת הבקשה ל-method MakeLineUnavailable.

שדות
name

string

חובה. שם השורה שלא תהיה זמינה. פורמט: "networks/{network}/lines/{line}"
unavailability_starts[]

DateTime

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

MakeLineUnavailableResponse

הודעת התשובה ל-method MakeLineUnavailable.

שדות
name

string

שם השורה שסטטוס הזמינות שלה עודכן. פורמט: "networks/{network}/lines/{line}"
path[]

Path

הנתיבים שעודכנו.

MakeVehicleAvailableRequest

הודעת הבקשה ל-method MakeVehicleAvailable.

שדות
name

string

חובה. שם הרכב שצריך לספק. פורמט: "networks/{network}/vehicle/{vehicle}"
availability_starts[]

DateTime

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

MakeVehicleAvailableResponse

הודעת התשובה ל-method MakeVehicleAvailable.

שדות
name

string

שם הרכב והזמינות שלו עודכנה. פורמט: "networks/{network}/vehicles/{vehicle}"
path[]

Path

הנתיבים שעודכנו.

MakeVehicleUnavailableRequest

הודעת הבקשה ל-method MakeVehicleUnavailable.

שדות
name

string

חובה. שם הרכב שלא זמין. פורמט: "networks/{network}/vehicles/{vehicle}"
unavailability_starts[]

DateTime

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

MakeVehicleUnavailableResponse

הודעת התשובה ל-method MakeVehicleUnavailable.

שדות
name

string

שם הרכב שסטטוס הזמינות שלו עודכן. פורמט: "networks/{network}/vehicles/{vehicle}"
path[]

Path

הנתיבים שעודכנו.

רשת

מתאר את הרשת המלאה הקיימת שבה ניתן להשתמש. ללקוח API נתון יכולות להיות כמה רשתות (למשל, הרשת הראשית ושינוי עתידי אפשרי לבדיקה).

שדות
name

string

חובה. מזהה. לא ניתן לעדכן.
dimensions[]

ValueDimension

מרחק, משקל, משטחים וכו', וגם קנה מידה (למיפוי מספר ממשי (float) למספרים שלמים).
pricing

PricingStrategy

זה שינוי אופציונלי. המחיר שהשולח ישלם עבור משלוח שלא צריך ליצור בו שורה ייעודית.
currency_code

string

זה שינוי אופציונלי. יחידה כספית יחידה בשימוש בכל הרשת. לקוח API נתון יכול לכלול מספר יחידות שונות עבור רשתות שונות. רשת יכולה להכיל רק יחידה כספית אחת. יש לקודד את היחידה בתקן ISO 4217, למשל google3/google/type/money.proto.
time_step

Duration

זה שינוי אופציונלי. הפרש זמן. ההחלטות מתקבלות ברמת הדיוק הזו בזמן. באופן פנימי, המצב נשמר בדיוק לפי אותו הערך.
distance_matrix[]

DistanceMatrixEntry

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

נתיב

נתיב למשלוח בתוך הרשת.

שדות
shipment

string

חובה. משלוח שהנתיב שלו מתואר.
segments[]

AnnotatedPathSegment

חובה. קטעים של הנתיב.
departure_time

DateTime

פלט בלבד. זמן היציאה בפועל של המשלוח.
arrival_time

DateTime

פלט בלבד. זמן ההגעה בפועל של המשלוח.
incurred_penalties

double

פלט בלבד. לא יכובדו עונשים בגלל אילוצים רכים.
cost_constant

double

פלט בלבד. עלות קבועה למשלוח הזה.
cost

map<string, double>

פלט בלבד. עלות לפי רכיבים.

PathSegment

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

שדות
source_hub

string

חובה. מקור הפלח.
destination_hub

string

חובה. היעד של הפלח.
line

string

חובה. הקו נוסף לקטע הזה.
line_rotation

string

חובה. מתבצע מעקב אחר סבב של הפלח הזה.
vehicle

string

חובה. רכב ואחריו הקטע הזה.

PieceWiseAffineFunction

פונקציה לינארית בחלקה, מוגבלת לארגומנט אחד. עיצוב שדומה לדוגמה הבאה: https://github.com/google/or-tools/blob/stable/ortools/util/piecewise_linear_function.h

שדות
segments[]

PieceWiseAffineSegment

קטעים לינאריים של הפונקציה.

PieceWiseAffineSegment

קטע אחד של פונקציה לינארית חלקית.

שדות
start_x

double

תחילת הקטע: x.
start_y

double

תחילת הקטע: y.
end_x

double

סוף הקטע: x.
end_y

double

סוף הקטע: y.

PricingStrategy

אסטרטגיית תמחור.

שדות
שדה איחוד pricing_strategy. אסטרטגיית תמחור. pricing_strategy יכול להיות רק אחת מהאפשרויות הבאות:
separable

SeparableNDFunction

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

RouteShipmentRequest

הודעת הבקשה ל-method RouteShipment.

שדות
parent

string

חובה. ההורה, הרשת שאליה צריך לנתב את המשלוח. פורמט: "networks/{network}"
shipment

Shipment

חובה. המשלוח לניתוב.

RouteShipmentResponse

הודעת התשובה ל-method RouteShipment.

שדות
shipment

Shipment

המשלוח שנוצר עכשיו.
paths[]

Path

הנתיבים שהשתנו עקב ניתוב המשלוח. השדה הזה כולל לפחות רשומה אחת – הנתיב של המשלוח שצריך לנתב. הוא עשוי להכיל עוד נתיבים למשלוחים אחרים, המשקפים שינויים פנימיים במדינה.
lines[]

GeneratedLineAndRotation

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

SeparableNDFunction

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

שדות
components

map<string, Function1D>

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

double

חלק קבוע של הפונקציה.

משלוח

משלוח לביצוע.

שדות
name

string

חובה. מזהה. לא ניתן לעדכן.
source_hub

string

חובה. המרכז שבו המשלוח זמין.
destination_hub

string

חובה. המרכז שאליו צריך לשלוח את המשלוח.
departure_time

DateTime

חובה. שעת היציאה.
arrival_time

DateTimeRange

חובה. זמן ההגעה הצפוי (כלומר, עומס רך).
arrival_earliness_tardiness_cost

EarlinessTardiness

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

ValueDimension

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

double

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

UpdateHubRequest

הודעת הבקשה ל-method UpdateHub.

שדות
hub

Hub

חובה. ה-Hub שצריך לעדכן.

השדה name של ה-Hub משמש לזיהוי ה-Hub שרוצים לעדכן. פורמט: "networks/{network}/hubs/{hub}"
update_mask

FieldMask

זה שינוי אופציונלי. רשימת השדות לעדכון.

UpdateLineRequest

הודעת הבקשה ל-method UpdateLine.

שדות
line

Line

חובה. השורה שצריך לעדכן.

השדה name בשורה משמש לזיהוי הקו שיש לעדכן. פורמט: "networks/{network}/lines/{line}"
update_mask

FieldMask

זה שינוי אופציונלי. רשימת השדות לעדכון.

UpdateLineRotationRequest

הודעת הבקשה ל-method UpdateLineRotation.

שדות
line_rotation

LineRotation

חובה. הרשת שצריך לעדכן.

השדה name של הסיבוב משמש לזיהוי הסיבוב שיש לעדכן. פורמט: "networks/{network}/lines/{line}/rotations/{rotation}"
update_mask

FieldMask

זה שינוי אופציונלי. רשימת השדות לעדכון.

UpdateNetworkRequest

הודעת הבקשה ל-method UpdateNetwork.

שדות
network

Network

חובה. הרשת שצריך לעדכן.

השדה name של הרשת משמש לזיהוי הרשת שצריך לעדכן. פורמט: "networks/{network}"
update_mask

FieldMask

זה שינוי אופציונלי. רשימת השדות לעדכון.

UpdatePathRequest

הודעת הבקשה ל-method UpdatePath.

שדות
path

Path

חובה. הנתיב החדש למשלוח.

UpdateVehicleRequest

הודעת הבקשה ל-method UpdateVehicle.

שדות
vehicle

Vehicle

חובה. הרכב שצריך לעדכן.

השדה name של הרכב משמש לזיהוי הרכב שצריך לעדכן. פורמט: "networks/{network}/vehicles/{vehicle}"
update_mask

FieldMask

זה שינוי אופציונלי. רשימת השדות לעדכון.

ValueDimension

ערך לאורך מאפיין אחד שהוגדר מראש. השדה value חייב להיות מוגדר לסוג המתאים של dimension.

שדות
value

int64

זה שינוי אופציונלי. ערך.
dimension

string

חובה. מאפיין.

כלי רכב

אין שם, הוא מאוחסן כמפתח מפה ברשת.

שדות
name

string

חובה. מזהה. לא ניתן לעדכן.
capacities[]

ValueDimension

זה שינוי אופציונלי. מאפייני הרכב.
cost

PricingStrategy

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

PricingStrategy

זה שינוי אופציונלי. המחיר שישולם על ידי הצד המשלם, רק אם נעשה שימוש ברכב בשורה שנוצרה (כלומר, לא חלק מרשת הקלט).
allowed_for_generated_lines

bool

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

VehiclePositionConstraint

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

VehiclePositionConstraint

הגבלה על המיקום של כלי הרכב.

שדות
time

DateTime

שעת האילוץ.
hub_id

string

מרכז האילוץ.