כשאתם קובעים את המסלול הטוב ביותר לנסיעה בשירות שיתוף הנסיעות, יכול להיות שהמסלול המהיר ביותר לא תמיד יהיה האפשרות הטובה ביותר. מומלץ לתכנן את המסלול.
באמצעות Routes Preferred API אפשר לתכנן מסלול על ידי ציון יעד מסלול באמצעות השיטה ComputeCustomRoutes.
השיטה ComputeCustomRoutes יכולה לעזור גם בתאימות למסלולים, כי היא מאפשרת לצמצם את ההפרש בין המסלול שנבחר על ידי המפעיל לבין המסלול הנסיעה.
כדי ליהנות מהיתרונות המלאים של תכנון מסלולים, מומלץ להשתמש גם ב-Routes Preferred API וגם ב-Navigation SDK.
הפעלת השיטה ComputeCustomRoutes
לפני שמשתמשים ב-method ComputeCustomRoutes בקוד, צריך להפעיל אותה. מידע נוסף על הפעלת שיטות API מועדפות של Routes זמין במאמר תחילת השימוש.
שימוש בשיטה ComputeCustomRoutes
כשמשתמשים ב-method ComputeCustomRoutes, צריך לציין מסכת שדה תגובה בקלט. אפשר לספק את המסכה של שדה התגובה באמצעות הפרמטר של כתובת ה-URL $fields או fields, או באמצעות הכותרת HTTP/gRPC X-Goog-FieldMask. למידע נוסף, ראו פרמטרים של מערכת.
הערך במסכת השדות הוא רשימה של נתיבי שדות שמופרדים בפסיקים. כל נתיב של שדה הוא רשימה מופרדת באמצעות נקודות של שמות שדות שמייצגים את היררכיית ההודעות. שם השדה הוא המפתח של אובייקט ה-JSON או שם התג של שדה ה-protobuf. נתיב השדה מתחיל בסוג ההודעה של התשובה ברמה העליונה, ואחריו יש נקודה אחת או יותר ואחריו הרמה הבאה של שם השדה. באופן כללי, נתיבי השדות נוצרים באופן הבא:
topLevelField[.secondLevelField][.thirdLevelField][...]
אנונימיזציה של שדות במקרה מיוחד היא תו כללי לחיפוש '*', שבוחר את כל השדות ברמת השורש.
מידע נוסף זמין בדפים הבאים:
לדוגמאות לשימוש בשיטה ComputeCustomRoutes, ראו דוגמאות לחישוב מסלול מותאם אישית (בטא).
מתבצע חישוב של עמלות האגרה
למידע על חישוב עמלות האגרה, ראו חישוב עמלות האגרה.
לדוגמאות של חישוב עמלות האגרה, ראו חישוב דוגמאות למסלול מותאם אישית.