Saat memanggil metode ComputeRoutes()
, Anda harus menentukan kolom mana yang ingin
yang ingin ditampilkan dalam respons. Anda melakukannya dengan
menggunakan {i>mask kolom<i} respons, yang
Anda berikan dengan parameter URL $fields
atau fields
, atau dengan menggunakan
Header HTTP/gRPC X-Goog-FieldMask
. Untuk informasi selengkapnya, lihat
Parameter Sistem.
Mask kolom
Nilai mask kolom adalah daftar jalur kolom yang dipisahkan koma. Setiap jalur kolom adalah daftar nama kolom yang dipisahkan titik, yang mewakili hierarki pesan. J nama kolom dapat berupa kunci objek JSON atau nama tag kolom protobuf. Tujuan jalur kolom dimulai dari jenis pesan respons tingkat teratas, dan bersifat opsional diikuti dengan satu atau beberapa titik, dan level nama {i>field <i}berikutnya. Secara umum, jalur kolom dibuat dengan cara berikut:
topLevelField[.secondLevelField][.thirdLevelField][...]
Mask kolom kasus khusus merupakan karakter pengganti “*”, yang memilih semua data level root kolom.
Contoh
Contoh berikut menunjukkan cara menyetel mask kolom untuk
Metode ComputeRoutes()
.
Contoh 1
Mask kolom untuk semua kolom yang tersedia (untuk inspeksi manual).
X-Goog-FieldMask: *
Contoh 2
Mask kolom untuk durasi tingkat Rute, jarak, dan polyline (contoh penyiapan produksi).
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
Kami tidak menyarankan penggunaan mask kolom respons karakter pengganti (*), atau menentukan mask kolom di tingkat teratas (rute) dalam produksi. Hanya memilih yang Anda perlukan:
Memungkinkan server kami untuk menyimpan siklus pemrosesan, yang memungkinkan kami untuk mengembalikan menghasilkan latensi yang lebih rendah.
Memastikan performa latensi stabil. Kita mungkin menambahkan lebih banyak bidang tanggapan di di masa depan, dan isian baru itu mungkin membutuhkan waktu komputasi tambahan. Jika Anda memilih semua kolom, atau jika Anda memilih semua kolom di tingkat teratas, Anda mungkin mengalami penurunan kinerja karena setiap isian baru yang kami tambahkan akan secara otomatis disertakan dalam jawaban Anda.
Menghasilkan ukuran respons yang lebih kecil, yang berarti jaringan lebih besar yang konsisten.
Untuk informasi selengkapnya tentang cara membuat jalur kolom, lihat metode field_mask.proto.