Saat Anda menentukan rute terbaik untuk perjalanan transportasi online, rute tercepat mungkin tidak selalu menjadi opsi terbaik. Anda mungkin ingin merencanakan rute Anda.
Routes Preferred API memungkinkan Anda merencanakan rute dengan menentukan
tujuan rute menggunakan metode ComputeCustomRoutes.
Metode ComputeCustomRoutes juga dapat membantu kepatuhan rute dengan memungkinkan
Anda meminimalkan perbedaan antara rute yang dipilih oleh operator dan
rute yang dilalui.
Gunakan Routes Preferred API dan Navigation SDK untuk mendapatkan manfaat penuh dari perencanaan rute.
Mengaktifkan metode ComputeCustomRoutes
Sebelum dapat menggunakan metode ComputeCustomRoutes dalam kode, Anda harus
mengaktifkannya. Untuk informasi selengkapnya tentang cara mengaktifkan metode Routes Preferred API, lihat Memulai.
Menggunakan metode ComputeCustomRoutes
Metode ComputeCustomRoutes mengharuskan Anda menentukan mask kolom
respons di input. Anda dapat memberikan mask kolom respons menggunakan
parameter URL $fields atau fields, atau dengan menggunakan header HTTP/gRPC
X-Goog-FieldMask. Untuk informasi selengkapnya, lihat
Parameter Sistem.
Nilai mask kolom adalah daftar jalur kolom yang dipisahkan koma. Setiap jalur kolom merupakan daftar nama kolom yang dipisahkan titik yang mewakili hierarki pesan. Nama kolom dapat berupa kunci objek JSON, atau nama tag kolom protobuf. Jalur kolom dimulai dari jenis pesan respons tingkat atas, dan secara opsional diikuti oleh satu atau beberapa titik, lalu level berikutnya dari nama kolom. Secara umum, jalur kolom dibuat dengan cara berikut:
topLevelField[.secondLevelField][.thirdLevelField][...]
Mask kolom kasus khusus adalah karakter pengganti “*”, yang memilih semua kolom level root.
Untuk informasi selengkapnya, lihat:
Untuk contoh penggunaan metode ComputeCustomRoutes, lihat
Menghitung Contoh Rute Kustom (Beta).
Menghitung biaya tol
Untuk informasi tentang cara menghitung biaya tol, lihat Menghitung biaya tol.
Untuk contoh penghitungan biaya tol, lihat Menghitung Contoh Rute Kustom.