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
- Layanan yang akan diaktifkan:
directions-backend.googleapis.com - Autentikasi: Kunci API
- Memulai: Menyiapkan Directions API
- Referensi: Referensi Directions API
- Harga: Penggunaan dan penagihan Directions API
- Kebijakan: Kebijakan Directions API
- Catatan rilis: Catatan rilis Directions API
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 statusZERO_RESULTS. Perbaikan: Gunakan titik jalan persinggahan (tanpa awalanvia:) 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 lokasiside_of_roadatauheadingakan 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 hilangkanoptimize:true,departure_time(untuk mengemudi),side_of_road, danheadingagar tetap menggunakan SKU Essentials. Lihat /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku. - Masalah: Untuk mengemudi,
departure_timetidak boleh di masa lalu (permintaan gagal denganINVALID_REQUEST). Tanpadeparture_time, rute dan durasi menggunakan lalu lintas rata-rata yang tidak bergantung pada waktu, dan tidak adaduration_in_trafficyang ditampilkan. Perbaikan: Tetapkandeparture_timekenowatau waktu mendatang denganmode=drivinguntuk mendapatkanduration_in_traffic. Permintaan yang menampilkanduration_in_trafficakan ditagih dengan SKU Directions Advanced (Pro). Lihat /maps/documentation/directions/get-directions.