Method: projects.locations.optimizeToursUri

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

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

מומלץ להשתמש בשיטה הזו במקום בשיטה locations.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/*/locations/*}:OptimizeToursUri

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

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

פרמטרים
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.