תכנון מסלול

כשקובעים את המסלול הכי טוב לנסיעה בשיתוף נסיעות, המסלול הכי מהיר הוא לא תמיד האפשרות הכי טובה. כדאי לתכנן את המסלול.

ממשק 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][...]

מקרה מיוחד הוא מסיכת שדות עם התו הכללי '*', שבוחר את כל השדות ברמת הבסיס.

מידע נוסף זמין בדפים הבאים:

• הפניית API של gRPC
• הפניית REST API

דוגמאות לשימוש בשיטה ComputeCustomRoutes מופיעות במאמר דוגמאות לחישוב מסלול מותאם אישית (בטא).

חישוב עמלות על נסיעה בכביש אגרה

מידע על חישוב עמלות על שיחות לטלפון זמין במאמר חישוב עמלות על שיחות לטלפון.

דוגמאות לחישוב אגרות מופיעות במאמר בנושא חישוב מסלול מותאם אישית.