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