זוהי וריאציה של השיטה 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 |
חובה. בוחרים את הפרויקט או המיקום שאליהם רוצים להתקשר. פורמט: * אם לא מציינים מיקום, המערכת תבחר אזור באופן אוטומטי. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{ "input": { object ( |
שדות | |
---|---|
input |
חובה. ה-URI של אובייקט Cloud Storage שמכיל את |
output |
חובה. ה-URI של אובייקט Cloud Storage שיכיל את |
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של Operation
.
היקפי הרשאה
נדרשת הרשאת OAuth ברמת ההיקף הבאה:
https://www.googleapis.com/auth/cloud-platform
הרשאות IAM
נדרשת ההרשאה הבאה ב-IAM במשאב parent
:
routeoptimization.operations.create
למידע נוסף, עיינו במסמכי העזרה של IAM.