Distance Matrix

Class DistanceMatrixService

Class google.maps.DistanceMatrixService

Layanan untuk menghitung jarak antara beberapa tempat asal dan tujuan.

Akses dengan memanggil const {DistanceMatrixService} = await google.maps.importLibrary("routes").
Lihat Library di Maps JavaScript API.
DistanceMatrixService
DistanceMatrixService()
Parameter:  Tidak ada
Membuat instance DistanceMatrixService baru yang mengirim kueri matriks jarak ke server Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parameter: 
Nilai yang Ditampilkan:  Promise<DistanceMatrixResponse>
Mengirimkan permintaan matriks jarak.

Antarmuka DistanceMatrixRequest

google.maps.DistanceMatrixRequest interface

Kueri matriks jarak yang dikirim oleh DistanceMatrixService yang berisi array lokasi asal dan tujuan, serta berbagai opsi untuk menghitung metrik.
destinations
Jenis:  Array<string|LatLng|LatLngLiteral|Place>
Array yang berisi string alamat tujuan, atau objek LatLng, atau Place, untuk menghitung jarak dan waktu. Wajib.
origins
Jenis:  Array<string|LatLng|LatLngLiteral|Place>
Array yang berisi string alamat asal, atau objek LatLng, atau Place, yang akan digunakan untuk menghitung jarak dan waktu. Wajib.
travelMode
Jenis:  TravelMode
Jenis perutean yang diminta. Wajib.
avoidFerries optional
Jenis:  boolean optional
Jika true, menginstruksikan layanan Distance Matrix untuk menghindari kapal feri jika memungkinkan. Opsional.
avoidHighways optional
Jenis:  boolean optional
Jika true, menginstruksikan layanan Distance Matrix untuk menghindari jalan raya jika memungkinkan. Opsional.
avoidTolls optional
Jenis:  boolean optional
Jika true, menginstruksikan layanan Distance Matrix untuk menghindari jalan tol jika memungkinkan. Opsional.
drivingOptions optional
Jenis:  DrivingOptions optional
Setelan yang hanya berlaku untuk permintaan saat travelMode adalah DRIVING. Objek ini tidak akan berpengaruh untuk mode perjalanan lainnya.
language optional
Jenis:  string optional
ID bahasa untuk bahasa yang digunakan untuk menampilkan hasil, jika memungkinkan. Lihat daftar bahasa yang didukung.
region optional
Jenis:  string optional
Kode wilayah yang digunakan sebagai bias untuk permintaan geocoding. Kode wilayah menerima nilai dua karakter ccTLD ("domain level teratas"). Umumnya 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").
transitOptions optional
Jenis:  TransitOptions optional
Setelan yang hanya berlaku untuk permintaan saat travelMode adalah TRANSIT. Objek ini tidak akan berpengaruh untuk mode perjalanan lainnya.
unitSystem optional
Jenis:  UnitSystem optional
Sistem satuan pilihan yang akan digunakan saat menampilkan jarak. Opsional; default ke metrik.

Antarmuka DistanceMatrixResponse

google.maps.DistanceMatrixResponse interface

Respons terhadap permintaan DistanceMatrixService, yang terdiri dari alamat asal dan tujuan yang diformat, serta urutan DistanceMatrixResponseRow, satu untuk setiap alamat asal yang sesuai.
destinationAddresses
Jenis:  Array<string>
Alamat tujuan yang diformat.
originAddresses
Jenis:  Array<string>
Alamat asal yang diformat.
rows
Baris matriks, yang sesuai dengan alamat asal.

Antarmuka DistanceMatrixResponseRow

google.maps.DistanceMatrixResponseRow interface

Baris respons terhadap permintaan DistanceMatrixService, yang terdiri dari urutan DistanceMatrixResponseElement, satu untuk setiap alamat tujuan yang sesuai.
elements
Elemen baris, sesuai dengan alamat tujuan.

Antarmuka DistanceMatrixResponseElement

google.maps.DistanceMatrixResponseElement interface

Satu elemen respons terhadap permintaan DistanceMatrixService, yang berisi durasi dan jarak dari satu asal ke satu tujuan.
distance
Jenis:  Distance
Jarak untuk pasangan asal-tujuan ini. Properti ini mungkin tidak ditentukan karena jarak mungkin tidak diketahui.
duration
Jenis:  Duration
Durasi untuk pasangan asal-tujuan ini. Properti ini mungkin tidak ditentukan karena durasinya mungkin tidak diketahui.
duration_in_traffic
Jenis:  Duration
Durasi untuk pasangan asal-tujuan ini, dengan mempertimbangkan kondisi lalu lintas yang ditunjukkan oleh properti trafficModel. Properti ini mungkin undefined karena durasinya mungkin tidak diketahui. Hanya tersedia untuk pelanggan Paket Premium jika drivingOptions ditentukan saat membuat permintaan.
fare
Jenis:  TransitFare
Total tarif untuk pasangan asal-tujuan ini. Hanya berlaku untuk permintaan transportasi umum.
status
Status pasangan asal-tujuan tertentu ini.

Konstanta DistanceMatrixStatus

google.maps.DistanceMatrixStatus konstanta

Status tingkat atas tentang permintaan secara umum yang ditampilkan oleh DistanceMatrixService setelah penyelesaian permintaan matriks jarak. Tentukan ini berdasarkan nilai, atau menggunakan nama konstanta. Misalnya, 'OK' atau google.maps.DistanceMatrixStatus.OK.

Akses dengan memanggil const {DistanceMatrixStatus} = await google.maps.importLibrary("routes").
Lihat Library di Maps JavaScript API.
INVALID_REQUEST Permintaan yang diberikan tidak valid.
MAX_DIMENSIONS_EXCEEDED Permintaan berisi lebih dari 25 asal, atau lebih dari 25 tujuan.
MAX_ELEMENTS_EXCEEDED Hasil dari tempat asal dan tujuan melampaui batas per kueri.
OK Respons berisi hasil yang valid.
OVER_QUERY_LIMIT Terlalu banyak elemen yang diminta dalam jangka waktu yang diizinkan. Permintaan akan berhasil jika Anda mencoba lagi setelah beberapa saat.
REQUEST_DENIED Layanan menolak penggunaan layanan Distance Matrix oleh halaman web Anda.
UNKNOWN_ERROR Permintaan Distance Matrix tidak dapat diproses karena terjadi error server. Permintaan mungkin berhasil jika Anda mencoba lagi.

Konstanta DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus konstanta

Status tingkat elemen tentang pasangan asal-tujuan tertentu yang ditampilkan oleh DistanceMatrixService setelah penyelesaian permintaan matriks jarak. Nilai ini ditentukan sebagai string, misalnya, 'OK'.

Akses dengan memanggil const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes").
Lihat Library di Maps JavaScript API.
NOT_FOUND Tempat asal dan/atau tujuan dari pasangan ini tidak mendukung geocoding.
OK Respons berisi hasil yang valid.
ZERO_RESULTS Tidak ada rute yang dapat ditemukan antara tempat asal dan tujuan.