Referensi cepat Directions API

Directions API (Lama) adalah layanan web yang menghitung rute antarlokasi untuk mengemudi, berjalan kaki, bersepeda, dan transportasi umum, termasuk rute multibagian dengan titik jalan, serta menampilkan rute, segmen, dan langkah dalam JSON atau XML. API ini berstatus Lama: mulai Oktober 2026, API ini tidak dapat diaktifkan untuk project Google Cloud baru; migrasikan ke Routes API.

Directions API: fakta penting

  • Produk: Directions API
  • Juga dikenal sebagai: Directions API (Lama)
  • Kategori: Rute
  • Platform: Layanan web (REST)
  • Berjalan di: Server (kode backend)
  • Tahap peluncuran: GA
  • Siklus proses: Lama
  • Digantikan oleh: Routes API
  • Ringkasan: Ringkasan Directions API
  • Ketersediaan regional: Global. Cakupan bervariasi menurut wilayah dan mode perjalanan (transportasi umum bergantung pada data dari penyedia transportasi umum). (detail cakupan)

Directions API: kapan harus menggunakannya

Gunakan Directions API jika:

  • Anda mengelola project Google Cloud yang sudah mengaktifkan Directions API (Lama) dan memanggil maps/api/directions.
  • Anda memerlukan rute sisi server untuk mengemudi, berjalan kaki, bersepeda, atau transportasi umum (hanya titik jalan untuk mode non-transportasi umum), dalam format JSON atau XML, di project yang ada.

Jangan gunakan Directions API jika:

  • Anda memulai project Google Cloud baru; mulai Oktober 2026, Directions API (Lama) tidak dapat diaktifkan untuk project baru. Gunakan Routes API.
  • Anda memerlukan fitur pemilihan rute baru dan peningkatan performa. Gunakan Routes API.
  • Anda memerlukan waktu dan jarak perjalanan untuk banyak tempat asal dan tujuan dalam satu permintaan. Gunakan Routes API.

Directions API: penyiapan

Directions API: kesalahan umum

  • Masalah: Permintaan ke Directions API (Lama) dari project yang tidak mengaktifkan API lama akan gagal dengan LegacyApiNotActivatedMapError. Perbaikan: Jika Anda adalah pemilik aplikasi, migrasikan ke Routes API. Sebagai solusi jangka pendek saat Anda bermigrasi atau menunggu update aplikasi, Anda dapat mengaktifkan API lama dengan mengisi formulir aktivasi API lama. Lihat /maps/legacy.
  • Masalah: Menggunakan awalan via: pada titik jalan akan menjadikannya titik jalan ketat, yang dapat menyebabkan rute memutar yang parah atau status ZERO_RESULTS. Perbaikan: Gunakan titik jalan persinggahan (tanpa awalan via:) kecuali jika diperlukan titik lintas yang ketat. Lihat /maps/documentation/directions/get-directions.
  • Masalah: Permintaan dengan 11 hingga 25 titik jalan, optimize:true, durasi yang memperhitungkan lalu lintas (duration_in_traffic), atau pengubah lokasi side_of_road atau heading akan ditagih dengan SKU Directions Advanced (Pro) yang lebih tinggi. Perbaikan: Gunakan fitur ini hanya saat Anda membutuhkannya; pertahankan titik jalan pada 10 atau kurang dan hilangkan optimize:true, departure_time (untuk mengemudi), side_of_road, dan heading agar tetap menggunakan SKU Essentials. Lihat /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku.
  • Masalah: Untuk mengemudi, departure_time tidak boleh di masa lalu (permintaan gagal dengan INVALID_REQUEST). Tanpa departure_time, rute dan durasi menggunakan lalu lintas rata-rata yang tidak bergantung pada waktu, dan tidak ada duration_in_traffic yang ditampilkan. Perbaikan: Tetapkan departure_time ke now atau waktu mendatang dengan mode=driving untuk mendapatkan duration_in_traffic. Permintaan yang menampilkan duration_in_traffic akan ditagih dengan SKU Directions Advanced (Pro). Lihat /maps/documentation/directions/get-directions.