Referensi cepat Distance Matrix API

Distance Matrix API (Lama) adalah layanan web yang menampilkan jarak dan waktu perjalanan untuk matriks tempat asal dan tujuan, berdasarkan rute yang direkomendasikan antara setiap pasangan. Anda dapat menetapkan mode perjalanan (mengemudi, berjalan kaki, bersepeda, transportasi umum), mode transportasi umum, unit, dan waktu keberangkatan untuk durasi berbasis lalu lintas. API ini menampilkan JSON atau XML.

Distance Matrix API: fakta penting

  • Produk: Distance Matrix API
  • Juga dikenal sebagai: Distance Matrix API (Lama), Distance Matrix (Lama)
  • Kategori: Rute
  • Platform: Layanan web (REST)
  • Berjalan di: Server (kode backend)
  • Tahap peluncuran: GA
  • Siklus proses: Lama
  • Digantikan oleh: Routes API
  • Ringkasan: Ringkasan Distance Matrix API

Distance Matrix API: kapan harus menggunakannya

Gunakan Distance Matrix API jika:

  • Anda mengelola project yang sudah ada dan telah mengaktifkan Distance Matrix API (Lama) serta memanggil /maps/api/distancematrix.
  • Anda memerlukan jarak dan waktu perjalanan antara setiap tempat asal dan setiap tempat tujuan dari server.
  • Anda memerlukan durasi dalam lalu lintas untuk mengemudi, menggunakan departure_time dan traffic_model opsional.

Jangan gunakan Distance Matrix API jika:

  • Anda memulai project Google Cloud baru. Mulai Oktober 2026, Distance Matrix API (Lama) tidak dapat diaktifkan untuk project baru. Gunakan Routes API.
  • Anda memerlukan fitur baru atau matriks rute hingga 625 elemen dengan respons yang di-streaming (computeRouteMatrix). Gunakan Routes API.
  • Anda memerlukan rute lengkap dengan langkah-langkah dan polyline di antara titik, bukan hanya nilai jarak dan durasi. Gunakan Routes API.

Distance Matrix API: penyiapan

Distance Matrix API: kesalahan umum

  • Masalah: Setiap permintaan sisi server dibatasi hingga 100 elemen (asal × tujuan) dan hingga 25 asal atau 25 tujuan. Permintaan yang lebih besar akan menampilkan MAX_ELEMENTS_EXCEEDED atau MAX_DIMENSIONS_EXCEEDED. Perbaikan: Bagi matriks menjadi permintaan yang tidak lebih dari 100 elemen dan 25 tempat asal atau tujuan. Lihat /maps/documentation/distance-matrix/usage-and-billing#usage-limits.
  • Masalah: Jika Anda tidak menentukan departure_time, rute dan durasi akan didasarkan pada lalu lintas rata-rata yang tidak bergantung waktu, dan duration_in_traffic tidak akan ditampilkan. Hasil dapat bervariasi dari waktu ke waktu. Perbaikan: Tetapkan departure_time ke now atau waktu mendatang dengan mode=driving untuk mendapatkan durasi yang memperhitungkan traffic. Perhatikan bahwa permintaan traffic akan ditagih dengan tarif yang lebih tinggi. Lihat /maps/documentation/distance-matrix/distance-matrix.
  • Masalah: Parameter units hanya mengubah teks di kolom jarak. Nilai jarak selalu dalam meter. Perbaikan: Baca distance.value sebagai meter, atau gunakan distance.text untuk tampilan. Lihat /maps/documentation/distance-matrix/distance-matrix.
  • Masalah: Memanggil Distance Matrix API (Lama) dari project yang tidak mengaktifkannya akan menampilkan REQUEST_DENIED di status dan error_message yang tertaut ke LegacyApiNotActivatedMapError. Asisten AI sering kali menghasilkan kode API lama secara default. Perbaikan: Lakukan migrasi ke Routes API computeRouteMatrix (dengan header X-Goog-FieldMask). Aktifkan API lama melalui formulir hanya sebagai tindakan jangka pendek. Lihat /maps/legacy#LegacyApiNotActivatedMapError.