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