Ringkasan Distance Matrix API (Lama)

Developer Wilayah Ekonomi Eropa (EEA)

Pengantar

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

Alasan menggunakan Distance Matrix API (Legacy)

Anda dapat menggunakan Distance Matrix API (Legacy) untuk membantu menentukan rute perjalanan yang paling efisien antara beberapa kemungkinan asal dan tujuan. Misalnya, pekerja mana yang akan dikirim ke lokasi kerja, atau dari gudang mana paket akan dikirim.

Yang dapat Anda lakukan dengan Distance Matrix API (Legacy)

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

Distance Matrix API (Legacy) memberikan informasi berdasarkan rute yang direkomendasikan antara titik awal dan akhir. Anda dapat meminta jenis data jarak berikut:

  • Jarak untuk moda transportasi yang dipilih
  • Jarak dalam kilometer atau mil
  • Perkiraan waktu tempuh dalam lalu lintas

peta yang menampilkan asal dan tujuan di peta dan dalam respons API

Cara kerja Distance Matrix API (Legacy)

Distance Matrix API (Legacy) menggunakan sejumlah asal (titik awal) dan tujuan, serta menampilkan jarak dan waktu tempuh antara setiap asal dan semua tujuan yang diminta, dimulai dengan asal pertama dalam permintaan dan dilanjutkan langkah demi langkah ke asal berikutnya.

Misalnya, jika permintaan Anda menentukan A dan B sebagai asal, serta C dan D sebagai tujuan, permintaan tersebut akan menampilkan jarak dan waktu tempuh dalam urutan ini:

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

Contoh berikut menunjukkan 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

Resource

Tabel berikut merangkum resource yang tersedia melalui Distance Matrix API (Legacy) beserta data yang ditampilkan.

Resource data Data yang ditampilkan Format yang ditampilkan
Matriks jarak

Berikan asal dan tujuan dalam bentuk ID tempat, alamat, atau koordinat lintang/bujur.

  • Jarak dan waktu tempuh antara setiap asal dan setiap tujuan
  • Durasi dalam lalu lintas jika Anda telah menentukan mode mengemudi dan waktu keberangkatan
  • JSON
  • XML

Cara menggunakan Distance Matrix API (Legacy)

1 Mulai Mulai dengan Menyiapkan project Google Cloud dan selesaikan petunjuk penyiapan yang mengikuti.
2 Coba permintaan matriks jarak Setelah memiliki kunci API, Anda dapat mulai menguji Distance Matrix API (Legacy) langsung dari browser. Lihat Contoh permintaan di panduan Memulai untuk melihat contohnya.
3 Buat permintaan yang lebih kompleks Coba permintaan yang menyediakan beberapa asal dan tujuan. Pelajari tentang parameter opsional untuk membatasi perhitungan, seperti waktu keberangkatan yang ditentukan, atau batasan rute. Lihat Parameter opsional di panduan Permintaan dan respons Distance Matrix (Legacy).
4 Pahami dasar-dasar respons Pelajari respons data untuk bersiap 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 tempuh.

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, open source berdasarkan Lisensi Apache 2.0. Download dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya