Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Maps Distance Matrix API

Untuk membantu Anda memulai, kami akan memandu Anda melalui Google Developers Console untuk melakukan beberapa hal terlebih dahulu:

  1. Buat atau pilih sebuah proyek
  2. Aktifkan Google Maps Distance Matrix API
  3. Buat kunci yang sesuai
Lanjutkan

Panduan Developer

Google Maps Distance Matrix API adalah layanan yang menyediakan waktu dan jarak perjalanan untuk matriks tempat asal dan tujuan.

Layanan ini juga tersedia sebagai bagian dari Google Maps JavaScript API sisi-klien, atau untuk penggunaan sisi-server dengan Java Client, Python Client, Go Client dan Node.js Client for Google Maps Services. Catatan: Batas penggunaan harian yang sama tetap berlaku bagaimana pun Anda menggunakan layanan. Elemen per hari dihitung sebagai jumlah kueri sisi-klien dan sisi-server.

Dokumen ini ditujukan bagi developer yang ingin menghitung jarak dan waktu tempuh perjalanan antara sejumlah titik dalam peta yang disediakan oleh salah satu Google Maps API. Dokumen ini menyediakan pengantar untuk menggunakan API dan materi referensi mengenai parameter yang tersedia.

Pengantar

Google Maps Distance Matrix API mengembalikan informasi berdasarkan rute yang disarankan antara titik awal dan titik akhir, sesuai perhitungan Google Maps API, dan terdiri dari baris-baris berisi nilai duration dan distance untuk setiap pasangan.

Layanan ini tidak mengembalikan informasi rute detail. Informasi rute bisa diperoleh dengan meneruskan satu tempat asal dan tujuan yang diinginkan ke Google Maps Directions API.

Sebelum Anda memulai development dengan Distance Matrix API, periksa persyaratan autentikasi (Anda memerlukan kunci API) dan batas penggunaan API.

Permintaan Distance Matrix

Permintaan Google Maps Distance Matrix API mengambil bentuk berikut:

https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters

dalam hal ini, outputFormat bisa berupa salah satu nilai berikut:

  • json (disarankan), menunjukkan keluaran dalam JavaScript Object Notation (JSON); atau
  • xml, menunjukkan keluaran berupa XML

Catatan: URL harus dienkodekan dengan benar agar valid dan dibatasi hingga 8192 karakter untuk semua layanan web. Perhatikan batas ini saat membuat URL Anda. Perhatikan, browser, proxy, dan server yang berbeda mungkin memiliki batas karakter URL yang berbeda pula.

HTTPS atau HTTP

Keamanan dianggap penting dan HTTPS disarankan kapan saja memungkinkan, khususnya untuk aplikasi yang berisi data pengguna sensitif, seperti lokasi pengguna, dalam permintaan. Dengan enkripsi HTTPS, aplikasi Anda menjadi lebih aman, dan lebih tahan terhadap aksi pengintaian atau perusakan.

Jika HTTPS tidak mungkin digunakan, untuk mengakses Google Maps Distance Matrix API melalui HTTP, gunakan:

http://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters

Parameter Permintaan

Beberapa parameter tertentu diperlukan sementara yang lainnya bersifat opsional. Sebagaimana standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&).

Parameter yang diperlukan

  • origins — Titik awal untuk menghitung jarak dan waktu perjalanan. Anda bisa memberikan satu atau beberapa lokasi yang dipisahkan dengan karakter pipa (|), dalam bentuk alamat, koordinat garis lintang/bujur, atau ID tempat:
    • Jika Anda meneruskan sebuah alamat, layanan akan melakukan geocode atas string itu dan mengubahnya menjadi koordinat garis lintang/bujur untuk menghitung jarak. Koordinat ini mungkin berbeda dengan yang dikembalikan oleh Google Maps Geocoding API, misalnya pintu masuk bangunan dan bukan pusatnya.
      origins=Bobcaygeon+ON|24+Sussex+Drive+Ottawa+ON
    • Jika Anda meneruskan koordinat garis lintang/bujur, koordinat akan digunakan tanpa diubah untuk menghitung jarak. Pastikan tidak ada spasi di antara nilai garis lintang dan garis bujur.
      origins=41.43206,-81.38992|-33.86748,151.20699
    • Jika Anda memberikan ID tempat, Anda harus mengawalinya dengan place_id. Anda hanya bisa menetapkan ID tempat jika permintaan menyertakan kunci API atau ID klien Google Maps APIs Premium Plan. Anda bisa mengambil ID tempat dari Google Maps Geocoding API dan Google Places API (termasuk Place Autocomplete). Untuk contoh menggunakan ID tempat dari Place Autocomplete, lihat Place Autocomplete dan Directions. Untuk informasi selengkapnya tentang ID tempat, lihat ringkasan ID tempat.
      origins=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE
    • Atau, Anda bisa memberikan serangkaian koordinat yang dienkodekan menggunakan Algoritme Polyline yang Dienkodekan. Ini sangat berguna jika Anda memiliki titik asal dalam jumlah besar, karena URL sangat pendek saat menggunakan polyline yang dienkodekan.
      • Polyline yang dienkodekan harus diawali dengan enc: dan diikuti oleh titik dua (:). Misalnya: origins=enc:gfo}EtohhU:
      • Anda juga bisa menyertakan beberapa polyline yang dienkodekan, yang dipisahkan dengan karakter pipa (|). Misalnya: origins=enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:|enc:udymA{~bxM:
  • destinations — Satu atau beberapa lokasi untuk digunakan sebagai titik akhir untuk menghitung jarak dan waktu perjalanan. Opsi untuk parameter destinations sama dengan opsi untuk parameter origins yang dijelaskan di atas.
  • key — Kunci API aplikasi Anda. Kunci ini mengidentifikasi aplikasi Anda untuk keperluan manajemen kuota. Pelajari cara mendapatkan kunci.

    Catatan: Pelanggan Google Maps APIs Premium Plan bisa memilih menggunakan kunci API atau ID klien dan tanda tangan digital yang valid, di permintaan Distance Matrix Anda. Dapatkan informasi selengkapnya tentang parameter autentikasi untuk pelanggan Premium Plan.

Contoh berikut menggunakan koordinat garis lintang/bujur untuk menetapkan koordinat tujuan:

https://maps.googleapis.com/maps/api/distancematrix/json?units=imperial&origins=40.6655101,-73.89188969999998&destinations=40.6905615%2C-73.9976592%7C40.6905615%2C-73.9976592%7C40.6905615%2C-73.9976592%7C40.6905615%2C-73.9976592%7C40.6905615%2C-73.9976592%7C40.6905615%2C-73.9976592%7C40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626%7C40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626&key=YOUR_API_KEY

Contoh berikut menampilkan permintaan yang sama menggunakan polyline yang dienkodekan:

https://maps.googleapis.com/maps/api/distancematrix/json?units=imperial&origins=40.6655101,-73.89188969999998&destinations=enc:_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV:&key=YOUR_API_KEY

Parameter opsional

  • mode (default-nya adalah driving) — Menetapkan moda transportasi yang akan digunakan saat menghitung jarak. Nilai yang valid dan detail permintaan lain ditetapkan di bagian Mode Perjalanan pada dokumen ini.
  • language — Bahasa yang digunakan untuk mengembalikan hasil.
    • Lihat daftar bahasa yang didukung. Google sering memperbarui bahasa yang didukung sehingga daftar ini mungkin tidak lengkap.
    • Jika language tidak diberikan, API akan berusaha menggunakan bahasa yang dipilih sebagaimana ditetapkan dalam header Accept-Language atau bahasa bawaan domain asal permintaan dikirim.
    • API akan melakukan yang terbaik untuk menyediakan alamat yang bisa dibaca oleh pengguna dan penduduk setempat. Untuk mencapai sasaran ini, API akan mengembalikan alamat dalam bahasa lokal, dan ditransliterasikan menjadi skrip yang bisa dibaca oleh pengguna jika perlu, dengan memperhatikan bahasa yang dipilih. Semua alamat lain dikembalikan dalam bahasa yang dipilih. Semua komponen alamat dikembalikan dalam bahasa yang sama, yang dipilih dari komponen pertama.
    • Jika nama tidak tersedia dalam bahasa yang dipilih, API menggunakan bahasa terdekat yang sesuai.
    • Bahasa yang dipilih berpengaruh kecil terhadap serangkaian hasil yang dipilih API untuk dikembalikan, dan urutan pengembaliannya. Geocoder menerjemahkan singkatan secara berbeda bergantung pada bahasa, seperti singkatan untuk tipe jalan, atau sinonim yang mungkin valid dalam satu bahasa tetapi tidak valid dalam bahasa lainnya. Misalnya, utca dan tér adalah sinonim untuk jalan dalam bahasa Hungaria.
  • avoid — Memasukkan pembatasan pada rute. Nilai yang valid ditetapkan di bagian Pembatasan pada dokumen ini. Hanya satu pembatasan yang bisa ditetapkan.
  • unit — Menetapkan sistem satuan yang akan digunakan saat menyatakan jarak sebagai teks. Lihat bagian Sistem Satuan pada dokumen ini untuk informasi selengkapnya.
  • arrival_time — Menetapkan waktu kedatangan yang diinginkan untuk permintaan angkutan umum, dalam detik sejak tengah malam, 1 Januari 1970 UTC. Anda bisa menetapkan salah satu dari departure_time atau arrival_time, tetapi tidak keduanya sekaligus. Perhatikan, arrival_time harus ditetapkan berupa integer.
  • departure_time — Waktu keberangkatan yang diinginkan. Anda bisa menetapkan waktu sebagai integer dalam detik sejak tengah malam, 1 Januari 1970 UTC. Atau, Anda bisa menetapkan nilai now, yang menyetel waktu keberangkatan ke waktu saat ini (dikoreksi ke detik terdekat). Waktu keberangkatan bisa ditetapkan dalam dua hal:
    • Untuk permintaan yang mode perjalanannya adalah angkutan umum: Anda juga bisa menetapkan salah satu dari departure_time atau arrival_time. Jika tidak ada waktu yang ditetapkan, default departure_time adalah sekarang (yaitu, waktu keberangkatan default adalah waktu saat ini).
    • Untuk permintaan yang mode perjalanannya adalah mengemudi: Anda bisa menetapkan departure_time untuk menerima durasi rute dan perjalanan (bidang respons: duration_in_traffic) yang mempertimbangkan kondisi lalu lintas. Opsi ini hanya tersedia jika permintaan berisi kunci API yang valid, atau tanda tangan dan ID klien Google Maps APIs Premium Plan yang valid. departure_time harus disetel ke waktu saat ini atau waktu mendatang. Tidak boleh waktu yang sudah lewat.

      Catatan: Permintaan Distance Matrix yang menetapkan departure_time jika mode=driving dibatasi maksimum 100 elemen per permintaan. Jumlah origins dikali jumlah destinations mendefinisikan jumlah elemen.

  • traffic_model (default-nya adalah best_guess) — Menetapkan asumsi yang akan digunakan saat menghitung waktu dalam lalu lintas. Setelan ini memengaruhi nilai yang dikembalikan di bidang duration_in_traffic dalam respons, yang berisi prediksi waktu dalam lalu lintas berdasarkan rata-rata historis. Parameter traffic_model hanya dapat ditetapkan untuk permintaan di mana moda perjalanan driving, dan di mana permintaan mengandung departure_time, dan hanya jika permintaan berisi kunci API atau ID klien Google Maps APIs Premium Plan. Nilai yang tersedia untuk parameter ini adalah:
    • best_guess (default) menunjukkan duration_in_traffic yang dikembalikan harus berupa perkiraan waktu tempuh terbaik berdasarkan informasi riwayat kondisi lalu lintas dan lalu lintas saat ini. Lalu lintas saat ini menjadi kian penting bila departure_time semakin dekat ke waktu sekarang.
    • optimistic menunjukkan duration_in_traffic yang dikembalikan lebih lama dari waktu tempuh sesungguhnya di hari-hari biasa, meskipun hari-hari tertentu dengan kondisi lalu lintas yang buruk mungkin melebihi nilai ini.
    • optimistic menunjukkan duration_in_traffic yang dikembalikan harus lebih singkat dari waktu tempuh sesungguhnya di hari biasa, meskipun hari-hari tertentu dengan kondisi lalu lintas yang baik bisa lebih cepat dari nilai ini.
  • transit_mode — Menetapkan satu atau beberapa mode angkutan umum yang disukai. Parameter ini hanya bisa ditetapkan untuk permintaan yang menggunakan mode transit. Parameter ini mendukung argumen berikut:
    • bus menunjukkan rute yang sudah dihitung akan mengutamakan perjalanan dengan bus.
    • subway menunjukkan rute yang sudah dihitung akan mengutamakan perjalanan dengan kereta bawah tanah.
    • train menunjukkan rute yang sudah dihitung akan mengutamakan perjalanan dengan kereta api.
    • tram menunjukkan rute yang sudah dihitung akan mengutamakan perjalanan dengan trem dan kereta ringan.
    • rail menunjukkan rute yang sudah dihitung akan mengutamakan perjalanan dengan kereta api, trem, kereta ringan, dan kereta bawah tanah. Ini sama dengan transit_mode=train|tram|subway.
  • transit_routing_preference — Menetapkan preferensi untuk permintaan angkutan umum. Dengan menggunakan parameter ini, Anda dapat membias opsi yang dikembalikan, daripada menerima rute default terbaik yang dipilih oleh API. Parameter ini hanya bisa ditetapkan untuk permintaan yang menggunakan mode transit. Parameter ini mendukung argumen berikut:
    • less_walking menunjukkan rute yang sudah dihitung akan mengutamakan jumlah berjalan kaki yang terbatas.
    • fewer_transfers menunjukkan rute yang sudah dihitung akan mengutamakan jumlah ganti angkutan yang terbatas.

Mode Perjalanan

Untuk penghitungan jarak, Anda bisa menetapkan mode transportasi yang akan digunakan. Secara default, jarak dihitung untuk mode mengemudi. Mode perjalanan berikut ini telah didukung:

  • driving (default) menunjukkan penghitungan jarak menggunakan jaringan jalan raya.
  • walking meminta penghitungan jarak untuk berjalan melalui jalur pejalan kaki & trotoar (bila tersedia).
  • bicycling meminta penghitungan jarak untuk bersepeda melalui jalur sepeda & jalan yang disukai (bila tersedia).
  • transit meminta perhitungan jarak melalui rute angkutan umum (bila tersedia). Nilai ini hanya dapat ditetapkan jika permintaan berisi kunci API atau ID klien Google Maps APIs Premium Plan. Jika Anda menyetel mode ke transit, Anda dapat menentukan departure_time atau arrival_time. Jika tidak ada waktu yang ditetapkan, default departure_time adalah sekarang (yaitu, waktu keberangkatan default adalah waktu saat ini). Anda juga bisa menyertakan transit_mode dan/atau transit_routing_preference.

* Catatan: Kadang-kadang rute berjalan dan bersepeda tidak menyertakan jalur pejalan kaki atau jalur bersepeda yang jelas, sehingga respons akan menampilkan warnings dalam hasil yang dikembalikan yang harus Anda tampilkan kepada pengguna.

Pembatasan

Jarak bisa dihitung dengan mengikuti pembatasan tertentu. Pembatasan ditunjukkan melalui penggunaan parameter avoid, dan sebuah argumen ke parameter itu yang menunjukkan pembatasan untuk avoid. Pembatasan berikut ini telah didukung:

  • avoid=tolls
  • avoid=highways
  • avoid=ferries
  • avoid=indoor

* Catatan: penambahan pembatasan tidak menghalangi rute berisi fitur yang dibatasi; cuma mencondongkan hasil ke rute yang lebih disukai.

Sistem Satuan

Hasil Distance Matrix berisi text dalam bidang distance untuk menunjukkan jarak rute yang dihitung. Sistem satuan yang akan digunakan bisa ditetapkan:

  • units=metric (default) mengembalikan jarak dalam kilometer dan meter.
  • units=imperial mengembalikan jarak dalam mil dan kaki.

* Catatan: setelan sistem satuan ini hanya memengaruhi text yang ditampilkan dalam bidang distance. Bidang distance juga berisi values yang selalu dinyatakan dalam meter.

Respons Distance Matrix

Respons terhadap kueri Google Maps Distance Matrix API dikembalikan dalam format yang ditunjukkan oleh flag output dalam jalur permintaan URL.

Dua contoh permintaan HTTP ditampilkan di bawah ini, yang meminta jarak dan durasi dari Vancouver, BC, Kanada dan dari Seattle, WA, AS, ke San Francisco, CA, AS dan ke Victoria, BC, Kanada.

Permintaan ini memperagakan penggunaan flag output JSON:

https://maps.googleapis.com/maps/api/distancematrix/json?origins=Vancouver+BC|Seattle&destinations=San+Francisco|Victoria+BC&mode=bicycling&language=fr-FR&key=YOUR_API_KEY

Permintaan ini memperagakan penggunaan flag output XML:

https://maps.googleapis.com/maps/api/distancematrix/xml?origins=Vancouver+BC|Seattle&destinations=San+Francisco|Vancouver+BC&mode=bicycling&language=fr-FR&key=YOUR_API_KEY

Permintaan ini akan mengembalikan empat elemen - dua waktu asal dua tujuan:

Vancouver ke San Francisco Vancouver ke Victoria
Seattle ke San Francisco Seattle ke Victoria

Hasil dikembalikan dalam baris, setiap baris berisi satu tempat asal yang dipasangkan dengan setiap tujuan.

Cobalah! Klik di sini untuk mengirimkan permintaan contoh dalam browser Anda. (Jika diminta untuk memilih aplikasi yang akan digunakan untuk membuka file, Anda bisa memilih browser atau editor teks favorit Anda.)

Klik tab di bawah ini untuk melihat contoh respons JSON dan XML.

JSON
{
  "status": "OK",
  "origin_addresses": [ "Vancouver, BC, Canada", "Seattle, État de Washington, États-Unis" ],
  "destination_addresses": [ "San Francisco, Californie, États-Unis", "Victoria, BC, Canada" ],
  "rows": [ {
    "elements": [ {
      "status": "OK",
      "duration": {
        "value": 340110,
        "text": "3 jours 22 heures"
      },
      "distance": {
        "value": 1734542,
        "text": "1 735 km"
      }
    }, {
      "status": "OK",
      "duration": {
        "value": 24487,
        "text": "6 heures 48 minutes"
      },
      "distance": {
        "value": 129324,
        "text": "129 km"
      }
    } ]
  }, {
    "elements": [ {
      "status": "OK",
      "duration": {
        "value": 288834,
        "text": "3 jours 8 heures"
      },
      "distance": {
        "value": 1489604,
        "text": "1 490 km"
      }
    }, {
      "status": "OK",
      "duration": {
        "value": 14388,
        "text": "4 heures 0 minutes"
      },
      "distance": {
        "value": 135822,
        "text": "136 km"
      }
    } ]
  } ]
}

Perhatikan, hasil ini biasanya harus di-parse jika Anda ingin mengekstrak nilai-nilai dari hasil ini. Mem-parse JSON relatif mudah. Lihat Mem-parse JSON untuk mengetahui beberapa pola desain yang disarankan.

XML
<?xml version="1.0" encoding="UTF-8"?>
<DistanceMatrixResponse>
 <status>OK</status>
 <origin_address>Vancouver, BC, Canada</origin_address>
 <origin_address>Seattle, État de Washington, États-Unis</origin_address>
 <destination_address>San Francisco, Californie, États-Unis</destination_address>
 <destination_address>Victoria, BC, Canada</destination_address>
 <row>
  <element>
   <status>OK</status>
   <duration>
    <value>340110</value>
    <text>3 jours 22 heures</text>
   </duration>
   <distance>
    <value>1734542</value>
    <text>1 735 km</text>
   </distance>
  </element>
  <element>
   <status>OK</status>
   <duration>
    <value>24487</value>
    <text>6 heures 48 minutes</text>
   </duration>
   <distance>
    <value>129324</value>
    <text>129 km</text>
   </distance>
  </element>
 </row>
 <row>
  <element>
   <status>OK</status>
   <duration>
    <value>288834</value>
    <text>3 jours 8 heures</text>
   </duration>
   <distance>
    <value>1489604</value>
    <text>1 490 km</text>
   </distance>
  </element>
  <element>
   <status>OK</status>
   <duration>
    <value>14388</value>
    <text>4 heures 0 minutes</text>
   </duration>
   <distance>
    <value>135822</value>
    <text>136 km</text>
   </distance>
  </element>
 </row>
</DistanceMatrixResponse>

Kami menyarankan Anda menggunakan json sebagai flag output yang dipilih kecuali jika layanan Anda memerlukan xml karena suatu alasan. Pemrosesan struktur hierarki XML memerlukan kehati-hatian, jadi Anda perlu mereferensikan simpul dan elemen yang tepat. Lihat Mem-parse XML dengan XPath untuk mengetahui beberapa pola desain yang disarankan bagi pemrosesan keluaran.

Bagian selebihnya dari dokumentasi ini akan menggunakan sintaks JSON.

Elemen Respons Distance Matrix

Respons Distance Matrix berisi elemen akar berikut ini:

  • status berisi metadata yang diminta. Lihat Kode Status di bawah ini.
  • origin_addresses berisi larik alamat sebagaimana dikembalikan oleh API dari permintaan asal Anda. Ini diformat dengan geocoder dan dilokalkan sesuai dengan parameter language yang diteruskan bersama permintaan.
  • destination_addresses berisi larik alamat sebagaimana dikembalikan oleh API dari permintaan asal. Sebagaimana dengan origin_addresses, ini dilokalkan jika sesuai.
  • rows berisi larik elements, yang pada gilirannya masing-masing akan berisi elemen status, duration, dan distance.

Kode Status

Bidang "status" dalam objek respons berisi status permintaan, dan mungkin berisi informasi debug yang berguna. Distance Matrix API mengembalikan bidang status tingkat atas, bersama informasi tentang permintaan secara umum, serta status bidang untuk setiap bidang elemen, bersama informasi tentang pasangan tempat asal-tujuan tertentu.

Kode Status Tingkat Atas
  • OK menunjukkan respons berisi result yang valid.
  • INVALID_REQUEST menunjukkan permintaan yang diberikan tidak valid.
  • MAX_ELEMENTS_EXCEEDED menunjukkan hasil dari tempat asal dan tujuan melebihi batas per-query.
  • OVER_QUERY_LIMIT menunjukkan layanan menerima terlalu banyak permintaan dari aplikasi Anda dalam jangka waktu yang diperbolehkan.
  • REQUEST_DENIED menunjukkan layanan menolak penggunaan layanan Distance Matrix oleh aplikasi Anda.
  • UNKNOWN_ERROR — menunjukkan permintaan Distance Matrix tidak bisa diproses karena kesalahan server. Permintaan mungkin berhasil jika Anda mencoba lagi.
Kode Status Tingkat Elemen
  • OK menunjukkan respons berisi result yang valid.
  • NOT_FOUND menunjukkan tempat asal dan/atau tujuan dari pasangan ini tidak bisa di-geocode.
  • ZERO_RESULTS menunjukkan tidak ada rute yang bisa ditemukan antara tempat asal dan tujuan.

Pesan Kesalahan

Bila kode status tingkat atas bukan OK, mungkin ada bidang error_message tambahan dalam objek respons Distance Matrix. Bidang ini berisi informasi lebih detail tentang alasan di balik kode status yang diberikan.

Catatan: Bidang ini tidak dijamin akan selalu ada, dan materinya bisa berubah.

Baris

Bila Google Maps Distance Matrix API mengembalikan hasilnya, maka akan ditempatkan dalam larik rows JSON. Sekalipun tidak ada hasil yang dikembalikan (misalnya jika tempat asal dan/atau tujuan tidak ada), ia tetap mengembalikan larik kosong. Respons XML terdiri dari nol atau beberapa elemen <row>.

Baris diurutkan sesuai dengan nilai dalam parameter origin permintaan. Masing-masing baris menyatakan satu tempat asal, dan masing-masing element dalam baris tersebut menyatakan pasangan tempat asal dengan nilai destination.

Masing-masing larik row berisi satu atau beberapa entri element, yang pada gilirannya akan berisi informasi tentang satu pasang tempat asal-tujuan.

Elemen

Informasi tentang setiap pasang tempat asal-tujuan dikembalikan dalam entri element. Sebuah element berisi bidang-bidang berikut:

  • status: Lihat Kode Status untuk daftar kemungkinan kode status.
  • duration: Lama waktu yang dibutuhkan untuk perjalanan rute ini, dinyatakan dalam detik (bidang value) dan sebagai text. Representasi tekstual dilokalkan sesuai dengan parameter language kueri.
  • duration_in_traffic: Lama waktu yang dibutuhkan untuk perjalanan rute ini, berdasarkan kondisi lalu lintas saat ini dan historis. Lihat parameter permintaan traffic_model untuk opsi yang bisa Anda gunakan untuk meminta agar nilai yang dikembalikan optimistik, pesimistik, atau perkiraan terbaik. Durasi dinyatakan dalam detik (bidang value) dan sebagai text. Representasi tekstual dilokalkan sesuai dengan parameter language kueri. Durasi dalam lalu lintas hanya dikembalikan jika berlaku semua hal berikut ini:

    • Permintaan berisi parameter departure_time.
    • Permintaan menyertakan kunci API yang valid, atau tanda tangan dan ID klien Google Maps APIs Premium Plan yang valid.
    • Kondisi lalu lintas tersedia untuk rute yang diminta.
    • Parameter mode disetel ke driving.
  • distance: Jarak total rute ini, dinyatakan dalam meter (value) dan sebagai text. Nilai tekstual menggunakan sistem satuan yang ditetapkan bersama parameter unit pada permintaan asal, atau region asal.
  • fare: Jika ada, berisi total tarif (yaitu, total biaya tiket) pada rute ini. Properti ini hanya dikembalikan untuk permintaan angkutan umum dan hanya untuk penyedia angkutan umum yang tersedia informasi tarifnya. Informasi ini menyertakan:
    • currency: Sebuah kode mata uang ISO 4217 menunjukkan mata uang yang digunakan dalam menyatakan jumlahnya.
    • value: Jumlah total tarif, dalam mata uang yang ditetapkan di atas.
    • text: Jumlah total tarif, diformat dalam bahasa yang diminta.

Di bawah ini adalah contoh element yang berisi informasi tarif:

{
  "status": "OK",
  "duration": {
    "value": 340110,
    "text": "3 jours 22 heures"
  },
  "distance": {
    "value": 1734542,
    "text": "1 735 km"
  }
  "fare" : {
    "currency" : "USD",
    "value" : 6,
    "text" : "$6.00"
  },
}

Parameter sensor

Google Maps API sebelumnya mengharuskan Anda menyertakan parameter sensor untuk menunjukkan apakah aplikasi Anda menggunakan sensor untuk menentukan lokasi pengguna. Parameter ini tidak lagi diperlukan.

Kirim masukan tentang...

Google Maps Distance Matrix API
Google Maps Distance Matrix API
Butuh bantuan? Kunjungi halaman dukungan kami.