Saat memanggil metode ComputeRoutes(), Anda harus menentukan kolom mana yang ingin ditampilkan dalam respons. Anda melakukannya dengan menggunakan mask kolom respons, yang
Anda berikan dengan parameter URL $fields atau fields, atau dengan menggunakan
header HTTP/gRPC X-Goog-FieldMask. Untuk mengetahui 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 dan mewakili hierarki pesan. Nama kolom adalah kunci objek JSON atau nama tag kolom protobuf. Jalur kolom dimulai dari jenis pesan respons tingkat atas, dan secara opsional diikuti dengan satu atau beberapa titik, lalu tingkat nama kolom berikutnya. Secara umum, jalur kolom dibuat dengan cara berikut:
topLevelField[.secondLevelField][.thirdLevelField][...]
Mask kolom kasus khusus adalah karakter pengganti “*”, yang memilih semua kolom level root.
Contoh
Contoh berikut menunjukkan cara menetapkan 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
Sebaiknya jangan gunakan mask kolom respons karakter pengganti (*), atau tetapkan mask kolom di tingkat atas (rute) dalam produksi. Pilih hanya bidang yang Anda butuhkan:
Memungkinkan server kami menyimpan siklus pemrosesan, yang memungkinkan kami menampilkan hasil Anda dengan latensi yang lebih rendah.
Memastikan performa latensi stabil. Kami mungkin menambahkan lebih banyak kolom respons di masa mendatang, dan kolom baru tersebut mungkin memerlukan waktu komputasi tambahan. Jika Anda memilih semua kolom, atau jika Anda memilih semua kolom di tingkat teratas, Anda mungkin akan mengalami penurunan performa karena setiap kolom baru yang kami tambahkan akan otomatis disertakan dalam respons Anda.
Menghasilkan ukuran respons yang lebih kecil, yang berarti throughput jaringan yang lebih tinggi.
Untuk informasi selengkapnya tentang cara membuat jalur kolom, lihat field_mask.proto.