規劃路線

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

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

ComputeCustomRoutes 方法也可以協助您盡量減少業者選擇的路徑與行駛路徑之間的差異,有助於確保路徑遵循規定。

同時使用 Routes Preferred API 和 Navigation SDK,完全能充分發揮路徑規劃的優勢。

啟用 ComputeCustomRoutes 方法

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

使用 ComputeCustomRoutes 方法

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

欄位遮罩值是以半形逗號分隔的欄位路徑清單,每個欄位路徑都是以點分隔的欄位名稱清單,代表訊息階層。欄位名稱是 JSON 物件金鑰或 protobuf 欄位標記名稱。欄位路徑是從頂層回應訊息類型開始,並且視需要在後面加上一或多個點,然後是下一個欄位名稱。一般來說,欄位路徑的建構方式如下:

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

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

詳情請參閱:

如需 ComputeCustomRoutes 方法的使用範例,請參閱計算自訂路徑 (Beta 版) 範例

計算過路費

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

如需計算過路費的範例,請參閱計算自訂路徑範例