Method: projects.optimizeToursUri

זוהי וריאציה של השיטה projects.optimizeToursLongRunning שמיועדת לביצוע אופטימיזציות עם ערכי זמן קצוב לתפוגה גדולים ועם גדלים גדולים של קלט/פלט.

הלקוח מציין את ה-URI של ה-OptimizeToursRequest שמאוחסן ב-Google Cloud Storage, והשרת כותב את ה-OptimizeToursResponse ב-URI של Google Cloud Storage שצוין על ידי הלקוח.

מומלץ להשתמש בשיטה הזו במקום בשיטה projects.optimizeTours כשמדובר באופטימיזציות שנמשכות יותר מכמה דקות ובגדלים של קלט/פלט גדולים מ-8MB, אבל אפשר להשתמש בה גם באופטימיזציות קצרות וקטנות יותר.

ל-long-running operation (LRO) המוחזר יהיה שם בפורמט <parent>/operations/<operation_id>, וניתן להשתמש בו כדי לעקוב אחרי התקדמות החישוב. סוג השדה metadata הוא OptimizeToursLongRunningMetadata. אם הפעולה תצליח, סוג השדה response יהיה OptimizeToursUriResponse.

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/tt/route-optimization/experimental/otlr/make-request.

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

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

גוף הבקשה

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

ייצוג ב-JSON 
{
  "input": {
    object (Uri)
  },
  "output": {
    object (Uri)
  }
}
שדות
input

object (Uri)

חובה. ה-URI של אובייקט Cloud Storage שמכיל את OptimizeToursRequest.
output

object (Uri)

חובה. ה-URI של אובייקט Cloud Storage שיכיל את OptimizeToursResponse.

גוף התשובה

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

היקפי הרשאה

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

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

הרשאות IAM

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

  • routeoptimization.operations.create

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