Mengapa bermigrasi ke Routes API?

Developer Wilayah Ekonomi Eropa (EEA)

Routes API memberikan performa yang lebih baik untuk menghitung rute, jarak, dan waktu tempuh, sehingga layak untuk menggantikan aplikasi yang menggunakan Directions API dan Distance Matrix API. Sebagian besar fungsi Routes API kompatibel mundur dengan Directions API dan Distance Matrix API.

Gunakan panduan ini untuk memahami perbedaan utama di Routes API dibandingkan dengan produk yang digantikannya, beserta 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 Compute Route Matrix
  • 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 titik asal atau 25 tujuan per permintaan.
  • Maksimum 100 elemen (jumlah titik asal × jumlah tujuan) per permintaan sisi server.

Respons permintaan yang lebih cepat

Fitur Compute Route Matrix 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. Praktik terbaik ini juga membantu mengurangi biaya Anda.
  • Peningkatan perhitungan rute untuk traffic, sehingga Anda dapat menentukan kompromi antara kualitas data dan waktu respons.

Peningkatan perutean

Fitur hitung rute menawarkan peningkatan kualitas perutean berikut:

  • Informasi jalan tol selain jarak dan perkiraan waktu tiba.
  • Rute kendaraan roda 2.
  • Kualifikasi titik persinggahan Anda untuk keselamatan.
  • Meningkatkan akurasi PWT dengan menetapkan arah perjalanan dan sisi jalan untuk waypoint.

Hanya minta data yang Anda perlukan

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

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

Peningkatan perhitungan rute untuk lalu lintas

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

Untuk informasi selengkapnya, lihat Mengonfigurasi kualitas versus latensi.

TRAFFIC_UNAWARE
(default)		 Menggunakan data lalu lintas rata-rata yang tidak bergantung pada waktu, bukan data lalu lintas live, untuk menghitung rute, sehingga menghasilkan latensi respons terendah. Setelan ini setara dengan saat lalu lintas tidak digunakan di Directions API dan Distance Matrix API.
TRAFFIC_AWARE
(baru)		 Kualitas traffic live yang dioptimalkan untuk performa dengan 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 persamaan 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 oleh aplikasi seluler Google Maps.

Perbandingan penghitungan rute

Tabel berikut membandingkan opsi perutean 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 departure_time properti tidak ditetapkan Latensi tercepat dari ketiga mode.
Kondisi lalu lintas real-time diterapkan TRAFFIC_AWARE Tidak ada ekuivalen

Mode baru ditambahkan oleh Routes API. TRAFFIC_UNAWARE memberikan latensi yang sedikit lebih besar daripada TRAFFIC_UNAWARE dengan biaya kecil untuk kualitas ETP.

Latensinya jauh lebih rendah daripada TRAFFIC_AWARE_OPTIMAL.
Data lalu lintas real time yang komprehensif dan berkualitas tinggi diterapkan TRAFFIC_AWARE_OPTIMAL Set properti departure_time

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

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

Perbedaan utama

Bagian ini membahas perbedaan utama antara Routes API dan layanan yang digantikannya, beserta cara Anda dapat mengatasi perbedaan ini saat bermigrasi dari layanan ini di aplikasi yang ada.

Panggil 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 mengetahui 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 perkiraan waktu tiba dan menggunakan properti respons duration secara berbeda dengan layanan Directions API dan Distance Matrix API seperti yang ditunjukkan dalam tabel di bawah.

Jenis PWS Routes API Directions API
Distance Matrix API
PWT tidak bergantung pada waktu dan tidak memperhitungkan lalu lintas.

Tetapkan menggunakan TRAFFIC_UNAWARE.

  • ETA yang terdapat dalam properti respons duration.
  • Properti respons duration dan staticDuration berisi nilai yang sama.

Sesuai dengan departure_time yang tidak ditetapkan dalam permintaan.

  • ETA yang terdapat dalam properti respons duration.
  • Properti respons duration_in_traffic tidak ditampilkan.
PWS yang mempertimbangkan lalu lintas real-time.

Setel menggunakan TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL.

  • Perkiraan waktu tiba yang mempertimbangkan lalu lintas real-time terdapat dalam properti respons duration.
  • Properti respons staticDuration berisi durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas.
  • Properti duration_in_traffic tidak lagi ditampilkan.

Tetapkan menggunakan departure_time dalam permintaan.

  • Perkiraan waktu tiba yang mempertimbangkan lalu lintas real-time terdapat dalam 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 dan oleh karena itu tidak lagi terpengaruh oleh batas string URL. Beberapa pengguna Distance Matrix API mengatasi masalah batas permintaan dengan mengonversi titik lintang/bujur ke titik jalan polyline.

Alamat yang diformat (geocoding 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 berkualitas lebih tinggi.

Mode perjalanan yang tersedia

Seperti halnya Directions API, Routes API menggunakan DRIVE sebagai mode default saat permintaan rute tidak menentukan mode perjalanan. Namun, jika permintaan menentukan mode perjalanan untuk 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 menindaklanjutinya.

XML sebagai format respons

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