Permintaan dan respons Distance Matrix API (Lama)

Developer Wilayah Ekonomi Eropa (EEA)

Pengantar

Permintaan Distance Matrix API (Lama) menggunakan format berikut:

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

dengan outputFormat dapat berupa salah satu dari 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 khusus (misalnya tanda plus "+") harus berenkode URL. Daftar parameter dan kemungkinan nilainya diuraikan 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 destinations sama dengan opsi untuk parameter origins.

  • origins

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

    • ID Tempat: Jika Anda memberikan ID tempat, Anda harus mengawalinya dengan place_id:.
    • Alamat: Jika Anda meneruskan alamat, layanan akan melakukan geocoding pada string dan mengonversinya menjadi koordinat lintang/bujur untuk menghitung jarak. Koordinat ini mungkin berbeda dari yang ditampilkan oleh Geocoding API, misalnya pintu masuk bangunan, bukan pusatnya.
      Catatan: penggunaan ID tempat lebih disarankan daripada penggunaan alamat atau koordinat lintang/bujur. Menggunakan koordinat akan selalu menghasilkan titik yang diposisikan ke jalan terdekat dengan koordinat tersebut - yang mungkin bukan titik akses ke properti, atau bahkan jalan yang akan mengarah ke tujuan dengan cepat atau aman. Penggunaan alamat akan memberikan jarak ke pusat bangunan, bukan ke pintu masuk bangunan.
    • Koordinat: Jika Anda meneruskan koordinat lintang/bujur, koordinat tersebut akan diposisikan ke jalan terdekat. Sebaiknya teruskan ID tempat. Jika Anda meneruskan koordinat, pastikan tidak ada spasi di antara nilai 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 gabungan 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 sekumpulan 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 dengan 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 rute transportasi umum, dalam detik sejak tengah malam, 1 Januari 1970 UTC. Anda dapat menentukan 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 avoid, dan argumen untuk parameter tersebut yang menunjukkan pembatasan yang harus dihindari. Pembatasan berikut didukung:

    • tolls menunjukkan bahwa rute yang dihitung harus 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 tangga dalam ruangan untuk rute jalan kaki dan transportasi umum.

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

    Catatan: Penambahan pembatasan tidak menghalangi rute yang menyertakan fitur yang dibatasi; hal ini membiaskan 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 yang lebih baru dari 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 (tepat hingga detik terdekat). Waktu keberangkatan bisa ditetapkan dalam dua hal:

    • Untuk permintaan dengan mode transportasi umum: Anda dapat 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 didasarkan pada jaringan jalan dan kondisi lalu lintas rata-rata tanpa memperhitungkan waktu tertentu. Hasil untuk permintaan tertentu dapat berubah seiring waktu karena perubahan pada jaringan jalan, kondisi lalu lintas rata-rata yang diperbarui, dan sifat layanan yang terdistribusi. Hasilnya juga dapat bervariasi di antara rute yang hampir setara di semua waktu atau frekuensi.
    Catatan: Permintaan matriks jarak yang menentukan departure_time saat mode=driving dibatasi hingga maksimum 100 elemen per permintaan. Jumlah asal dikalikan dengan jumlah tujuan menentukan jumlah elemen.

  • bahasa

    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 di header Accept-Language.
    • API ini berupaya sebaik mungkin untuk memberikan alamat yang dapat dibaca oleh pengguna dan penduduk setempat. Untuk mencapai tujuan tersebut, API ini menampilkan alamat jalan dalam bahasa lokal, yang ditransliterasikan ke skrip yang dapat dibaca oleh pengguna jika perlu, dengan mengamati 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 pengaruh kecil pada kumpulan hasil yang dipilih API untuk ditampilkan, dan urutan kemunculannya. 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 rute, Anda dapat menentukan moda transportasi yang akan digunakan. Secara default, mode DRIVING digunakan. Secara default, rute dihitung sebagai rute mobil. Mode perjalanan berikut didukung:

    • driving (default) menunjukkan rute mobil atau jarak standar menggunakan jaringan jalan.
    • walking meminta rute atau jarak jalan kaki menggunakan jalur pejalan kaki & trotoar (jika tersedia).
    • bicycling meminta rute sepeda atau jarak bersepeda menggunakan jalur sepeda & jalan yang disukai (jika tersedia).
    • transit meminta rute atau jarak menggunakan rute transportasi umum (jika tersedia). Jika Anda menetapkan mode ke transportasi umum, Anda dapat menentukan 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). 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 jalur sepeda 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 diberikan 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 sebelumnya.

  • region

    Kode wilayah, yang ditetapkan 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 "The United Kingdom of Great Britain and Northern Ireland").

  • 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 mobil 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 perjalanan terbaik berdasarkan informasi historis kondisi lalu lintas dan info lalu lintas real time. 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 perjalanan 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 perjalanan 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 perjalanan best_guess mungkin lebih singkat daripada optimistic, atau lebih lama daripada pessimistic, karena cara model prediksi best_guess mengintegrasikan informasi lalu lintas live.

  • transit_mode

    Menentukan satu atau beberapa moda transportasi umum yang diinginkan. 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 memprioritaskan opsi yang ditampilkan, alih-alih menerima rute terbaik default yang ditentukan oleh API. This parameter may only be specified for transit directions. 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 unit 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:

URL

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

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 Plus Codes untuk menentukan koordinat tujuan:

URL

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

curl

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:

URL

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

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 terpenuhi 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 Anda 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 ini menyertakan waktu keberangkatan, yang memenuhi semua persyaratan untuk menampilkan kolom duration_in_traffic dalam respons Distance Matrix.

URL

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

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'

JSON

{
  "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",
}

XML


 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 akan 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 mana pun yang cenderung dilalui titik jalan menggunakan awalan side_of_road:. Misalnya, permintaan ini akan menampilkan jarak untuk rute panjang sehingga kendaraan berakhir di sisi jalan yang menjadi bias titik jalan:

URL

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

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:

URL

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

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 belum ditetapkan (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 dalam arah tertentu. Heading 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, berlanjut searah jarum jam. Misalnya, dalam permintaan ini, rute yang dihitung mengarah ke timur dari tempat asal, lalu berputar balik:

URL

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

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 belum ditetapkan (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 matriks jarak

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.

URL

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

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:

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

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

JSON

{
  "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",
}

XML


 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

Kolom Wajib Jenis Deskripsi
required Array<string>

Array alamat seperti yang ditampilkan oleh API dari permintaan awal Anda. Seperti halnya origin_addresses, ini dilokalkan jika sesuai. Konten ini ditujukan untuk dibaca apa adanya. Jangan mengurai alamat berformat secara terprogram.

required Array<string>

Array alamat seperti yang ditampilkan oleh API dari permintaan awal Anda. Alamat ini diformat oleh geocoder dan dilokalkan sesuai dengan parameter bahasa yang diteruskan bersama permintaan. Konten ini ditujukan untuk dibaca apa adanya. Jangan mengurai alamat berformat secara terprogram.

required Array<DistanceMatrixRow>

Array elemen, yang masing-masing berisi elemen status, duration, dan distance.

Lihat DistanceMatrixRow untuk mengetahui informasi selengkapnya.

required DistanceMatrixStatus

Berisi status permintaan, dan mungkin berisi informasi proses debug untuk membantu Anda melacak penyebab kegagalan permintaan.

Lihat DistanceMatrixStatus untuk mengetahui informasi selengkapnya.

opsional string

String yang berisi teks yang dapat dibaca manusia dari error apa pun yang terjadi saat permintaan sedang diproses.

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 tempat 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

Kolom Wajib Jenis Deskripsi
required Array<DistanceMatrixElement>

Saat menampilkan hasil, Distance Matrix API menempatkannya dalam array baris JSON. Meskipun tidak ada hasil yang ditampilkan (seperti saat tempat asal dan/atau tujuan tidak ada), array kosong tetap ditampilkan.

Baris diurutkan sesuai dengan nilai dalam parameter origin permintaan. Setiap baris berkaitan dengan suatu tempat asal, dan setiap elemen dalam baris tersebut berkaitan dengan pasangan tempat asal dengan nilai tujuan.

Setiap array baris berisi satu atau beberapa entri elemen, yang pada gilirannya berisi informasi tentang satu pasangan tempat asal-tujuan.

Lihat DistanceMatrixElement untuk mengetahui informasi selengkapnya.

DistanceMatrixElement

Kolom Wajib Jenis Deskripsi
required DistanceMatrixElementStatus

Status untuk elemen.

Lihat DistanceMatrixElementStatus untuk mengetahui informasi selengkapnya.

opsional TextValueObject

Jarak total rute ini, yang dinyatakan dalam meter (value) dan sebagai teks. Nilai tekstual menggunakan sistem satuan yang ditentukan dengan parameter unit permintaan asli, atau wilayah asal.

Lihat TextValueObject untuk mengetahui informasi selengkapnya.

opsional TextValueObject

Durasi waktu yang diperlukan untuk menempuh rute ini, yang dinyatakan dalam detik (kolom value) dan sebagai teks. Representasi tekstual dilokalkan sesuai dengan parameter bahasa kueri.

Lihat TextValueObject untuk mengetahui informasi selengkapnya.

opsional TextValueObject

Durasi waktu yang diperlukan untuk menempuh rute ini, berdasarkan kondisi lalu lintas saat ini dan historis. Lihat parameter permintaan traffic_model untuk mengetahui opsi yang dapat Anda gunakan untuk meminta agar nilai yang ditampilkan bersifat optimis, pesimis, atau perkiraan terbaik. Durasi dinyatakan dalam detik (kolom value) dan sebagai teks. Representasi tekstual dilokalkan sesuai dengan parameter bahasa kueri. Durasi dalam lalu lintas hanya ditampilkan jika semua hal berikut benar:

  • Permintaan menyertakan parameter departure_time.
  • Kondisi lalu lintas tersedia untuk rute yang diminta.
  • Parameter mode ditetapkan ke driving.

Lihat TextValueObject untuk mengetahui informasi selengkapnya.

opsional Fare

Jika ada, berisi total tarif (yaitu, total biaya tiket) pada rute ini. Properti ini hanya ditampilkan untuk permintaan transportasi umum dan hanya untuk penyedia transportasi umum yang memiliki informasi tarif.

Lihat Tarif untuk mengetahui informasi selengkapnya.

Fare

Total tarif untuk rute.

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}
Kolom Wajib Jenis Deskripsi
required string

Kode mata uang ISO 4217 yang menunjukkan mata uang yang digunakan dalam menyatakan jumlahnya.

text

required string

Jumlah total tarif, diformat dalam bahasa yang diminta.
required angka

Jumlah total tarif, dalam mata uang yang ditentukan.

DistanceMatrixElementStatus

  • OK menunjukkan bahwa respons berisi hasil yang valid.
  • NOT_FOUND menunjukkan bahwa tempat asal dan/atau tujuan dari pasangan ini tidak mendukung geocoding.
  • 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.

Kolom Wajib Jenis Deskripsi

text

required string

Nilai string.
required angka

Nilai numerik.