Package google.maps.routes.v1alpha

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

根據一組航站和中繼路線控點，以及一個路徑目標，計算路線目標的最佳路線。也會傳回最快路線和最短路徑做為參考路線。

注意：這個方法需要您在輸入內容中指定回應欄位遮罩。如要提供回應欄位遮罩，您可以使用網址參數 $fields 或 fields，或是使用 HTTP/gRPC 標頭 X-Goog-FieldMask (請參閱可用的網址參數和標頭)。值是以逗號分隔的欄位路徑清單。請參閱有關如何建構欄位路徑的詳細說明文件。

例如，在以下方法中：

• 所有可用欄位的欄位遮罩 (適用於手動檢查)：X-Goog-FieldMask: *
• 路線距離、時間長度、代幣和收費資訊的欄位遮罩：X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Google 不建議使用萬用字元 (*) 回應欄位遮罩，或是在頂層 (routes) 指定欄位遮罩，原因如下：

• 只選取您需要的欄位有助於我們的伺服器節省運算週期，我們便能縮短傳回結果的延遲時間。
• 只選取實際工作環境工作中所需的欄位，可確保延遲時間穩定。我們日後可能會新增更多回應欄位，而這些新欄位可能需要額外的運算時間。如果選取所有欄位，或是選取頂層欄位的所有欄位，可能會出現成效降低的情形，這是因為我們新增的所有新欄位都會自動納入回應中。
• 因此，如果只選取需要的欄位，回應大小會較小，網路處理量也會提高。

授權範圍

需要下列 OAuth 範圍：

• https://www.googleapis.com/auth/maps-platform.routespreferred

詳情請參閱 OAuth 2.0 總覽。

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

擷取起點與目的地清單，並傳回包含每個起點與目的地組合路線資訊的串流。

注意：這個方法需要您在輸入內容中指定回應欄位遮罩。如要提供回應欄位遮罩，您可以使用網址參數 $fields 或 fields，或是使用 HTTP/gRPC 標頭 X-Goog-FieldMask (請參閱可用的網址參數和標頭)。值是以逗號分隔的欄位路徑清單。請參閱有關如何建構欄位路徑的詳細說明文件。

例如，在以下方法中：

• 所有可用欄位的欄位遮罩 (適用於手動檢查)：X-Goog-FieldMask: *
• 路線持續時間、距離、元素狀態、條件，以及元素索引 (產生設定範例) 的欄位遮罩：X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

請務必在欄位遮罩中加入 status，否則所有郵件都能正常顯示。Google 不建議使用萬用字元 (*) 回應欄位遮罩，原因如下：

• 只選取您需要的欄位有助於我們的伺服器節省運算週期，我們便能縮短傳回結果的延遲時間。
• 只選取實際工作環境工作中所需的欄位，可確保延遲時間穩定。我們日後可能會新增更多回應欄位，而這些新欄位可能需要額外的運算時間。如果選取所有欄位，或是選取頂層欄位的所有欄位，可能會出現成效降低的情形，這是因為我們新增的所有新欄位都會自動納入回應中。
• 因此，如果只選取需要的欄位，回應大小會較小，網路處理量也會提高。

授權範圍

需要下列 OAuth 範圍：

• https://www.googleapis.com/auth/maps-platform.routespreferred

詳情請參閱 OAuth 2.0 總覽。

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

根據一組航廈和中繼路線控點，傳回主要路線和選用的替代路線。

注意：這個方法需要您在輸入內容中指定回應欄位遮罩。如要提供回應欄位遮罩，您可以使用網址參數 $fields 或 fields，或是使用 HTTP/gRPC 標頭 X-Goog-FieldMask (請參閱可用的網址參數和標頭)。值是以逗號分隔的欄位路徑清單。請參閱有關如何建構欄位路徑的詳細說明文件。

例如，在以下方法中：

• 所有可用欄位的欄位遮罩 (適用於手動檢查)：X-Goog-FieldMask: *
• 路線層級時間長度、距離和折線的欄位遮罩 (範例製作範例)：X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google 不建議使用萬用字元 (*) 回應欄位遮罩，或是在頂層 (routes) 指定欄位遮罩，原因如下：

• 只選取您需要的欄位有助於我們的伺服器節省運算週期，我們便能縮短傳回結果的延遲時間。
• 只選取實際工作環境工作中所需的欄位，可確保延遲時間穩定。我們日後可能會新增更多回應欄位，而這些新欄位可能需要額外的運算時間。如果選取所有欄位，或是選取頂層欄位的所有欄位，可能會出現成效降低的情形，這是因為我們新增的所有新欄位都會自動納入回應中。
• 因此，如果只選取需要的欄位，回應大小會較小，網路處理量也會提高。

授權範圍

需要下列 OAuth 範圍：

• https://www.googleapis.com/auth/maps-platform.routespreferred

詳情請參閱 OAuth 2.0 總覽。