Saat memanggil metode ComputeRoutes(), Anda harus menentukan kolom 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 dengan titik yang merepresentasikan hierarki pesan. Nama kolom adalah kunci objek JSON, atau nama tag kolom protobuf. Jalur bidang dimulai dari jenis pesan respons tingkat teratas, dan secara opsional diikuti oleh satu atau beberapa titik, lalu nama bidang tingkat berikutnya. Secara umum, jalur kolom dibuat dengan cara berikut:
topLevelField[.secondLevelField][.thirdLevelField][...]
Masker kolom kasus khusus adalah karakter pengganti “*”, yang memilih semua kolom tingkat root.
Contoh
Contoh berikut menunjukkan cara menyetel mask kolom untuk metode
ComputeRoutes().
Contoh 1
Mask kolom untuk semua kolom yang tersedia (untuk pemeriksaan manual).
X-Goog-FieldMask: *
Contoh 2
Mask kolom durasi, jarak, dan polyline tingkat rute (contoh penyiapan produksi).
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
Kami tidak menganjurkan penggunaan mask kolom respons wildcard (*), atau menentukan mask kolom di tingkat teratas (rute) dalam produksi. Memilih hanya kolom yang Anda butuhkan:
Memungkinkan server kami menghemat siklus pemrosesan, sehingga kami dapat menampilkan hasil Anda dengan latensi yang lebih rendah.
Memastikan performa latensi yang stabil. Kami mungkin menambahkan lebih banyak kolom respons pada 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 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 mengetahui informasi selengkapnya tentang cara membuat jalur kolom, lihat field_mask.proto.