規劃路線

在決定共乘行程的最佳路線時，最快的路線不一定是最佳選擇。建議您規劃路線。

您可以使用 Routes Preferred API 透過 ComputeCustomRoutes 方法指定路線目標，規劃路線。

ComputeCustomRoutes 方法還可協助您盡量減少操作員選取的路線與實際行駛路線之間的差異，以便符合路線規範。

請同時使用 Routes Preferred API 和 Navigation SDK，充分發揮路線規劃功能的效益。

啟用 ComputeCustomRoutes 方法

您必須先啟用 ComputeCustomRoutes 方法，才能在程式碼中使用該方法。如要進一步瞭解如何啟用 Routes Preferred API 方法，請參閱入門指南。

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

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

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

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

如需詳細資訊，請參閱：

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

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

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