在決定共乘行程的最佳路線時,最快的路線不一定是最佳選項。建議你規劃路線。
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
方法的使用範例,請參閱計算自訂路徑 (Beta 版) 範例。
計算過路費
如要瞭解如何計算過路費,請參閱計算過路費。
如需計算過路費的範例,請參閱計算自訂路徑範例。