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