Method: networks.shipments.route

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

בקשת HTTP

POST https://middlemileoptimization.googleapis.com/v1/{parent=networks/*}/shipments:route

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

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

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON
{
  "shipment": {
    object (Shipment)
  }
}
שדות
shipment

object (Shipment)

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

גוף התשובה

הודעת התשובה לשיטה shipments.route.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON
{
  "shipment": {
    object (Shipment)
  },
  "paths": [
    {
      object (Path)
    }
  ],
  "lines": [
    {
      object (GeneratedLineAndRotation)
    }
  ]
}
שדות
shipment

object (Shipment)

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

paths[]

object (Path)

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

lines[]

object (GeneratedLineAndRotation)

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

GeneratedLineAndRotation

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

ייצוג JSON
{
  "arrivalTimes": {
    string: {
      object (DateTime)
    },
    ...
  },
  "departureTimes": {
    string: {
      object (DateTime)
    },
    ...
  }
}
שדות
arrivalTimes

map (key: string, value: object (DateTime))

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

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

departureTimes

map (key: string, value: object (DateTime))

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

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.