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_timedantraffic_modelopsional.
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
- Layanan yang akan diaktifkan:
distance-matrix-backend.googleapis.com - Autentikasi: Kunci API
- Memulai: Menyiapkan Distance Matrix API
- Referensi: Referensi Distance Matrix API
- Harga: Penggunaan dan penagihan Distance Matrix API
- Kebijakan: Kebijakan Distance Matrix API
- Catatan rilis: Catatan rilis Distance Matrix API
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_EXCEEDEDatauMAX_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, danduration_in_traffictidak akan ditampilkan. Hasil dapat bervariasi dari waktu ke waktu. Perbaikan: Tetapkandeparture_timekenowatau waktu mendatang denganmode=drivinguntuk 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
unitshanya mengubah teks di kolom jarak. Nilai jarak selalu dalam meter. Perbaikan: Bacadistance.valuesebagai meter, atau gunakandistance.textuntuk tampilan. Lihat /maps/documentation/distance-matrix/distance-matrix. - Masalah: Memanggil Distance Matrix API (Lama) dari project yang tidak mengaktifkannya akan menampilkan
REQUEST_DENIEDdistatusdanerror_messageyang tertaut keLegacyApiNotActivatedMapError. Asisten AI sering kali menghasilkan kode API lama secara default. Perbaikan: Lakukan migrasi ke Routes APIcomputeRouteMatrix(dengan headerX-Goog-FieldMask). Aktifkan API lama melalui formulir hanya sebagai tindakan jangka pendek. Lihat /maps/legacy#LegacyApiNotActivatedMapError.