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 Hasil:  Promise<DistanceMatrixResponse>
Mengirim permintaan matriks jarak.

Antarmuka DistanceMatrixRequest

Antarmuka google.maps.DistanceMatrixRequest

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, akan menginstruksikan layanan Distance Matrix untuk menghindari feri jika memungkinkan. Opsional.
avoidHighways optional
Jenis:  boolean optional
Jika true, akan menginstruksikan layanan Distance Matrix untuk menghindari jalan raya jika memungkinkan. Opsional.
avoidTolls optional
Jenis:  boolean optional
Jika true, akan menginstruksikan layanan Distance Matrix untuk menghindari jalan tol jika memungkinkan. Opsional.
drivingOptions optional
Jenis:  DrivingOptions optional
Setelan yang hanya berlaku untuk permintaan dengan travelMode adalah DRIVING. Objek ini tidak akan berpengaruh pada mode perjalanan lainnya.
language optional
Jenis:  string optional
ID bahasa untuk bahasa yang akan 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 dengan travelMode adalah TRANSIT. Objek ini tidak akan berpengaruh pada mode perjalanan lainnya.
unitSystem optional
Jenis:  UnitSystem optional
Sistem satuan pilihan yang akan digunakan saat menampilkan jarak. Opsional; defaultnya adalah metrik.

Antarmuka DistanceMatrixResponse

Antarmuka google.maps.DistanceMatrixResponse

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 origin yang diformat.
rows
Baris matriks, yang sesuai dengan alamat asal.

Antarmuka DistanceMatrixResponseRow

Antarmuka google.maps.DistanceMatrixResponseRow

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

Antarmuka DistanceMatrixResponseElement

Antarmuka google.maps.DistanceMatrixResponseElement

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 jaraknya 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
Tarif total untuk pasangan asal-tujuan ini. Hanya berlaku untuk permintaan transportasi umum.
status
Status pasangan asal-tujuan tertentu ini.

Konstanta DistanceMatrixStatus

Konstanta google.maps.DistanceMatrixStatus

Status tingkat atas tentang permintaan secara umum yang ditampilkan oleh DistanceMatrixService setelah permintaan matriks jarak selesai. Tentukan ini berdasarkan nilai, atau dengan 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 telah 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 error server. Permintaan mungkin berhasil jika Anda mencoba lagi.

Konstanta DistanceMatrixElementStatus

Konstanta google.maps.DistanceMatrixElementStatus

Status tingkat elemen tentang pasangan asal-tujuan tertentu yang ditampilkan oleh DistanceMatrixService setelah permintaan matriks jarak selesai. 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 dapat di-geocoding.
OK Respons berisi hasil yang valid.
ZERO_RESULTS Tidak ada rute yang dapat ditemukan antara tempat asal dan tujuan.