Halaman ini diterjemahkan oleh Cloud Translation API.

Mengapa bermigrasi ke Routes API?

Routes API memberikan peningkatan performa untuk menghitung rute, jarak, dan waktu perjalanan, sehingga sebaiknya ganti aplikasi yang saat ini menggunakan Directions API dan Distance Matrix API. Sebagian besar fungsi Routes API kompatibel dengan Directions API dan Distance Matrix API.

Gunakan panduan ini untuk memahami perbedaan utama dalam Routes API dibandingkan dengan produk yang digantikan, serta cara menangani perubahan yang diperlukan. Untuk mengetahui detail selengkapnya tentang fitur Routes API lainnya, lihat ringkasan produk.

Peningkatan utama

Bagian ini membahas beberapa peningkatan yang dapat Anda harapkan saat menggunakan Routes API di aplikasi Anda.

Peningkatan batas permintaan

Routes API	Maksimum 625 elemen, kecuali jika Anda menentukan `TRAFFIC_AWARE_OPTIMAL`. Maksimum 100 elemen dengan `TRAFFIC_AWARE_OPTIMAL`. Lihat Preferensi pemilihan rute yang ditingkatkan. Maksimum 50 titik jalan (asal + tujuan) menggunakan ID Tempat.
Distance Matrix API	Maksimum 25 asal atau 25 tujuan per permintaan. Maksimum 100 elemen (jumlah asal × jumlah tujuan) per permintaan sisi server.

Respons permintaan yang lebih cepat

Fitur matriks rute komputasi menawarkan peningkatan latensi berikut:

Terima elemen streaming respons sebelum seluruh matriks dihitung.
Gunakan mask kolom untuk menyesuaikan detail respons, dengan hanya meminta data yang Anda perlukan, sebagai praktik terbaik yang juga membantu mengurangi biaya Anda.
Penghitungan rute yang ditingkatkan untuk lalu lintas, sehingga Anda dapat melakukan kompromi antara kualitas data dan waktu respons.

Penyempurnaan pemilihan rute

Fitur rute komputasi menawarkan peningkatan rute berikut:

Informasi tol selain jarak dan PWT.
Rute kendaraan roda dua.
Kualifikasikan titik jalan persinggahan untuk keselamatan.
Meningkatkan akurasi PWT dengan menetapkan arah perjalanan dan sisi jalan untuk titik jalan.

Hanya meminta data yang Anda butuhkan

Sekarang Anda menentukan kolom yang akan ditampilkan, sehingga mengurangi waktu pemrosesan dan biaya penagihan.

Routes API	Permintaan Anda harus menggunakan mask kolom untuk menentukan kolom mana yang ingin ditampilkan dalam respons. Penyamaran kolom memastikan Anda tidak meminta data yang tidak perlu, untuk menghindari waktu pemrosesan dan biaya penagihan yang tidak perlu. Untuk mengetahui informasi selengkapnya, lihat Memilih kolom untuk ditampilkan.
Directions API Distance Matrix API	Menampilkan daftar kolom default, meskipun aplikasi Anda tidak benar-benar membutuhkannya. Hal ini dapat mengakibatkan waktu pemrosesan dan biaya penagihan yang tidak perlu.

Komputasi rute yang ditingkatkan untuk lalu lintas

Routes API mendukung tiga preferensi pemilihan rute yang dapat Anda gunakan untuk menyeimbangkan antara latensi respons dan kualitas data saat meminta informasi traffic.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi kualitas vs latensi.

`TRAFFIC_UNAWARE` (default)	Menggunakan data lalu lintas yang tidak tergantung waktu rata-rata, bukan data lalu lintas langsung, untuk menghitung rute sehingga menghasilkan latensi respons terendah. Setelan ini sama dengan saat lalu lintas tidak digunakan di Directions API dan Distance Matrix API.
`TRAFFIC_AWARE` (baru)	Kualitas traffic live yang dioptimalkan untuk performa untuk latensi yang lebih rendah. Berbeda dengan `TRAFFIC_AWARE_OPTIMAL`, setelan ini menerapkan pengoptimalan untuk mengurangi latensi secara signifikan. Setelan ini juga baru untuk Routes API tanpa padanan di Directions API atau Distance Matrix API.
`TRAFFIC_AWARE_OPTIMAL`	Data traffic yang komprehensif dan berkualitas tinggi. Setelan ini menghasilkan latensi tertinggi dan setara dengan setelan `departure_time` di Directions API dan Distance Matrix API. Preferensi ini setara dengan mode yang digunakan oleh maps.google.com dan aplikasi seluler Google Maps.

Perbandingan komputasi rute

Tabel berikut membandingkan opsi pemilihan rute antara layanan Routes API dan Directions API serta Distance Matrix API.

Opsi traffic Routes API Directions API
Distance Matrix API Lambat

Tidak ada lalu lintas real-time TRAFFIC_UNAWARE Properti departure_time belum ditetapkan Latensi tercepat dari ketiga mode tersebut.

Kondisi lalu lintas langsung diterapkan

Opsi traffic	Routes API	Directions API Distance Matrix API	Lambat
Tidak ada lalu lintas real-time	`TRAFFIC_UNAWARE`	Properti `departure_time` belum ditetapkan	Latensi tercepat dari ketiga mode tersebut.
Kondisi lalu lintas langsung diterapkan	`TRAFFIC_AWARE`	Tidak ada ekuivalen	Mode baru ditambahkan oleh Routes API. Layanan ini memberikan latensi yang sedikit lebih besar daripada `TRAFFIC_UNAWARE` dengan sedikit biaya kualitas PWT. Memiliki latensi yang jauh lebih rendah daripada `TRAFFIC_AWARE_OPTIMAL`.
Data lalu lintas langsung berkualitas tinggi dan komprehensif diterapkan	`TRAFFIC_AWARE_OPTIMAL`	`departure_time` kumpulan properti	Setara dengan mode yang digunakan oleh maps.google.com dan aplikasi seluler Google Maps. Untuk Compute Route Matrix, jumlah elemen dalam permintaan (jumlah asal × jumlah tujuan) tidak boleh lebih dari 100.

TRAFFIC_AWARE

Tidak ada ekuivalen

Mode baru ditambahkan oleh Routes API. Layanan ini memberikan latensi yang sedikit lebih besar daripada TRAFFIC_UNAWARE dengan sedikit biaya kualitas PWT.

Memiliki latensi yang jauh lebih rendah daripada TRAFFIC_AWARE_OPTIMAL.

Data lalu lintas langsung berkualitas tinggi dan komprehensif diterapkan

TRAFFIC_AWARE_OPTIMAL

departure_time kumpulan properti

Setara dengan mode yang digunakan oleh maps.google.com dan aplikasi seluler Google Maps.

Untuk Compute Route Matrix, jumlah elemen dalam permintaan (jumlah asal × jumlah tujuan) tidak boleh lebih dari 100.

Perbedaan utama

Bagian ini membahas perbedaan utama antara Routes API dan layanan yang diganti, serta cara mengatasi perbedaan ini saat bermigrasi dari layanan ini di aplikasi yang sudah ada.

Memanggil satu layanan, bukan dua

Routes API	Aktifkan hanya satu layanan di Konsol API agar aplikasi Anda dapat menggunakan Compute Routes dan Compute Route Matrix. Untuk informasi selengkapnya, lihat Menyiapkan di Konsol API Google.
Directions API Distance Matrix API	Aktifkan dua layanan: Directions API dan Distance Matrix API sebagai layanan terpisah di Konsol API.

Menggunakan permintaan `HTTPS POST`

Routes API	Teruskan parameter dalam isi permintaan atau di header sebagai bagian dari permintaan `HTTP POST`. Untuk contoh, lihat: - Menghitung rute - Menghitung matriks rute
Directions API Distance Matrix API	Teruskan parameter URL menggunakan permintaan `HTTP GET`.

Perbedaan respons PWT

Routes API menampilkan PWT dan menggunakan properti respons duration secara berbeda dengan layanan Directions API dan Distance Matrix API seperti yang ditunjukkan pada tabel di bawah.

Jenis PWT Routes API Directions API
Distance Matrix API

PWT yang tidak tergantung waktu dan tidak sadar traffic.

Jenis PWT	Routes API	Directions API Distance Matrix API
PWT yang tidak tergantung waktu dan tidak sadar traffic.	Setel menggunakan `TRAFFIC_UNAWARE`. PWT yang ada di properti respons `duration`. Properti respons `duration` dan `staticDuration` berisi nilai yang sama.	Sesuai dengan `departure_time` yang tidak ditetapkan dalam permintaan. PWT yang ada di properti respons `duration`. Properti respons `duration_in_traffic` tidak ditampilkan.
PWT yang mempertimbangkan traffic real-time.	Tetapkan menggunakan `TRAFFIC_AWARE` atau `TRAFFIC_AWARE_OPTIMAL`. PWT yang mempertimbangkan traffic real-time dimuat di properti respons `duration`. Properti respons `staticDuration` berisi durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas. Properti `duration_in_traffic` tidak lagi ditampilkan.	Ditetapkan menggunakan `departure_time` dalam permintaan. PWT yang mempertimbangkan traffic real-time dimuat di properti respons `duration_in_traffic`.

Setel menggunakan TRAFFIC_UNAWARE.

PWT yang ada di properti respons duration.
Properti respons duration dan staticDuration berisi nilai yang sama.

Sesuai dengan departure_time yang tidak ditetapkan dalam permintaan.

PWT yang ada di properti respons duration.
Properti respons duration_in_traffic tidak ditampilkan.

PWT yang mempertimbangkan traffic real-time.

Tetapkan menggunakan TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL.

PWT yang mempertimbangkan traffic real-time dimuat di properti respons duration.
Properti respons staticDuration berisi durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas.
Properti duration_in_traffic tidak lagi ditampilkan.

Ditetapkan menggunakan departure_time dalam permintaan.

PWT yang mempertimbangkan traffic real-time dimuat di properti respons duration_in_traffic.

Titik jalan polyline

Anda tidak perlu lagi mengonversi koordinat lintang/bujur menjadi titik jalan polyline dengan layanan ini, yang mendukung isi permintaan POST sehingga tidak lagi terpengaruh oleh batas string URL. Beberapa pengguna Distance Matrix API telah mengatasi masalah batas permintaan dengan mengonversi titik lintang/bujur menjadi titik jalan polyline.

Alamat yang diformat (geocoding terbalik)

Routes API tidak memberikan alamat berformat dalam respons. Untuk mendapatkan alamat berformat, gunakan Geocoding API yang dibuat untuk kasus penggunaan ini dan memberikan hasil yang berkualitas lebih tinggi.

Mode perjalanan yang tersedia

Seperti halnya Directions API, Routes API menggunakan Drive sebagai mode default jika permintaan rute tidak menentukan mode perjalanan. Namun, jika permintaan menentukan mode perjalanan untuk suatu rute, Routes API tidak akan menampilkan array mode perjalanan yang tersedia sebagai pilihan alternatif untuk permintaan tersebut. Jika kasus penggunaan Anda bergantung pada fitur ini,ajukan masalah yang menjelaskan cara Anda menggunakan fitur tersebut, sehingga kami dapat menindaklanjuti.

XML sebagai format respons

Routes API tidak menyediakan XML sebagai format respons. Anda dapat menemukan sejumlah pengonversi JSON ke XML secara online yang sesuai dengan tujuan Anda.