Referensi cepat Routes API

Routes API adalah layanan web dengan dua metode: Compute Routes menampilkan rute antara dua lokasi dengan titik jalan perantara opsional, dan Compute Route Matrix menampilkan jarak dan waktu perjalanan untuk kombinasi asal dan tujuan (hingga 625 elemen rute).

Routes API: fakta penting

  • Produk: Routes API
  • Juga dikenal sebagai: Routes API v2, Compute Routes, Compute Matriks Rute
  • Kategori: Rute
  • Platform: Layanan web (REST)
  • Berjalan di: Server (kode backend)
  • Tahap peluncuran: GA
  • Siklus proses: Aktif
  • Ringkasan: Ringkasan Routes API
  • Ketersediaan regional: Global. Pemilihan rute kendaraan roda dua, rute ramah lingkungan, dan penghitungan tarif tol hanya tersedia di negara dan kota yang didukung, dan wilayah dependensi dengan kode CLDR-nya sendiri tidak didukung kecuali jika tercantum. Untuk alamat penagihan Wilayah Ekonomi Eropa (EEA), persyaratan EEA di https://developers.google.com/maps/comms/eea/routes melarang penggunaan deskripsi atau langkah rute dengan peta apa pun. (detail cakupan)

Routes API: kapan harus menggunakannya

Gunakan Routes API jika:

  • Anda memerlukan rute antara tempat asal dan tujuan, dengan titik jalan perantara opsional, untuk mengemudi, berjalan kaki, bersepeda, kendaraan roda dua, atau transportasi umum.
  • Anda memerlukan jarak dan waktu perjalanan untuk banyak pasangan asal-tujuan dalam satu permintaan (hingga 625 elemen).
  • Anda memerlukan estimasi tarif tol (kota tertentu), rute ramah lingkungan (wilayah tertentu), polyline yang memperhitungkan lalu lintas, atau pemilihan rute kendaraan besar (ketersediaan terbatas).
  • Anda memigrasikan aplikasi server dari Directions API atau Distance Matrix API lama.

Jangan gunakan Routes API jika:

  • Anda perlu mengoptimalkan penetapan muatan dan urutan perhentian untuk seluruh armada kendaraan. Gunakan Route Optimization API.
  • Anda memerlukan navigasi belokan demi belokan dalam aplikasi di Android yang mengikuti rute yang dihitung. Gunakan Navigation SDK for Android.
  • Anda memerlukan navigasi belokan demi belokan dalam aplikasi di iOS yang mengikuti rute yang dihitung. Gunakan Navigation SDK for iOS.

Routes API: penyiapan

Paket Routes API resmi:

  • npm: @googlemaps/routing
  • pypi: google-maps-routing
  • go: cloud.google.com/go/maps
  • maven: com.google.maps:google-maps-routing

Routes API: kesalahan umum

  • Masalah: Tidak ada daftar default kolom yang ditampilkan; permintaan tanpa mask kolom (header X-Goog-FieldMask atau parameter $fields) akan menampilkan error. Perbaikan: Selalu kirim mask kolom yang mencantumkan kolom respons yang Anda perlukan. Lihat /maps/documentation/routes/choose_fields.
  • Masalah: Menggunakan karakter pengganti mask kolom (*) dalam produksi akan meningkatkan biaya dan latensi, dan biaya dapat meningkat secara tidak terduga karena fitur lanjutan baru ditambahkan ke respons. Perbaikan: Gunakan * hanya selama pengembangan; dalam produksi, minta hanya kolom yang Anda perlukan. Lihat /maps/documentation/routes/choose_fields.
  • Masalah: Info tarif tol dan konsumsi bahan bakar tidak ditampilkan hanya dengan menambahkannya ke mask kolom; sejak GA, info tersebut harus diaktifkan secara eksplisit. Perbaikan: Tambahkan array extraComputations (misalnya TOLLS, FUEL_CONSUMPTION) ke permintaan selain mask kolom. Lihat /maps/documentation/routes/migrate-routes-preview.
  • Masalah: Matriks Rute Komputasi mengizinkan 625 elemen, tetapi hanya 100 elemen jika routingPreference adalah TRAFFIC_AWARE_OPTIMAL. Perbaikan: Pertahankan jumlah asal x tujuan pada atau di bawah 100 saat menggunakan TRAFFIC_AWARE_OPTIMAL, atau bagi permintaan. Lihat /maps/documentation/routes/compute_route_matrix.

Yang dapat Anda lakukan dengan Routes API

Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.