選擇要傳回的欄位

呼叫 ComputeRoutes() 方法時,您必須指定要傳回回應中的哪些欄位。只要使用回應欄位遮罩即可 您必須提供網址參數 $fieldsfields,或使用 HTTP/gRPC 標頭 X-Goog-FieldMask。若需更多資訊,請參閲 系統參數

欄位遮罩

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

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

特殊情況欄位遮罩是萬用字元「*」,可選取所有根層級 只要使用來自這些領域的 小型資料集訓練即可

範例

以下範例說明如何設定 ComputeRoutes() 方法。

範例 1

所有可用欄位的欄位遮罩 (用於手動檢查)。

X-Goog-FieldMask: *

範例 2

路線層級時間長度、距離和多邊形的欄位遮罩 (實際工作環境設定範例)。

X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline

我們不建議使用萬用字元 (*) 回應欄位遮罩,或是指定 在實際工作環境的頂層 (路徑) 使用欄位遮罩。如果只選取 以下為您需要的欄位:

  • 讓伺服器可節省處理週期,以便以更低的延遲時間傳回結果。

  • 確保穩定的延遲效能。我們可能會在 因此新欄位可能需要額外的運算時間。如果您選取: 或者選取頂層的所有欄位,也可能出現 因為系統會自動新增任何欄位 包含在回應中。

  • 回應大小較小,進而產出較高的網路 處理量

如要進一步瞭解如何建構欄位路徑,請參閱 field_mask.proto.