Routes API memberikan performa yang lebih baik untuk menghitung rute, jarak, dan waktu perjalanan, sehingga penting untuk mengganti 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 pada Routes API dibandingkan dengan produk yang digantikannya, 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 |
|
Distance Matrix API |
|
Respons permintaan yang lebih cepat
Fitur matriks rute komputasi menawarkan peningkatan latensi berikut:
- Menerima elemen streaming respons sebelum seluruh matriks dihitung.
- Gunakan mask kolom untuk menyesuaikan detail respons, dengan hanya meminta data yang Anda butuhkan, sebuah praktik terbaik yang juga membantu mengurangi biaya.
- Penghitungan rute yang ditingkatkan untuk traffic, sehingga Anda dapat melakukan kompromi antara kualitas data dan waktu respons.
Penyempurnaan pemilihan rute
Fitur rute komputasi menawarkan peningkatan pemilihan rute ini:
- Informasi tol selain jarak dan PWT.
- Rute kendaraan roda 2.
- Tentukan titik jalan untuk persinggahan demi keselamatan.
- Meningkatkan akurasi PWT dengan menetapkan arah perjalanan dan sisi jalan untuk titik jalan.
Meminta data yang diperlukan saja
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 bahwa Anda tidak meminta data yang tidak perlu, yang menghindari waktu pemrosesan dan biaya penagihan yang tidak perlu.
Untuk informasi selengkapnya, lihat Memilih kolom yang akan dikembalikan. |
Directions API Distance Matrix API |
Menampilkan daftar kolom default, meskipun aplikasi Anda tidak benar-benar membutuhkannya. Hal ini dapat mengakibatkan waktu pemrosesan dan biaya tagihan yang tidak perlu. |
Komputasi rute yang disempurnakan untuk lalu lintas
Routes API mendukung tiga preferensi perutean 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 traffic rata-rata yang tidak tergantung waktu, bukan data lalu lintas live, 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 guna mengurangi latensi. 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 berkualitas tinggi dan komprehensif. Setelan ini menghasilkan latensi tertinggi dan setara dengan setelan departure_time di Directions API dan Distance Matrix API. Preferensi ini setara dengan moda 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 |
Latensi |
---|---|---|---|
Tidak ada lalu lintas real-time | TRAFFIC_UNAWARE |
Properti departure_time tidak ditetapkan |
Latensi tercepat dari ketiga mode. |
Kondisi lalu lintas live diterapkan | TRAFFIC_AWARE |
Tidak ada ekuivalen | Mode baru ditambahkan oleh Routes API. Jenis ini memberikan
latensi yang sedikit lebih besar daripada Fungsi ini memiliki latensi yang jauh lebih rendah daripada |
Data traffic live berkualitas tinggi dan komprehensif diterapkan | TRAFFIC_AWARE_OPTIMAL |
departure_time properti ditetapkan |
Setara dengan moda 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 untuk mengatasi perbedaan ini saat bermigrasi dari layanan tersebut 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 |
Mengaktifkan dua layanan: Directions API dan Distance Matrix API sebagai layanan terpisah di Konsol API. |
Menggunakan HTTPS POST
permintaan
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 |
Meneruskan 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 tidak sadar lalu lintas dan tidak tergantung waktu. | Setel menggunakan
|
Berhubungan dengan
|
PWT yang mempertimbangkan lalu lintas real-time. | Tetapkan menggunakan
|
Tetapkan menggunakan
|
Titik jalan polyline
Anda tidak perlu lagi mengonversi koordinat garis lintang/garis 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 mengatasi masalah batas permintaan dengan mengonversi titik lintang/bujur menjadi titik jalan polyline.
Alamat yang diformat (geocode terbalik)
Routes API tidak memberikan alamat berformat dalam respons. Untuk mendapatkan alamat yang diformat, gunakan Geocoding API yang dibuat untuk kasus penggunaan ini dan memberikan hasil yang lebih berkualitas.
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 mengandalkan fitur ini, ajukan masalah yang menjelaskan cara Anda menggunakan fitur tersebut agar kami dapat menindaklanjutinya.
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.