規劃路線

決定共乘行程的最佳路線時，最快路線不見得是最佳選擇。你可能需要規劃路線。

Routes Preferred API 可讓您使用 ComputeCustomRoutes 方法指定路線目標，藉此規劃路線。

ComputeCustomRoutes 方法也能協助您遵守路線規定，盡量縮小作業人員選取的路線與實際行駛路線之間的差異。

同時使用 Routes Preferred API 和 Navigation SDK，充分發揮路線規劃的優勢。

啟用 ComputeCustomRoutes 方法

您必須先啟用 ComputeCustomRoutes 方法，才能在程式碼中使用。如要進一步瞭解如何啟用 Routes Preferred API 方法，請參閱「開始使用」一文。

使用 ComputeCustomRoutes 方法

ComputeCustomRoutes 方法需要您在輸入內容中指定回應欄位遮罩。您可以使用網址參數 $fields 或 fields，或使用 HTTP/gRPC 標頭 X-Goog-FieldMask，提供回應欄位遮罩。詳情請參閱「系統參數」。

欄位遮罩值是以半形逗號分隔的欄位路徑清單。每個欄位路徑都是以半形句號分隔的欄位名稱清單，代表訊息階層。欄位名稱可以是 JSON 物件鍵，也可以是 protobuf 欄位標記名稱。 欄位路徑從頂層回應訊息類型開始，後面可選擇性加上一或多個半形句號，然後是下一層的欄位名稱。一般來說，欄位路徑的建構方式如下：

topLevelField[.secondLevelField][.thirdLevelField][...]

特殊情況的欄位遮罩是萬用字元「*」，會選取所有根層級欄位。

如需詳細資訊，請參閱：

• gRPC API 參考資料
• REST API 參考資料

如需使用 ComputeCustomRoutes 方法的範例，請參閱「計算自訂路線 (Beta 版) 範例」。

計算通行費

如要瞭解如何計算通行費，請參閱「計算通行費」。

如需計算過路費的範例，請參閱計算自訂路線範例。