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