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

عملية تدوير واحدة للسطر الذي يتم إنشاؤه بواسطة واجهة برمجة التطبيقات هذه وليس عميل واجهة برمجة التطبيقات وهي بطبيعتها أقل تقييدًا، ويمكنها استخدام أي مركبة (ما لم يقرر عميل واجهة برمجة التطبيقات خلاف ذلك في الطلبات اللاحقة).

تمثيل 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" }