תכנון מסלול

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

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

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

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

• הפניית API של gRPC
• הפניית API בארכיטקטורת REST

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

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

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

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