‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

Method: projects.optimizeTours

בקשת HTTP
פרמטרים של נתיב
גוף הבקשה
- ייצוג JSON
גוף התשובה
היקפי ההרשאות
הרשאות IAM

הפונקציה שולחת OptimizeToursRequest עם ערך ShipmentModel ומחזירה ערך של OptimizeToursResponse שמכיל ShipmentRoutes, שהם קבוצת מסלולים שכלי רכב יכולים לבצע כדי לצמצם את העלות הכוללת.

מודל ShipmentModel מורכב בעיקר מ-Shipment שצריך לבצע ומ-Vehicle שאפשר להשתמש בהם כדי להעביר את ה-Shipment. ShipmentRoute מקצים Shipment ל-Vehicle. באופן ספציפי יותר, הם מקצים לכל רכב סדרה של Visit, כאשר Visit תואם ל-VisitRequest, שהוא איסוף או מסירה של Shipment.

המטרה היא להקצות הקצאות של ShipmentRoute ל-Vehicle כדי לצמצם את העלות הכוללת במקרים שבהם לעלות יש רכיבים רבים שמוגדרים בShipmentModel.

בקשת HTTP

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

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

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

פרמטרים

פרמטרים
`parent`	`string` חובה. בוחרים את הפרויקט או המיקום שאליהם רוצים להתקשר. פורמט: * `projects/{project-id}` * `projects/{project-id}/locations/{location-id}` אם לא מציינים מיקום, המערכת בוחרת אזור באופן אוטומטי.

parent

string

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

פורמט: * projects/{project-id} * projects/{project-id}/locations/{location-id}

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

גוף הבקשה

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "timeout": string, "model": { object (`ShipmentModel`) }, "solvingMode": enum (`SolvingMode`), "searchMode": enum (`SearchMode`), "injectedFirstSolutionRoutes": [ { object (`ShipmentRoute`) } ], "injectedSolutionConstraint": { object (`InjectedSolutionConstraint`) }, "refreshDetailsRoutes": [ { object (`ShipmentRoute`) } ], "interpretInjectedSolutionsUsingLabels": boolean, "considerRoadTraffic": boolean, "populatePolylines": boolean, "populateTransitionPolylines": boolean, "allowLargeDeadlineDespiteInterruptionRisk": boolean, "useGeodesicDistances": boolean, "label": string, "geodesicMetersPerSecond": number, "maxValidationErrors": integer }

{
  "timeout": string,
  "model": {
    object (ShipmentModel)
  },
  "solvingMode": enum (SolvingMode),
  "searchMode": enum (SearchMode),
  "injectedFirstSolutionRoutes": [
    {
      object (ShipmentRoute)
    }
  ],
  "injectedSolutionConstraint": {
    object (InjectedSolutionConstraint)
  },
  "refreshDetailsRoutes": [
    {
      object (ShipmentRoute)
    }
  ],
  "interpretInjectedSolutionsUsingLabels": boolean,
  "considerRoadTraffic": boolean,
  "populatePolylines": boolean,
  "populateTransitionPolylines": boolean,
  "allowLargeDeadlineDespiteInterruptionRisk": boolean,
  "useGeodesicDistances": boolean,
  "label": string,
  "geodesicMetersPerSecond": number,
  "maxValidationErrors": integer
}

שדות
`timeout`	`string (Duration format)` אם מוגדר הזמן הקצוב הזה, השרת מחזיר תגובה לפני שחולף הזמן הקצוב לתפוגה או לפני המועד האחרון של השרת לבקשות סינכרוניות, המוקדם מביניהם. בבקשות אסינכררוניות, השרת ייצור פתרון (אם אפשר) לפני שפג תוקף הזמן הקצוב. משך הזמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-'`s`'. דוגמה: `"3.5s"`.
`model`	`object (ShipmentModel)` מודל המשלוח לפתרון.
`solvingMode`	`enum (SolvingMode)` כברירת מחדל, מצב הפתרון הוא `DEFAULT_SOLVE` (0).
`searchMode`	`enum (SearchMode)` מצב החיפוש ששימש לפתרון הבקשה.
`injectedFirstSolutionRoutes[]`	`object (ShipmentRoute)` נדריך את אלגוריתם האופטימיזציה כדי למצוא פתרון ראשון שדומה לפתרון קודם. המודל מוגבל בזמן בניית הפתרון הראשון. כל משלוחים שלא בוצעו במסלול מסוים יועברו אוטומטית לשלב הבא בפתרון, אבל יכול להיות שהם יבוצעו בפתרון הבא. הפתרון חייב לעמוד בכמה הנחות בסיסיות לגבי תוקף: בכל המסלולים, `vehicleIndex` חייב להיות בטווח ולא להיות משוכפל. לכל הביקורים, `shipmentIndex` ו-`visitRequestIndex` חייבים להיות בטווח. אפשר להפנות למשלוח רק במסלול אחד. האיסוף של משלוח עם איסוף והעברה צריך להתבצע לפני המסירה. מותר לבצע משלוח או יותר מחלופה אחת לאיסוף או למשלוח. בכל המסלולים, הזמנים הולכים וגדלים (כלומר, `vehicleStartTime <= visits[0].start_time <= visits[1].start_time ... <= vehicleEndTime`). אפשר לבצע משלוח רק ברכב מורשה. מותר להשתמש ברכב אם השדה `Shipment.allowed_vehicle_indices` ריק או שהשדה `vehicleIndex` שלו נכלל בשדה `Shipment.allowed_vehicle_indices`. אם הפתרון שהוחדר לא בר-ביצוע, לא בהכרח תוחזר שגיאת אימות, וייתכן שתוחזר שגיאה שמציינת כי לא ניתן לבצע את הבדיקה.
`injectedSolutionConstraint`	`object (InjectedSolutionConstraint)` להגביל את אלגוריתם האופטימיזציה כדי למצוא פתרון סופי שדומה לפתרון קודם. לדוגמה, אפשר להשתמש באפשרות הזו כדי להקפיא חלקים של מסלולים שכבר הושלמו או שעוד צריך להשלים אבל אסור לשנות אותם. אם הפתרון שהוזן לא מתאים, לא בהכרח תוחזר שגיאת אימות. יכול להיות שתוחזר שגיאה שמציינת את חוסר ההתאמה.
`refreshDetailsRoutes[]`	`object (ShipmentRoute)` אם המסלולים הנתונים לא ריקים, המערכת תרענן את המסלולים שלהם בלי לשנות את רצף הביקורים או את זמני הנסיעה הבסיסיים שלהם: רק פרטים אחרים יעודכנו. הפעולה הזו לא פותרת את המודל. נכון ל-11 בנובמבר 2020, הפונקציה מאכלסת רק את הקווים הפוליגונליים של מסלולים שאינם ריקים, וצריך שהערך של `populatePolylines` יהיה True. יכול להיות ששדות `routePolyline` של המסלולים המועברים לא יהיו תואמים למסלול `transitions`. אסור להשתמש בשדה הזה יחד עם `injectedFirstSolutionRoutes` או `injectedSolutionConstraint`. ל-`Shipment.ignore` ול-`Vehicle.ignore` אין השפעה על ההתנהגות. קווים פוליגונים עדיין מאוכלסים בין כל הביקורים בכל המסלולים שאינם ריקים, גם אם מתעלמים מהמשלוחים או מהרכבים הקשורים.
`interpretInjectedSolutionsUsingLabels`	`boolean` אם הערך הוא True: נעשה שימוש ב-`ShipmentRoute.vehicle_label` במקום ב-`vehicleIndex` כדי להתאים מסלולים בפתרון שהוחדר עם כלי רכב בבקשה. המערכת עושה שימוש חוזר במיפוי של `ShipmentRoute.vehicle_index` המקורי ל-`ShipmentRoute.vehicle_index` חדש כדי לעדכן את `ConstraintRelaxation.vehicle_indices` אם הוא לא ריק, אבל המיפוי חייב להיות חד-משמעי (כלומר, מספר `ShipmentRoute`s לא יכול להיות עם אותו `vehicleIndex` מקורי). משתמשים ב-`ShipmentRoute.Visit.shipment_label` במקום ב-`shipmentIndex` כדי להתאים בין ביקורים בפתרון שהוזן לבין משלוחים בבקשה. משתמשים ב-`SkippedShipment.label` במקום ב-`SkippedShipment.index` כדי להתאים בין משלוחים שהושמטו בפתרון שהוזן לבין משלוחים שהוזמנו. הפרשנות הזו חלה על השדות `injectedFirstSolutionRoutes`,‏ `injectedSolutionConstraint` ו-`refreshDetailsRoutes`. אפשר להשתמש בה אם מפתחי המשלוח או הרכבים שצוינו בבקשה השתנו מאז שהפתרון נוצר, אולי כי משלוחים או כלי רכב הוסרו מהבקשה או נוספו אליה. אם הערך הוא True, תוויות בקטגוריות הבאות חייבות להופיע לכל היותר פעם אחת בקטגוריה שלהן: `Vehicle.label` בבקשה; `Shipment.label` בבקשה; `ShipmentRoute.vehicle_label` בתמיסה ההזרקת; `SkippedShipment.label` ו-`ShipmentRoute.Visit.shipment_label` בפתרון שהוחדר (למעט צמדים של איסוף/מסירה וביקור, שהפרמטר `shipmentLabel` שלהם חייב להופיע פעמיים). אם הערך של `vehicleLabel` בפתרון שהוזן לא תואם לרכב של בקשה, המסלול התואם יוסר מהפתרון יחד עם הביקורים שלו. אם `shipmentLabel` בפתרון שהוחדר לא מתאים לבקשת משלוח, הביקור המתאים יוסר מהפתרון. אם `SkippedShipment.label` בפתרון שהוזן לא תואם לשליחת בקשה, ה-`SkippedShipment` מוסר מהפתרון. הסרה של ביקורים במסלול או מסלולים שלמים מפתרון שהוחדר יכולה להיות השפעה על המגבלות המשתמעות. כתוצאה מכך, עשויים להיות שינויים בפתרון, בשגיאות אימות או בחוסר היתכנות. הערה: המתקשר חייב לוודא שכל `Vehicle.label` (תגובה `Shipment.label`) משמש לזיהוי ייחודי של ישות של רכב (משלוח resp) שנעשה בה שימוש בשתי הבקשות הרלוונטיות: הבקשה הקודמת שממנה נוצר התמיסה `OptimizeToursResponse` שבה נעשה שימוש בפתרון שהוחדר, והבקשה הנוכחית שכוללת את הפתרון המוזר. בדיקות הייחודיות שמתוארות למעלה לא מספיקות כדי להבטיח את הדרישה הזו.
`considerRoadTraffic`	`boolean` כדאי להביא בחשבון את אומדן התנועה בזמן החישוב של השדות `ShipmentRoute`‏ `Transition.travel_duration`,‏ `Visit.start_time` ו-`vehicleEndTime`, בזמן ההגדרה של השדה `ShipmentRoute.has_traffic_infeasibilities` ובזמן החישוב של השדה `OptimizeToursResponse.total_cost`.
`populatePolylines`	`boolean` אם הערך הוא True, הקווים הפוליטיים יאוכלסו בתשובה `ShipmentRoute`s.
`populateTransitionPolylines`	`boolean` אם הערך הוא true, קווים פוליגונליים יאוכלסו בתגובה `ShipmentRoute.transitions`.
`allowLargeDeadlineDespiteInterruptionRisk`	`boolean` אם ההגדרה הזו מוגדרת, לבקשה יכול להיות מועד יעד (מידע נוסף זמין בכתובת https://grpc.io/blog/deadlines) של עד 60 דקות. אחרת, מועד ההגשה האחרון הוא 30 דקות בלבד. חשוב לשים לב שלבקשות לטווח ארוך יש סיכון גבוה יותר באופן משמעותי (אבל עדיין קטן) להפרעה.
`useGeodesicDistances`	`boolean` אם הערך הוא true, מרחקי הנסיעה יחושבו לפי מרחקים גיאודזיים במקום מרחקים במפות Google, וזמני הנסיעה יחושבו לפי מרחקים גיאודזיים עם מהירות שמוגדרת על ידי `geodesicMetersPerSecond`.
`label`	`string` תווית שעשויה לשמש לזיהוי הבקשה הזו, שתדווח ב-`OptimizeToursResponse.request_label`.
`geodesicMetersPerSecond`	`number` כשהערך של `useGeodesicDistances` הוא true, צריך להגדיר את השדה הזה. השדה הזה מגדיר את המהירות שחלה על חישוב זמני הנסיעה. הערך שלו חייב להיות לפחות 1.0 מטרים לשנייה.
`maxValidationErrors`	`integer` מקצר את מספר שגיאות האימות שהוחזרו. בדרך כלל השגיאות האלה מצורפות לעומס הנתונים של שגיאת INVALID_ARGUMENT כפרטי שגיאה של BadRequest (https://cloud.google.com/apis/design/errors#error_details), אלא אם solvingMode=VALIDATE_ONLY: ראו את השדה `OptimizeToursResponse.validation_errors`. ערך ברירת המחדל הוא 100 ומוגבל ל-10,000.

גוף התשובה

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

היקפי ההרשאות

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

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

הרשאות IAM

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

routeoptimization.locations.use

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

Method: projects.optimizeTours קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.