כשאתם מחפשים את המסלול הכי טוב לנסיעה משותפת, המסלול הכי מהיר הוא לא תמיד האפשרות הכי טובה. כדאי לתכנן את המסלול.
Routes Preferred API מאפשר לתכנן מסלול על ידי ציון יעד מסלול באמצעות ה-method 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 מפורטות במאמר דוגמאות לחישוב מסלול בהתאמה אישית.
חישוב אגרות
למידע על חישוב עמלות, קראו את המאמר חישוב עמלות.
דוגמאות לחישוב של אגרות מופיעות במאמר דוגמאות לחישוב מסלול בהתאמה אישית.