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