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 總覽。