Permintaan dan respons Distance Matrix API

Pengantar

Permintaan Distance Matrix API menggunakan format berikut:

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

dengan outputFormat dapat berupa salah satu nilai berikut:

• json (direkomendasikan) menunjukkan output dalam JavaScript Object Notation (JSON).
• xml menunjukkan output sebagai XML.

Beberapa parameter tertentu wajib ditentukan sementara yang lainnya bersifat opsional. Sesuai dengan standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&). Semua karakter yang dicadangkan (misalnya tanda plus "+") harus dikenkode ke URL. Daftar parameter dan kemungkinan nilainya tercantum di bawah.

Parameter yang diperlukan

• tujuan

  Satu atau beberapa lokasi yang akan digunakan sebagai titik akhir untuk menghitung jarak dan waktu perjalanan. Opsi untuk parameter tujuan sama dengan opsi untuk parameter asal.

• asal

  Titik awal untuk menghitung jarak dan waktu perjalanan. Anda dapat memberikan satu atau beberapa lokasi yang dipisahkan oleh karakter pipa (|), dalam bentuk ID tempat, alamat, atau koordinat lintang/bujur:

  • ID Tempat: Jika Anda memberikan ID tempat, Anda harus menambahkan awalan place_id:.
  • Alamat: Jika Anda meneruskan alamat, layanan akan melakukan geocoding string dan mengonversinya menjadi koordinat garis lintang/bujur untuk menghitung jarak. Koordinat ini mungkin berbeda dengan koordinat yang ditampilkan oleh Geocoding API, misalnya pintu masuk gedung, bukan pusatnya.
    Catatan: sebaiknya gunakan ID tempat daripada menggunakan alamat atau koordinat lintang/bujur. Menggunakan koordinat akan selalu menghasilkan titik yang dipaskan ke jalan terdekat dengan koordinat tersebut - yang mungkin bukan titik akses ke properti, atau bahkan jalan yang akan dengan cepat atau aman mengarah ke tujuan. Menggunakan alamat akan memberikan jarak ke tengah bangunan, bukan pintu masuk bangunan.
  • Koordinat: Jika Anda meneruskan koordinat lintang/bujur, koordinat tersebut akan disesuaikan dengan jalan terdekat. Sebaiknya teruskan ID tempat. Jika Anda meneruskan koordinat, pastikan tidak ada spasi di antara nilai garis lintang dan bujur.
  • Plus Codes harus diformat sebagai kode global atau kode gabungan. Format Plus Codes seperti yang ditunjukkan di sini (tanda plus diubah ke bentuk URL menjadi %2B dan spasi diubah ke bentuk URL menjadi %20):
    • kode global adalah kode area berisi 4 karakter dan kode lokal berisi 6 karakter atau lebih (849VCWC8+R9 dienkode menjadi 849VCWC8%2BR9).
    • kode majemuk adalah kode lokal berisi 6 karakter atau lebih dengan lokasi yang eksplisit (CWC8+R9 Mountain View, CA, USA dienkode menjadi CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Polyline yang Dienkode Atau, Anda dapat memberikan kumpulan koordinat yang dienkode menggunakan Algoritma Polyline yang Dienkode. Hal ini sangat berguna jika Anda memiliki banyak titik asal, karena URL akan jauh lebih pendek saat menggunakan polyline yang dienkode.
    • Polyline yang dienkode harus diawali dengan enc: dan diikuti dengan titik dua :. Contoh: origins=enc:gfo}EtohhU:
    • Anda juga dapat menyertakan beberapa polyline yang dienkode, yang dipisahkan oleh karakter pipa |. Contoh:

      origins=enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:|enc:udymA{~bxM:
      

Parameter opsional

• arrival_time

  Menentukan waktu kedatangan yang diinginkan untuk petunjuk arah transportasi umum, dalam detik sejak tengah malam, 1 Januari 1970 UTC. Anda dapat menentukan salah satu dari departure_time atau arrival_time, tetapi tidak keduanya. Perhatikan bahwa arrival_time harus ditentukan sebagai bilangan bulat.

• hindari

  Jarak bisa dihitung dengan mengikuti pembatasan tertentu. Pembatasan ditunjukkan dengan penggunaan parameter hindari, dan argumen untuk parameter tersebut menunjukkan pembatasan yang harus dihindari. Batasan berikut didukung:

  • tolls menunjukkan bahwa rute yang dihitung akan menghindari jalan/jembatan tol.
  • highways menunjukkan bahwa rute yang dihitung akan menghindari jalan raya.
  • ferries menunjukkan bahwa rute yang dihitung akan menghindari kapal feri.
  • indoor menunjukkan bahwa rute yang dihitung harus menghindari anak tangga di dalam ruangan untuk rute jalan kaki dan transportasi umum.

  Anda dapat meminta rute yang menghindari kombinasi jalan tol, jalan raya, dan kapal feri dengan meneruskan kedua batasan ke parameter avoid. Misalnya, avoid=tolls|highways|ferries.

  Catatan: Penambahan batasan tidak menghalangi rute yang menyertakan fitur yang dibatasi; hal ini memengaruhi hasil ke rute yang lebih menguntungkan.

• departure_time

  Menentukan waktu keberangkatan yang diinginkan. Anda dapat menentukan waktu sebagai bilangan bulat dalam detik sejak tengah malam, 1 Januari 1970 UTC. Jika departure_time setelah 9999-12-31T23:59:59.999999999Z ditentukan, API akan mengembalikan departure_time ke 9999-12-31T23:59:59.999999999Z. Atau, Anda dapat menentukan nilai now, yang menetapkan waktu keberangkatan ke waktu saat ini (benar hingga detik terdekat). Waktu keberangkatan bisa ditetapkan dalam dua hal:

  • Untuk permintaan dengan mode perjalanan transportasi umum: Anda dapat secara opsional menentukan salah satu dari departure_time atau arrival_time. Jika tidak ada waktu yang ditentukan, departure_time akan ditetapkan secara default ke sekarang (yaitu, waktu keberangkatan ditetapkan secara default ke waktu saat ini).
  • Untuk permintaan dengan mode perjalanan mengemudi: Anda dapat menentukan departure_time untuk menerima rute dan durasi perjalanan (kolom respons: duration_in_traffic) yang memperhitungkan kondisi lalu lintas. departure_time harus ditetapkan ke waktu saat ini atau waktu mendatang. Tidak boleh waktu yang sudah lewat.
  Catatan: Jika waktu keberangkatan tidak ditentukan, pilihan rute dan durasi akan didasarkan pada jaringan jalan dan kondisi lalu lintas rata-rata tanpa memperhitungkan waktu tertentu. Hasil untuk permintaan tertentu dapat berubah dari waktu ke waktu karena perubahan pada jaringan jalan, kondisi lalu lintas rata-rata yang diperbarui, dan sifat distribusi layanan. Hasilnya juga dapat bervariasi di antara rute yang hampir setara di semua waktu atau frekuensi.
  Catatan: Permintaan Distance Matrix yang menentukan departure_time saat mode=driving dibatasi hingga maksimum 100 elemen per permintaan. Jumlah asal dikalikan dengan jumlah tujuan menentukan jumlah elemen.

• language

  Bahasa yang digunakan untuk menampilkan hasil.

  • Lihat daftar bahasa yang didukung. Google sering memperbarui bahasa yang didukung, sehingga daftar ini mungkin tidak lengkap.
  • Jika language tidak diberikan, API akan mencoba menggunakan bahasa pilihan seperti yang ditentukan dalam header Accept-Language.
  • API ini berupaya sebaik mungkin untuk memberikan alamat jalan yang dapat dibaca oleh pengguna dan penduduk setempat. Untuk mencapai tujuan tersebut, API ini menampilkan alamat jalan dalam bahasa lokal, yang ditransliterasi ke skrip yang dapat dibaca oleh pengguna jika perlu, dengan memperhatikan bahasa pilihan. Semua alamat lainnya ditampilkan dalam bahasa pilihan. Komponen alamat semuanya ditampilkan dalam bahasa yang sama, yang dipilih dari komponen pertama.
  • Jika nama tidak tersedia dalam bahasa pilihan, API akan menggunakan kecocokan terdekat.
  • Bahasa pilihan memiliki sedikit pengaruh pada kumpulan hasil yang dipilih API untuk ditampilkan, dan urutan penampilannya. Geocoder menafsirkan singkatan secara berbeda bergantung pada bahasa, seperti singkatan untuk jenis jalan, atau sinonim yang mungkin valid dalam satu bahasa, tetapi tidak dalam bahasa lain. Misalnya, utca dan tér adalah sinonim untuk jalan dalam bahasa Hungaria.

• mode

  Untuk penghitungan jarak dan arah, Anda dapat menentukan moda transportasi yang akan digunakan. Secara default, mode DRIVING digunakan. Secara default, rute dihitung sebagai rute mengemudi. Mode perjalanan berikut didukung:

  • driving (default) menunjukkan rute mengemudi standar atau jarak menggunakan jaringan jalan.
  • walking meminta rute atau jarak jalan kaki menggunakan jalur pejalan kaki & trotoar (jika tersedia).
  • bicycling meminta rute atau jarak bersepeda menggunakan jalur sepeda & jalan yang disukai (jika tersedia).
  • transit meminta rute atau jarak menggunakan rute transportasi umum (jika tersedia). Jika menyetel mode ke transportasi umum, Anda dapat secara opsional menentukan departure_time atau arrival_time. Jika tidak ada waktu yang ditentukan, departure_time akan ditetapkan secara default ke sekarang (yaitu, waktu keberangkatan akan ditetapkan secara default ke waktu saat ini). Anda juga dapat menyertakan transit_mode dan/atau transit_routing_preference secara opsional.
  Catatan: Rute jalan kaki dan bersepeda terkadang tidak menyertakan jalur pejalan kaki atau bersepeda yang jelas, sehingga rute ini akan menampilkan peringatan dalam hasil yang ditampilkan yang harus Anda tampilkan kepada pengguna.
  Catatan: Perjalanan transportasi umum tersedia hingga 7 hari sebelumnya atau hingga 100 hari ke depan, bergantung pada ketersediaan informasi transportasi umum yang disediakan oleh penyedia data. Jadwal transportasi umum sering berubah, perjalanan transportasi umum yang tersedia dapat berubah seiring waktu dan tidak ada jaminan untuk memberikan hasil yang konsisten untuk prediksi jauh di muka.

• region

  Kode wilayah, yang ditentukan sebagai nilai dua karakter ccTLD ("domain level teratas"). Sebagian besar kode ccTLD identik dengan kode ISO 3166-1, dengan beberapa pengecualian. Misalnya, ccTLD Inggris Raya adalah "uk" (.co.uk), sedangkan kode ISO 3166-1-nya adalah "gb" (secara teknis untuk entitas "Britania Raya dan Irlandia Utara").

• traffic_model

  Menentukan asumsi yang akan digunakan saat menghitung waktu dalam lalu lintas. Setelan ini memengaruhi nilai yang ditampilkan di kolom duration_in_traffic dalam respons, yang berisi prediksi waktu lalu lintas berdasarkan rata-rata historis. Parameter traffic_model hanya dapat ditentukan untuk rute mengemudi jika permintaan menyertakan departure_time. Nilai yang tersedia untuk parameter ini adalah:

  • best_guess (default) menunjukkan bahwa duration_in_traffic yang ditampilkan akan berupa perkiraan waktu tempuh terbaik berdasarkan informasi historis kondisi lalu lintas dan lalu lintas live. Lalu lintas live menjadi lebih penting jika departure_time lebih dekat ke waktu sekarang.
  • pessimistic menunjukkan bahwa duration_in_traffic yang ditampilkan biasanya akan lebih lama daripada waktu tempuh sesungguhnya, meskipun pada hari-hari tertentu dengan kondisi lalu lintas yang sangat padat dapat lebih lama dari nilai ini.
  • optimistic menunjukkan bahwa duration_in_traffic yang ditampilkan biasanya akan lebih singkat daripada waktu tempuh yang sesungguhnya, meskipun jika hari-hari tertentu dengan kondisi lalu lintas yang sangat lancar dapat lebih cepat dari nilai ini.

  Nilai default best_guess akan memberikan prediksi yang paling berguna untuk sebagian besar kasus penggunaan. Ada kemungkinan prediksi waktu tempuh best_guess lebih singkat daripada optimistic, atau sebaliknya, lebih lama daripada pessimistic, karena cara model prediksi best_guess mengintegrasikan informasi lalu lintas live.

• transit_mode

  Menentukan satu atau beberapa preferensi moda transportasi umum. Parameter ini hanya dapat ditentukan untuk rute transportasi umum. Parameter ini mendukung argumen berikut:

  • bus menunjukkan bahwa rute yang dihitung akan mengutamakan perjalanan dengan bus.
  • subway menunjukkan bahwa rute yang dihitung akan mengutamakan perjalanan dengan kereta bawah tanah.
  • train menunjukkan bahwa rute yang dihitung akan mengutamakan perjalanan dengan kereta api.
  • tram menunjukkan bahwa rute yang dihitung akan mengutamakan perjalanan dengan trem dan LRT.
  • rail menunjukkan bahwa rute yang dihitung akan mengutamakan perjalanan dengan kereta api, trem, LRT, dan kereta bawah tanah. Fungsi ini setara dengan transit_mode=train|tram|subway.

• transit_routing_preference

  Menentukan preferensi untuk rute transportasi umum. Dengan parameter ini, Anda dapat memilih opsi yang ditampilkan, alih-alih menerima rute terbaik default yang dipilih oleh API. Parameter ini hanya dapat ditentukan untuk rute transportasi umum. Parameter ini mendukung argumen berikut:

  • less_walking menunjukkan bahwa rute yang dihitung akan mengutamakan rute yang tidak memerlukan berjalan kaki terlalu jauh.
  • fewer_transfers menunjukkan bahwa rute yang dihitung akan mengutamakan jumlah transfer tertentu.

• unit

  Menentukan sistem satuan yang akan digunakan saat menampilkan hasil.

  Catatan: setelan sistem unit ini hanya memengaruhi teks yang ditampilkan dalam kolom jarak. Kolom jarak juga berisi nilai yang selalu dinyatakan dalam meter.

Contoh permintaan

Contoh ini menggunakan koordinat lintang/bujur untuk menentukan koordinat tujuan:

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

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=40.6655101%2C-73.89188969999998&destinations=40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626&key=YOUR_API_KEY'

Contoh ini menggunakan kode plus untuk menentukan koordinat tujuan:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=San%20Francisco
  &origins=849VCWC8%2BR9
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=849VCWC8%2BR9&destinations=San%20Francisco&key=YOUR_API_KEY'

Contoh ini menunjukkan permintaan yang sama menggunakan polyline yang dienkode:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=enc%3A_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV%3A
  &origins=40.6655101%2C-73.89188969999998
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=40.6655101%2C-73.89188969999998&destinations=enc%3A_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV%3A&key=YOUR_API_KEY'

Informasi lalu lintas

Informasi lalu lintas digunakan jika semua hal berikut terjadi (ini adalah kondisi yang wajib dipenuhi untuk menerima kolom duration_in_traffic dalam respons Distance Matrix):

• Parameter mode perjalanan adalah driving, atau belum ditetapkan (driving adalah mode perjalanan default).
• Permintaan menyertakan parameter departure_time yang valid. departure_time dapat ditetapkan ke waktu saat ini atau waktu mendatang. Tidak boleh waktu yang sudah lewat.

Secara opsional, Anda dapat menyertakan parameter traffic_model dalam permintaan untuk menentukan asumsi yang akan digunakan saat menghitung waktu dalam lalu lintas.

URL berikut memulai permintaan Distance Matrix untuk jarak mengemudi antara Boston, MA atau Charlestown, MA, dan Lexington, MA serta Concord, MA. Permintaan mencakup waktu keberangkatan, yang memenuhi semua persyaratan untuk menampilkan kolom duration_in_traffic dalam respons Distance Matrix.

https://maps.googleapis.com/maps/api/distancematrix/json
  ?departure_time=now
  &destinations=Lexington%2CMA%7CConcord%2CMA
  &origins=Boston%2CMA%7CCharlestown%2CMA
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Boston%2CMA%7CCharlestown%2CMA&destinations=Lexington%2CMA%7CConcord%2CMA&departure_time=now&key=YOUR_API_KEY'

{
  "destination_addresses": ["Lexington, MA, USA", "Concord, MA, USA"],
  "origin_addresses": ["Boston, MA, USA", "Charlestown, Boston, MA, USA"],
  "rows":
    [
      {
        "elements":
          [
            {
              "distance": { "text": "33.3 km", "value": 33253 },
              "duration": { "text": "27 mins", "value": 1620 },
              "duration_in_traffic": { "text": "34 mins", "value": 2019 },
              "status": "OK",
            },
            {
              "distance": { "text": "41.5 km", "value": 41491 },
              "duration": { "text": "33 mins", "value": 1981 },
              "duration_in_traffic": { "text": "39 mins", "value": 2342 },
              "status": "OK",
            },
          ],
      },
      {
        "elements":
          [
            {
              "distance": { "text": "31.1 km", "value": 31100 },
              "duration": { "text": "26 mins", "value": 1543 },
              "duration_in_traffic": { "text": "29 mins", "value": 1754 },
              "status": "OK",
            },
            {
              "distance": { "text": "39.3 km", "value": 39338 },
              "duration": { "text": "32 mins", "value": 1904 },
              "duration_in_traffic": { "text": "35 mins", "value": 2077 },
              "status": "OK",
            },
          ],
      },
    ],
  "status": "OK",
}

 OK
 Boston, MA, USA
 Charlestown, Boston, MA, USA
 Lexington, MA, USA
 Concord, MA, USA
 
  
   OK
   
    1620
    27 mins
   
   
    33253
    33.3 km
   
   
    2018
    34 mins
   
  
  
   OK
   
    1981
    33 mins
   
   
    41491
    41.5 km
   
   
    2342
    39 mins
   
  
 
 
  
   OK
   
    1543
    26 mins
   
   
    31100
    31.1 km
   
   
    1759
    29 mins
   
  
  
   OK
   
    1904
    32 mins
   
   
    39338
    39.3 km
   
   
    2077
    35 mins
   
  
 

Pengubah Lokasi

Anda dapat menggunakan pengubah lokasi untuk menunjukkan bagaimana seharusnya pengemudi mendekati lokasi tertentu, dengan menggunakan pengubah side_of_road untuk menentukan sisi jalan yang harus digunakan, atau dengan menentukan arah untuk menunjukkan arah perjalanan yang benar.

Menentukan bahwa rute yang dihitung harus melewati sisi jalan tertentu

Saat menentukan lokasi, Anda dapat meminta agar rute yang dihitung melewati sisi jalan yang cenderung menjadi titik jalan dengan menggunakan awalan side_of_road:. Misalnya, permintaan ini akan menampilkan jarak untuk rute panjang sehingga kendaraan berakhir di sisi jalan yang tujuan perjalanannya cenderung mengarah ke sana:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=side_of_road%3A37.7663444%2C-122.4412006
  &origins=37.7680296%2C-122.4375126
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=37.7680296%2C-122.4375126&destinations=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'

Saat menggunakan side_of_road: dengan polyline yang dienkode, pengubah diterapkan ke setiap lokasi di sepanjang polyline. Misalnya, kedua tujuan dalam permintaan ini menggunakan parameter:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=side_of_road%3Aenc%3A%7BoqeF%60fejV%5BnC%3A
  &origins=San%20Francisco%20City%20hall
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=San%20Francisco%20City%20hall&destinations=side_of_road%3Aenc%3A%7BoqeF%60fejV%5BnC%3A&key=YOUR_API_KEY'

Pengubah side_of_road: hanya dapat digunakan dengan batasan ini:

• Parameter mode perjalanan adalah driving, atau tidak ditentukan (driving adalah mode perjalanan default).

Menentukan bahwa rute yang dihitung harus memiliki arah tertentu

Saat menentukan lokasi, Anda dapat meminta agar rute yang dihitung melewati lokasi dengan arah tujuan tertentu. Judul ini ditentukan dengan awalan heading=X:, dengan X adalah nilai derajat bilangan bulat antara 0 (inklusif) dan 360 (eksklusif). Arah 0 menunjukkan Utara, 90 menunjukkan Timur, dan seterusnya searah jarum jam. Misalnya, dalam permintaan ini, rute yang dihitung menuju timur dari tempat asal, lalu berbelok U:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=37.773245%2C-122.469502
  &origins=heading%3D90%3A37.773279%2C-122.468780
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=heading%3D90%3A37.773279%2C-122.468780&destinations=37.773245%2C-122.469502&key=YOUR_API_KEY'

Pengubah heading=X: hanya dapat digunakan dengan batasan berikut:

• Parameter mode perjalanan adalah driving, bicycling, atau tidak ditentukan (driving adalah mode perjalanan default).
• Pengubah side_of_road tidak ditentukan untuk lokasi yang sama.
• Lokasi ditentukan dengan nilai lintang/bujur. Anda tidak boleh menggunakan heading dengan alamat, ID Tempat, atau polyline yang dienkode.

Permintaan dan respons Distance Matrix

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

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=San%20Francisco%7CVictoria%20BC
  &language=fr-FR
  &mode=bicycling
  &origins=Vancouver%20BC%7CSeattle
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Vancouver%20BC%7CSeattle&destinations=San%20Francisco%7CVictoria%20BC&mode=bicycling&language=fr-FR&key=YOUR_API_KEY'

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

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

{
  "destination_addresses":
    ["San Francisco, Californie, États-Unis", "Victoria, BC, Canada"],
  "origin_addresses":
    ["Vancouver, BC, Canada", "Seattle, Washington, États-Unis"],
  "rows":
    [
      {
        "elements":
          [
            {
              "distance": { "text": "1 712 km", "value": 1711765 },
              "duration": { "text": "3 jours 16 heures", "value": 318119 },
              "status": "OK",
            },
            {
              "distance": { "text": "140 km", "value": 139695 },
              "duration": { "text": "6 heures 49 minutes", "value": 24567 },
              "status": "OK",
            },
          ],
      },
      {
        "elements":
          [
            {
              "distance": { "text": "1 452 km", "value": 1451704 },
              "duration": { "text": "3 jours 2 heures", "value": 266680 },
              "status": "OK",
            },
            {
              "distance": { "text": "146 km", "value": 146500 },
              "duration": { "text": "2 heures 53 minutes", "value": 10374 },
              "status": "OK",
            },
          ],
      },
    ],
  "status": "OK",
}

 OK
 Vancouver, BC, Canada
 Seattle, Washington, États-Unis
 San Francisco, Californie, États-Unis
 Victoria, BC, Canada
 
  
   OK
   
    318119
    3 jours 16 heures
   
   
    1711765
    1 712 km
   
  
  
   OK
   
    24567
    6 heures 49 minutes
   
   
    139695
    140 km
   
  
 
 
  
   OK
   
    266680
    3 jours 2 heures
   
   
    1451704
    1 452 km
   
  
  
   OK
   
    10374
    2 heures 53 minutes
   
   
    146500
    146 km
   
  
 

DistanceMatrixResponse

DistanceMatrixStatus

Kode status yang ditampilkan oleh layanan.

• OK menunjukkan bahwa respons berisi hasil yang valid.
• INVALID_REQUEST menunjukkan bahwa permintaan yang diberikan tidak valid.
• MAX_ELEMENTS_EXCEEDED menunjukkan bahwa hasil dari tempat asal dan tujuan melampaui batas per kueri.
• MAX_DIMENSIONS_EXCEEDED menunjukkan bahwa jumlah asal atau tujuan melebihi batas per kueri.
• OVER_DAILY_LIMIT menunjukkan salah satu hal berikut:
  • Kunci API tidak ada atau tidak valid.
  • Penagihan belum diaktifkan di akun Anda.
  • Batas penggunaan yang ditentukan sendiri telah terlampaui.
  • Metode pembayaran yang diberikan sudah tidak valid (misalnya, kartu kredit yang sudah tidak berlaku).
• OVER_QUERY_LIMIT menunjukkan bahwa layanan telah menerima terlalu banyak permintaan dari aplikasi Anda dalam jangka waktu yang diizinkan.
• REQUEST_DENIED menunjukkan bahwa layanan menolak penggunaan layanan Distance Matrix oleh aplikasi Anda.
• UNKNOWN_ERROR menunjukkan bahwa permintaan Distance Matrix tidak dapat diproses karena terjadi error server. Permintaan mungkin berhasil jika Anda mencoba lagi.

DistanceMatrixRow

DistanceMatrixElement

Fare

Total tarif untuk rute.

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}

DistanceMatrixElementStatus

• OK menunjukkan bahwa respons berisi hasil yang valid.
• NOT_FOUND menunjukkan bahwa tempat asal dan/atau tujuan dari pasangan ini tidak dapat di-geocode.
• ZERO_RESULTS menunjukkan tidak ada rute yang dapat ditemukan antara tempat asal dan tujuan.
• MAX_ROUTE_LENGTH_EXCEEDED menunjukkan bahwa rute yang diminta terlalu panjang dan tidak dapat diproses.

TextValueObject

Objek yang berisi nilai numerik dan representasi teks yang diformat.