Method: projects.batchOptimizeTours

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

השיטה הזו היא פעולה ממושכת (LRO). הנתונים שמוזנים לאופטימיזציה (הודעות OptimizeToursRequest) והנתונים שמתקבלים ממנה (הודעות OptimizeToursResponse) נקראים מ-Cloud Storage ונכתבים בו בפורמט שצוין על ידי המשתמש. בדומה לשיטה projects.optimizeTours, כל OptimizeToursRequest מכיל ShipmentModel ומחזיר OptimizeToursResponse שמכיל שדות ShipmentRoute, שהם קבוצה של מסלולים לביצוע על ידי כלי רכב שממזערים את העלות הכוללת.

המשתמש יכול לבצע שאילתת polling אל operations.get כדי לבדוק את הסטטוס של LRO:

אם השדה done LRO הוא false, סימן שלפחות בקשה אחת עדיין נמצאת בתהליך. יכול להיות שבקשות אחרות הושלמו בהצלחה והתוצאות שלהן זמינות ב-Cloud Storage.

אם השדה done של LRO הוא true, סימן שכל הבקשות עובדו. התוצאות של כל הבקשות שעובדו בהצלחה יהיו זמינות ב-Cloud Storage. התוצאות של בקשות שנכשלו לא יהיו זמינות ב-Cloud Storage. אם השדה error של ה-LRO מוגדר, הוא מכיל את השגיאה מאחת הבקשות שנכשלו.

בקשת HTTP

POST https://routeoptimization.googleapis.com/v1/{parent=projects/*}:batchOptimizeTours

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
parent

string

חובה. פרויקט ומיקום לטירגוט כדי לבצע קריאה.

פורמט:

  • projects/{project-id}
  • projects/{project-id}/locations/{location-id}

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

גוף הבקשה

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

ייצוג ב-JSON 
{
  "modelConfigs": [
    {
      object (AsyncModelConfig)
    }
  ]
}
שדות
modelConfigs[]

object (AsyncModelConfig)

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

גוף התשובה

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

היקפי הרשאה

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

הרשאות IAM

נדרשת הרשאת IAM הבאה במשאב parent:

  • routeoptimization.operations.create

מידע נוסף מופיע במאמרי העזרה בנושא IAM.