Ringkasan Distance Matrix API

Distance Matrix API adalah layanan yang menerima permintaan HTTPS yang berisi tempat asal dan tujuan untuk moda transportasi tertentu. Untuk setiap kombinasi tempat asal dan tujuan, fitur ini akan menampilkan jarak dan durasi perjalanan.

Mengapa menggunakan Distance Matrix API

Anda dapat menggunakan Distance Matrix API untuk membantu menentukan yang paling efisien rute perjalanan di antara beberapa kemungkinan tempat asal dan tujuan. Sebagai contoh, pekerja mana yang akan dikirim ke lokasi lowongan, atau dari gudang mana yang akan mengirim paket.

Yang dapat Anda lakukan dengan Distance Matrix API

Dengan Distance Matrix API, Anda dapat memberikan jarak dan waktu perjalanan untuk matriks asal dan tujuan. Anda dapat menentukan beberapa opsi, termasuk moda transportasi, seperti mengemudi, bersepeda, transit atau berjalan, serta mode transportasi umum, seperti bus, kereta bawah tanah, kereta api, trem, atau kereta api.

Distance Matrix API menyediakan informasi berdasarkan rute yang direkomendasikan di antara titik awal dan akhir. Anda dapat meminta jenis data jarak berikut:

  • Jarak untuk mode perjalanan yang dipilih
  • Jarak dalam kilometer atau mil
  • Estimasi waktu perjalanan dalam lalu lintas

peta yang menampilkan tempat asal dan tujuan pada peta dan dalam respons API

Cara kerja Distance Matrix API

Distance Matrix API menggunakan sejumlah tempat asal (titik awal) dan tujuan, serta menampilkan jarak dan waktu perjalanan di antara keduanya tempat asal dan semua tujuan yang diminta, dimulai dengan asal pertama di permintaan dan melanjutkan ke langkah berikutnya.

Misalnya, jika permintaan Anda menentukan A dan B sebagai tempat asal, serta C dan D sebagai tujuan, permintaan akan menampilkan jarak dan waktu perjalanan dalam urutan berikut:

  • A ke C
  • A ke D
  • B ke C
  • B ke D

Contoh berikut menunjukkan permintaan untuk dua origin: Washington, DC dan Boston, dengan satu tujuan, New York City, NY, di 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

Resource

Tabel berikut meringkas sumber daya yang tersedia melalui Distance Matrix API bersama dengan data yang dihasilkannya.

Resource data Data yang dikembalikan Format pengembalian
Matriks jarak

Menyediakan origin dan tujuan dalam bentuk ID tempat, alamat, atau koordinat lintang/bujur.

  • Jarak dan waktu perjalanan antara setiap tempat asal dan masing-masing tujuan
  • Durasi dalam lalu lintas jika Anda menentukan mode mengemudi dan waktu keberangkatan
  • JSON
  • XML

Cara menggunakan Distance Matrix API

1 Melakukan penyiapan. Mulailah dengan Menyiapkan Project Google Cloud dan selesaikan penyiapan petunjuk yang mengikutinya.
2 Mencoba permintaan matriks jarak Setelah memiliki kunci API, Anda dapat mulai menguji Distance Matrix API langsung dari browser. Lihat Contoh permintaan dalam panduan Memulai untuk melihat contohnya.
3 Menulis permintaan yang lebih kompleks Coba permintaan yang menyediakan beberapa tempat asal dan tujuan. Pelajari parameter opsional untuk membatasi kalkulasi, seperti kalkulasi waktu keberangkatan, atau pembatasan rute. Lihat Parameter opsional dalam panduan Permintaan dan respons Distance Matrix.
4 Memahami dasar-dasar respons Pelajari respons data sebagai persiapan dalam menggunakan 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, Klien Python, Klien Go, dan Klien Node.js untuk Google Maps Layanan adalah library klien yang didukung komunitas, yang bersifat open source di bawah Lisensi Apache 2.0. Download semuanya dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya