Alasan menggunakan Distance Matrix API
Anda dapat menggunakan Distance Matrix API untuk membantu menentukan rute perjalanan yang paling efisien antara beberapa kemungkinan tempat asal dan tujuan. Misalnya, pekerja mana yang akan dikirim ke lokasi lowongan, atau dari gudang mana paket akan dikirim.
Apa yang dapat Anda lakukan dengan Distance Matrix API
Dengan Distance Matrix API, Anda dapat memberikan jarak dan waktu perjalanan untuk matriks tempat asal dan tujuan. Anda dapat menentukan beberapa opsi, termasuk moda transportasi, seperti mengemudi, bersepeda, transportasi umum, atau berjalan kaki, serta mode transportasi umum seperti bus, kereta bawah tanah, kereta api, trem, atau kereta api.
Distance Matrix API memberikan informasi berdasarkan rute yang direkomendasikan antara titik awal dan akhir. Anda dapat meminta jenis data jarak ini:
- Jarak untuk mode perjalanan yang dipilih
- Jarak dalam kilometer atau mil
- Perkiraan waktu tempuh dalam lalu lintas
Cara kerja Distance Matrix API
Distance Matrix API menggunakan berapa pun jumlah tempat asal (titik awal) dan tujuan, serta menampilkan jarak dan waktu perjalanan antara setiap tempat asal dan semua tujuan yang diminta, yang dimulai dengan tempat asal pertama dalam permintaan dan melanjutkan ke tempat berikutnya secara bertahap.
Misalnya, jika permintaan Anda menentukan A dan B sebagai tempat asal, serta C dan D sebagai tujuan, permintaan akan menampilkan jarak dan waktu tempuh dalam urutan ini:
- A ke C
- A ke D
- B ke C
- B ke D
Contoh berikut menampilkan permintaan untuk dua asal: Washington, DC, dan Boston, dengan satu tujuan, New York City, NY, dalam format JSON:
https://maps.googleapis.com/maps/api/distancematrix/json ?destinations=New%20York%20City%2C%20NY &origins=Washington%2C%20DC%7CBoston &units=imperial &key=YOUR_API_KEY
Referensi
Tabel berikut merangkum resource yang tersedia melalui Distance Matrix API bersama dengan data yang ditampilkannya.
Resource data | Data yang ditampilkan | Format pengembalian |
---|---|---|
Matriks jarak
Berikan asal dan tujuan dalam bentuk ID tempat, alamat, atau koordinat lintang/bujur. |
|
|
Cara menggunakan Distance Matrix API
1 | Melakukan persiapan. | Mulailah dengan Menyiapkan project Google Cloud Anda dan selesaikan petunjuk penyiapan yang mengikutinya. |
2 | Coba permintaan matriks jarak | Setelah memiliki kunci API, Anda dapat mulai menguji Distance Matrix API langsung dari browser. Lihat Contoh permintaan dalam panduan Memulai untuk mengetahui contohnya. |
3 | Menulis permintaan yang lebih kompleks | Coba permintaan yang menyediakan beberapa tempat asal dan tujuan. Pelajari parameter opsional untuk membatasi penghitungan, seperti waktu keberangkatan yang ditentukan, atau pembatasan rute. Lihat Parameter opsional di panduan Permintaan dan respons Distance Matrix. |
4 | Memahami dasar-dasar respons | Pelajari respons data untuk mempersiapkan penggunaan data matriks jarak untuk aplikasi Anda. Lihat Respons matriks jarak untuk mengetahui detailnya. |
5 | Gabungkan data matriks jarak ke dalam aplikasi Anda sendiri. | Anda dapat menggunakan data ini untuk menghitung jarak dan waktu perjalanan. |
Library klien yang tersedia
Panggil API ini dalam bahasa pilihan Anda melalui salah satu library klien berikut:
- Klien Java untuk Layanan Google Maps
- Klien Python untuk Layanan Google Maps
- Klien Go untuk Layanan Google Maps
- Klien Node.js untuk Layanan Google Maps
Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps adalah library klien yang didukung komunitas, dan merupakan open source berdasarkan Lisensi Apache 2.0. Download dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.
Langkah berikutnya
- Mulai menggunakan Distance Matrix: Buka Get Started.
- Memulai permintaan dan respons contoh: Buka permintaan dan respons Distance Matrix
- Ikuti praktik terbaik: Buka Web Service Best Practice.