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