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