規劃自訂路線

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

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][...]

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

如需詳細資訊,請參閱:

如需使用 ComputeCustomRoutes 方法的範例,請參閱「計算自訂路線範例」。

計算過路費

如要瞭解如何計算過路費,請參閱「計算過路費」。

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