לנתב משלוח חדש. פעולה זו מרמזת על שינוי מצב.
בקשת HTTP
POST https://middlemileoptimization.googleapis.com/v1/{parent=networks/*}/shipments:route
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
parent |
חובה. ההורה, הרשת שאליה צריך לנתב את המשלוח. פורמט: "networks/{network}" |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| ייצוג JSON |
|---|
{
"shipment": {
object ( |
| שדות | |
|---|---|
shipment |
חובה. המשלוח לניתוב. |
גוף התשובה
הודעת התשובה לשיטה shipments.route.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
| ייצוג JSON |
|---|
{ "shipment": { object ( |
| שדות | |
|---|---|
shipment |
המשלוח שנוצר עכשיו. |
paths[] |
הנתיבים שהשתנו עקב ניתוב המשלוח. השדה הזה כולל לפחות רשומה אחת – הנתיב של המשלוח שצריך לנתב. הוא עשוי להכיל עוד נתיבים למשלוחים אחרים, המשקפים שינויים פנימיים במדינה. |
lines[] |
סבבי הקו שנוצרו במהלך ניתוב המשלוח. המקום יכול להיות ריק או להכיל רוטציה למשלוחים אחרים, מה שמשקף שינויים פנימיים במדינה. |
GeneratedLineAndRotation
סבב אחד של קו שנוצר על ידי ה-API הזה ולא על ידי לקוח ה-API. מטבעה, היא מוגבלת פחות ואפשר להשתמש בכל רכב (אלא אם לקוח ה-API יחליט אחרת בקריאות הבאות).
| ייצוג JSON |
|---|
{ "arrivalTimes": { string: { object ( |
| שדות | |
|---|---|
arrivalTimes |
פלט בלבד. מיפוי בין מזהים של מוקדים וזמנים. המפה הזו אמורה לכלול את אותם המפתחות (ללא מרכז המקור, ללא זמן הגעה). אובייקט שמכיל רשימה של |
departureTimes |
פלט בלבד. מיפוי בין מזהים של מוקדים וזמנים. המפה הזו אמורה לכלול את אותם המקשים (פחות מרכז היעד, ללא זמן יציאה). אובייקט שמכיל רשימה של |